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

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

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

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

للوصول إلى هذه البيانات، يُرجى اتّباع الخطوات التالية:

  1. في وحدة تحكّم Firebase، افتح مشروعك.
  2. اختَر Analytics من القائمة لعرض لوحة بيانات إعداد Analytics التقارير.

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

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

قبل البدء

لاستخدام Google Analytics، عليك إجراء ما يلي:

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

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

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

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

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