تسجيل الأحداث

توفِّر الأحداث إحصاءات حول ما يحدث في تطبيقك، مثل معلومات المستخدِم. الإجراءات أو أحداث النظام أو الأخطاء.

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

قبل البدء

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

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

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

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

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

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

تسجيل الأحداث

بعد إعداد وحدة Firebase.Analytics.FirebaseAnalytics، يمكنك استخدامها لتسجيل الأحداث من خلال الطريقة LogEvent().

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

يمكنك العثور على تفاصيل تنفيذ الأحداث المقترَحة في ما يلي: المواقع:

• الأحداث المقترَحة: اطّلِع على قائمة ثوابت Event.
• المَعلمات المخصَّصة: اطّلِع على قائمة ثوابت Parameters.

يوضح المثال التالي كيفية تسجيل نتيجة SELECT_CONTENT الحدث:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

بالإضافة إلى المعلمات المخصصة، يمكنك إضافة المعلمات التالية لأي حدث:

• المعلمات المخصصة: لا يتم تمثيل المعلمات المخصصة مباشرةً في في تقارير Analytics، ولكن يمكن استخدامها كفلاتر في تعريفات الجمهور التي يمكن تطبيقها على كل تقرير. مُخَصَّصْ يتم تضمين المَعلمات أيضًا في البيانات التصدير إلى BigQuery في حال تطبيقك مرتبط بمشروع BigQuery.

• VALUE مَعلمة: VALUE هي مَعلمة للأغراض العامة. وهي مفيدة لتجميع مقياس رئيسي يتعلق حدث "إحصاءات Google". وتشمل الأمثلة الأرباح والمسافة والوقت والنقاط.

إذا كان طلبك ينطوي على احتياجات محددة غير مشمولة في أحد الاقتراحات نوع حدث "إحصاءات Google"، يمكنك تسجيل أحداثك المخصّصة في "إحصاءات Google" كما هو موضح في هذا المثال:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

عرض الأحداث في مخرجات السجلّ

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

عرض أحداث الإحصاءات في لوحة البيانات

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

للوصول إلى هذه البيانات في "وحدة تحكُّم Firebase":

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

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