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

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


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

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

قبل البدء

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

إذا أردت جمع بيانات تحديد المصدر في الحملات، تأكَّد من إضافة إطار عمل AdSupport إلى مشروعك.

أحداث السجلّ

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

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

Google Analytics

يمكنك الاطّلاع على تفاصيل التنفيذ في مرجع الثوابت للغتَين Swift و Objective-C.

يوضّح المثال التالي كيفية تسجيل حدث kFIRSelectContent مقترَح:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

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

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

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

عرض الأحداث في وحدة تصحيح الأخطاء في Xcode

يمكنك تفعيل التسجيل المطوَّل لمراقبة تسجيل الأحداث من خلال حزمة تطوير البرامج (SDK) للمساعدة في التأكّد من تسجيل الأحداث بشكلٍ صحيح. ويشمل ذلك الأحداث المسجَّلة تلقائيًا والأحداث المسجَّلة يدويًا.

يمكنك تفعيل التسجيل المطوَّل على النحو التالي:

  1. في Xcode، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط… (Edit scheme…‎).
  2. انقر على تشغيل (Run) من القائمة اليمنى.
  3. انقر على علامة التبويب الوسيطات (Arguments).
  4. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed On Launch) ، أضِف -FIRAnalyticsVerboseLoggingEnabled.

في المرة التالية التي تشغّل فيها تطبيقك، ستظهر أحداثك في وحدة تصحيح الأخطاء في Xcode، ما يساعدك في التأكّد فورًا من إرسال الأحداث.

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

في وحدة التحكم Firebase، يمكنك الاطّلاع على الإحصاءات المجمّعة حول أحداثك في لوحة بيانات إحصاءات Google > الأحداث.

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

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

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