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

اختيار المنصة:

iOS+ Android Web Flutter Unity C++

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

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

قبل البدء

تأكَّد من إعداد مشروعك ومن إمكانية الوصول إلى Analytics على النحو الموضّح في مقالة البدء في استخدام Analytics.

أحداث السجلّ

بعد إنشاء مثيل FirebaseAnalytics، يمكنك استخدامه لتسجيل الأحداث باستخدام logEvent() طريقة.

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

**ملاحظة:** للحصول على أكبر قدر من التفاصيل في التقارير، سجِّل الأحداث المقترَحة التي تناسب تطبيقك ومَعلماتها المحدّدة. يضمن ذلك أيضًا الاستفادة من أحدث الميزات فور توفّرها.

Google Analytics

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

• الأحداث المقترَحة: اطّلِع على مرجع الفئة com.google.firebase.analytics.FirebaseAnalytics.Event.
• المَعلمات المحدّدة: اطّلِع على com.google.firebase.analytics.FirebaseAnalytics.Param مرجع.

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

Kotlin

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

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

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

  يمكن استخدام المَعلمات المخصّصة في تعريفات الجمهور التي يمكن تطبيقها على كل تقرير. يتم أيضًا تضمين المَعلمات المخصّصة في البيانات التي يتم تصديرها إلى BigQuery إذا كان تطبيقك مرتبطًا بمشروع BigQuery. يمكنك العثور على نماذج لطلبات البحث وغير ذلك الكثير في مقالة BigQuery Export في "إحصاءات Google‏ 4".

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

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

Kotlin

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

ضبط المَعلمات التلقائية للأحداث

يمكنك تسجيل المَعلمات في جميع الأحداث باستخدام setDefaultEventParameters. ترتبط المَعلمات التلقائية بجميع الأحداث المستقبلية التي يتم تسجيلها.

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

Kotlin

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

إذا تم تحديد مَعلمة في الـ logEvent() طريقة، يتم استخدام هذه القيمة بدلاً من القيمة التلقائية.

لمحو مَعلمة تلقائية، استدعِ الـ setDefaultEventParameters طريقة مع ضبط المَعلمة على null.

عرض الأحداث في سجلّ تصحيح الأخطاء في استوديو Android

يمكنك تفعيل التسجيل المفصّل لمراقبة تسجيل الأحداث بواسطة حزمة تطوير البرامج (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

يعرض هذا الأمر أحداثك في أداة Logcat في استوديو Android، ما يساعدك في التحقّق على الفور من إرسال الأحداث.

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

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

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