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

اختيار المنصة:

iOS+ Android Web Flutter Unity C++

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

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

قبل البدء

قبل أن تتمكّن من استخدام Google Analytics، عليك إجراء ما يلي:

• سجِّل مشروع Unity الخاص بك وأعدَّه لاستخدام Firebase.

  • إذا كان مشروع Unity يستخدم Firebase حاليًا، يكون قد تم تسجيله وإعداده لاستخدام Firebase.

  • إذا لم يكن لديك مشروع Unity، يمكنك تنزيل نموذج تطبيق.

• أضِف Firebase Unity SDK (تحديدًا FirebaseAnalytics.unitypackage) إلى مشروع Unity الخاص بك.

تجدر الإشارة إلى أنّ إضافة Firebase إلى مشروع Unity يتضمّن مهامًا في كلّ من Firebase وحدة التحكّم ومشروع Unity المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثمّ نقل ها إلى مشروع Unity).

أحداث السجلّ

بعد تهيئة الوحدة Firebase.Analytics.FirebaseAnalytics، يمكنك استخدامها لتسجيل الأحداث باستخدام الطريقة LogEvent()‎.

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

يمكنك العثور على تفاصيل التنفيذ للأحداث المقترَحة في المواقع التالية:

• الأحداث المقترَحة: اطّلِع على قائمة Event ثوابت.
• المعلَمات المحدّدة: اطّلِع على قائمة Parameters ثوابت.

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

• المعلَمات المخصّصة: لا تظهر المعلَمات المخصّصة مباشرةً في Analytics تقارير، ولكن يمكن استخدامها كفلاتر في الجمهور تعريفات التي يمكن تطبيقها على كلّ تقرير. يتم أيضًا تضمين المعلَمات المخصّصة في البيانات المُصدَّرة إلى BigQuery إذا كان تطبيقك مرتبطًا بمشروع BigQuery.

• المعلَمة VALUE‎: VALUE هي معلَمة للأغراض العامة مفيدة لتجميع مقياس رئيسي ذي صلة بـ حدث Analytics. تشمل الأمثلة الإيرادات والمسافة والوقت والنقاط.

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

عرض الأحداث في سجلّ الإخراج

عرض أحداث "إحصاءات Google" في لوحة البيانات

في وحدة تحكّم Firebase، يمكنك عرض إحصاءات مجمّعة عن أحداثك في لوحة بيانات إحصاءات Google > الأحداث.

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

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

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

مزيد من المعلومات عن لوحة البيانات.