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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك. حزمة SDK لتسجيل نوعين أساسيين من المعلومات وهما:

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

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

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

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

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

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

قبل البدء

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

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

    • إذا كان مشروعك في Unity يستخدم Firebase حاليًا، يكون تسجيلها وإعدادها لمنصة Firebase

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

  • أضِف حزمة تطوير البرامج (SDK) 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);

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