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


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

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

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

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

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

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

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

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

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