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


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

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

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

قبل البدء

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

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

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

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

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

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

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

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

    يمكن استخدام المعلمات المخصصة في الجمهور التعريفات التي يمكن تطبيقها على كل تقرير. يتم تضمين المعلمات المخصصة أيضًا في البيانات تصديره إلى 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. تعرض لوحة البيانات هذه تقارير الأحداث. التي يتم إنشاؤها تلقائيًا لكل نوع مختلف من الأحداث التي يسجلها تطبيقك.