Catch up on highlights from Firebase at Google I/O 2023. Learn more

ابدأ مع Google Analytics for Unity

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:

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

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

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

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

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

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

قبل ان تبدأ

قبل أن تتمكن من استخدام Google Analytics ، تحتاج إلى:

  • سجل مشروع Unity الخاص بك وقم بتكوينه لاستخدام Firebase.

    • إذا كان مشروع Unity الخاص بك يستخدم Firebase بالفعل ، فهذا يعني أنه تم تسجيله بالفعل وتهيئته لـ Firebase.

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

  • أضف Firebase Unity SDK (على وجه التحديد ، FirebaseAnalytics.unitypackage ) إلى مشروع Unity الخاص بك.

لاحظ أن إضافة Firebase إلى مشروع Unity الخاص بك يتضمن مهامًا في كل من وحدة تحكم Firebase وفي مشروع Unity المفتوح (على سبيل المثال ، يمكنك تنزيل ملفات تهيئة Firebase من وحدة التحكم ، ثم نقلها إلى مشروع الوحدة الخاص بك).

سجل الأحداث

يمكنك البدء فورًا في تسجيل الأحداث باستخدام طريقة 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);

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