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

اختيار المنصة: iOS+ Android الويب Flutter Unity C++‎


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

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

قبل البدء

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

إذا أردت جمع بيانات تحديد المصدر في الحملات، تأكَّد من إضافة إطار عمل AdSupport إلى مشروعك.

أحداث السجلّ

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

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

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

يوضّح المثال التالي كيفية تسجيل حدث kFIRSelectContent مقترَح:

Swift

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

Objective-C

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

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

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

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

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

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

Swift

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

Objective-C

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

ضبط المَعلمات التلقائية للأحداث

يمكنك تسجيل المَعلمات على مستوى الأحداث باستخدام 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، يمكنك الاطّلاع على إحصاءات مجمّعة حول أحداثك في إحصاءات Google > لوحة بيانات الأحداث.

يُرجى ملاحظة ما يلي بشأن لوحة البيانات هذه:

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

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