Check out what’s new from Firebase at Google I/O 2022. Learn more

أحداث السجل

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

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

قبل ان تبدأ

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

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

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

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

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

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

سجل الأحداث

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

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

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

  • الأحداث المقترحة: راجع قائمة ثوابت 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 هي معلمة للأغراض العامة مفيدة لتجميع مقياس رئيسي يتعلق بحدث Analytics. تشمل الأمثلة الإيرادات والمسافة والوقت والنقاط.

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

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

عرض الأحداث في إخراج السجل

ذكري المظهر

يمكنك تمكين التسجيل المطول في Android Studio Debug Log ، للمساعدة في التحقق من تسجيل الأحداث بشكل صحيح بواسطة SDK. يتضمن هذا كلاً من الأحداث التي تم تسجيلها تلقائيًا ويدويًا.

يمكنك تمكين التسجيل المطول بسلسلة من أوامر adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

يعرض هذا الأمر الأحداث الخاصة بك في Android Studio logcat ، مما يساعدك على التحقق فورًا من إرسال الأحداث.

iOS +

يتم تسجيل الأحداث في وحدة التحكم ، ويمكن عرضها أثناء تشغيل التطبيق من خلال XCode.

عرض أحداث التحليلات في لوحة القيادة

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

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

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

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