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


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

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

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

قبل البدء

تأكَّد من إعداد مشروعك وإمكانية الوصول إلى Analytics كما هو описан في مقالة البدء باستخدام Analytics.

أحداث السجلّ

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

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

يمكنك العثور على تفاصيل التنفيذ في مرجع الثوابت لكل من 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

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

  • المَعلمات المخصّصة: يمكن استخدام المَعلمات المخصّصة كسمات أو مقاييس في تقارير Analytics. يمكنك استخدام السمات المخصّصة لبيانات مَعلمات الأحداث غير الرقمية، والمقاييس المخصّصة لأي بيانات مَعلمة يتم تمثيلها بشكل أفضل رقميًا. بعد تسجيل مَعلمة مخصّصة باستخدام حزمة تطوير البرامج (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) للمساعدة في verifying that events are being logged properly. ويشمل ذلك كلاً من الأحداث المسجّلة تلقائيًا والأحداث المسجّلة يدويًا.

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

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

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

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

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

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