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

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


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

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

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

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

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

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

قبل البدء

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

  • تسجيل مشروع Unity وإعداده لاستخدام Firebase

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

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

  • إضافة حزمة Firebase Unity SDK (تحديدًا FirebaseAnalytics.unitypackage) إلى مشروع Unity

يُرجى العِلم أنّ إضافة Firebase إلى مشروع Unity تتضمّن مهامًا في كلّ من الـ Firebase console ومشروع 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);

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