تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

سجل الأحداث

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

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

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

قبل ان تبدأ

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

سجل الأحداث

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

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

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

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

سويفت

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

ج موضوعية

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

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

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

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

سويفت

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

ج موضوعية

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

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

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

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

سويفت

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

ج موضوعية

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

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

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

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

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

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

في Xcode ، حدد المنتج> مخطط> تحرير المخطط ...
حدد تشغيل من القائمة اليسرى.
حدد علامة التبويب وسائط .
في قسم Arguments Passed On Launch ، أضف -FIRAnalyticsVerboseLoggingEnabled .

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

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

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

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