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

اختيار المنصة: iOS+ Android Web Flutter Unity C++


Google Analytics تجمع بيانات الاستخدام والسلوك لتطبيقك. تسجِّل حزمة SDK نوعَين أساسيَّين من المعلومات:

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

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

يمكنك الوصول إلى هذه البيانات في إحصاءات Google صفحات في وحدة التحكّم Firebase.

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

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

قبل البدء

قبل أن تتمكّن من استخدام Google Analytics، عليك تنفيذ ما يلي:

  • سجِّل مشروع Unity الخاص بك وأعدَّه لاستخدام Firebase.

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

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

  • أضِف Firebase Unity SDK (تحديدًا 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);

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