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

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

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

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

قبل البدء

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

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

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

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

يمكنك العثور على تفاصيل التنفيذ في مرجع الثوابت Swift الهدف-ج:

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

    يمكن استخدام المعلمات المخصصة في الجمهور التعريفات التي يمكن تطبيقها على كل تقرير. يتم تضمين المعلمات المخصصة أيضًا في البيانات تصديره إلى 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، اختَر المنتج >. المخطط > تعديل المخطّط...
  2. اختَر تشغيل من القائمة اليمنى.
  3. اختَر علامة التبويب الوسيطات.
  4. في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضف -FIRAnalyticsVerboseLoggingEnabled

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

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

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

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