بدء استخدام "إحصاءات Google" لبرنامج Unity

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
  • خصائص المستخدِمين: السمات التي تحدّدها لوصف شرائح من قاعدة المستخدمين، مثل تفضيل اللغة أو الموقع الجغرافي.

تسجِّل "إحصاءات Google" تلقائيًا بعض الأحداث وخصائص المستخدمين، ولن تحتاج إلى إضافة أي رمز لتفعيلها. إذا كان تطبيقك يحتاج إلى جمع بيانات إضافية، يمكنك إعداد ما يصل إلى 25 خاصيّة مستخدم مختلفة في "إحصاءات Google" وتسجيل ما يصل إلى 500 نوع مختلف من نوع "إحصاءات Google" في تطبيقك. وليس هناك حدّ أقصى لإجمالي عدد الأحداث في سجلّات تطبيقك.

للوصول إلى هذه البيانات:

  1. افتح مشروعك في وحدة تحكُّم Firebase.
  2. اختَر إحصاءات Google من القائمة لعرض لوحة بيانات إعداد التقارير في "إحصاءات Google".

تعرض علامة التبويب الأحداث تقارير الأحداث التي يتم إنشاؤها تلقائيًا لكل نوع مختلف من أحداث "إحصاءات Google" التي سجّلها تطبيقك. يمكنك الاطّلاع على مزيد من المعلومات عن لوحة البيانات.

لمساعدتك في البدء، تحدِّد حزمة تطوير البرامج لخدمة "إحصاءات Google" عددًا من الأحداث المقترَحة الشائعة بين أنواع التطبيقات المختلفة، بما في ذلك تطبيقات البيع بالتجزئة والتجارة الإلكترونية والسفر والألعاب. لمعرفة المزيد من المعلومات عن هذه الأحداث ووقت استخدامها، يمكنك الاطّلاع على الأحداث المقترَحة. للحصول على أكبر قدر من التفاصيل في التقارير، سجِّل أحداث "إحصاءات Google" المقترَحة المفيدة لتطبيقك والمَعلمات المخصَّصة لها. ويضمن لك ذلك أيضًا الاستفادة من أحدث ميزات "إحصاءات Google" عند توفّرها.

قبل البدء

قبل أن تتمكّن من استخدام إحصاءات Google، عليك إجراء ما يلي:

  • سجِّل مشروعك على Unity واضبطه لاستخدام Firebase.

    • إذا كان مشروعك في Unity يستخدم Firebase في الوقت الحالي، يعني ذلك أنّه تم تسجيله وإعداده من أجل Firebase.

    • إذا لم يكن لديك مشروع على Unity، يمكنك تنزيل نموذج تطبيق.

  • أضِف حزمة تطوير برامج Unity من Firebase (خصوصًا FirebaseAnalytics.unitypackage) إلى مشروع Unity.

تجدر الإشارة إلى أنّ إضافة Firebase إلى مشروع Unity تتضمّن مهام في وحدة تحكُّم Firebase وفي مشروع Unity المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعدادات Firebase من وحدة التحكّم، ثم نقلها إلى مشروع Unity).

تسجيل الأحداث

يمكنك البدء فورًا في تسجيل الأحداث باستخدام الطريقة LogEvent().

المثال التالي يسجّل الأحداث باستخدام أنواع مختلفة من الوسيطات:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

الخطوات التالية