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

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

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

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

قبل البدء

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

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

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

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

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

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

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