أحداث السجلّ

يوضِّح لك هذا الدليل كيفية تسجيل الأحداث في تطبيقك.

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

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

قبل البدء

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

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

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

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

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

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

Kotlin+KTX 

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

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

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

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

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

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

Kotlin+KTX 

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+KTX 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.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. تعرض لوحة البيانات هذه تقارير الأحداث التي يتم إنشاؤها تلقائيًا لكل نوع مختلف من الأحداث التي يسجلها تطبيقك.