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

اختيار المنصة: iOS+ Android Web Flutter Unity C++


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

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

قبل البدء

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

أحداث السجلّ

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

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

Google Analytics

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

يوضّح المثال التالي كيفية تسجيل حدث 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")
}

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);

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

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

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

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

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

Kotlin 

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

Java 

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

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

يمكنك تسجيل المعلَمات في جميع الأحداث باستخدام 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، يمكنك عرض إحصاءات مجمّعة عن أحداثك في لوحة بيانات إحصاءات Google > الأحداث.

يُرجى العِلم بما يلي بشأن لوحة البيانات هذه:

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

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