سجل الأحداث

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

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

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

قبل ان تبدأ

تأكد من أنك قمت بإعداد مشروعك ويمكنك الوصول إلى Analytics كما هو موضح في الخطوات الأولى مع Analytics .

سجل الأحداث

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

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

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

يوضح المثال التالي كيفية تسجيل حدث kFIRSelectContent الموصى به:

سويفت

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

ج موضوعية

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

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

  • المعلمات المخصصة: يمكن استخدام المعلمات المخصصة كأبعاد أو مقاييس في تقارير Analytics . يمكنك استخدام الأبعاد المخصصة لبيانات معلمات الأحداث غير الرقمية والمقاييس المخصصة لأي بيانات معلمات يتم تمثيلها رقميًا بشكل أفضل. بعد تسجيل المعلمة المخصصة باستخدام SDK، قم بتسجيل البُعد أو المقياس لضمان ظهور تلك المعلمات المخصصة في تقارير Analytics. قم بذلك عبر: التحليلات > الأحداث > إدارة التعريفات المخصصة > إنشاء أبعاد مخصصة

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

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

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

سويفت

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

ج موضوعية

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

قم بتعيين معلمات الحدث الافتراضية

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

كما هو الحال مع المعلمات المخصصة، قم بتسجيل معلمات الأحداث الافتراضية لضمان ظهور هذه المعلمات المخصصة في تقارير Analytics.

سويفت

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

ج موضوعية

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

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

لمسح المعلمة الافتراضية، قم باستدعاء الأسلوب setDefaultEventParameters مع تعيين المعلمة على nil .

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

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

يمكنك تمكين التسجيل المطول كما يلي:

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

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

عرض الأحداث في لوحة القيادة

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

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