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

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

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

قبل البدء

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

• سجِّل مشروعك على Unity واضبطه لاستخدام Firebase.

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

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

• أضِف حزمة تطوير برامج Unity من Firebase (خصوصًا FirebaseAnalytics.unitypackage) إلى مشروع Unity.

يمكنك العثور على تعليمات تفصيلية حول مهام الإعداد الأولية هذه في إضافة Firebase إلى مشروع Unity.

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

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

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

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

ملاحظة: للحصول على أقصى قدر من التفاصيل في التقارير، عليك تسجيل أحداث "إحصاءات Google" المقترَحة لتطبيقك والمَعلمات المخصَّصة لها. يضمن لك ذلك أيضًا الاستفادة من أحدث ميزات "إحصاءات 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)
);

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

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

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

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

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

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

Android

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

يمكنك تفعيل التسجيل المطوَّل باستخدام سلسلة من أوامر أداة adb:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

يعرض هذا الأمر الأحداث في سجلّ Logcat في "استوديو Android"، ما يساعدك على التحقّق فورًا من أنّه يتم إرسال الأحداث.

iOS+

يتم تسجيل الأحداث بوحدة التحكم، ويمكن عرضها أثناء تشغيل التطبيق من خلال XCode.

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

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

للوصول إلى هذه البيانات في "وحدة تحكُّم Firebase":

1. افتح مشروعك في وحدة تحكُّم Firebase.
2. اختَر إحصاءات Google من القائمة لعرض لوحة بيانات إعداد التقارير في "إحصاءات Google".

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