أحداث السجلّ

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

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

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

قبل البدء

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

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

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

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

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

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

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])PatternTabBarController.swift

Objective-C

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

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

يمكنك تسجيل المَعلمات في جميع الأحداث باستخدام 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) للمساعدة في التحقّق من تسجيل الأحداث بشكل صحيح. ويشمل ذلك الأحداث التي يتم تسجيلها تلقائيًا ويدويًا

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

في Xcode، اختَر المنتج > المخطط > تعديل المخطط...
اختَر تشغيل من القائمة اليمنى.
اختَر علامة التبويب الوسيطات.
في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضف -FIRAnalyticsVerboseLoggingEnabled.

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

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

يمكنك عرض إحصاءات مجمَّعة عن أحداثك في لوحات بيانات وحدة تحكُّم Firebase. يتم تحديث لوحات المعلومات هذه بشكل دوري على مدار اليوم. لإجراء اختبار فوري، استخدم ناتج Logcat كما هو موضح في القسم السابق.

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