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

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

تسجّل 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().

لمساعدتك في البدء، تحدّد حزمة تطوير البرامج (SDK) الخاصة بـ Analytics عددًا من الأحداث المقترَحة الشائعة بين أنواع مختلفة من التطبيقات، بما في ذلك تطبيقات البيع بالتجزئة والتجارة الإلكترونية والسفر والألعاب. لمزيد من المعلومات عن هذه الأحداث وحالات استخدامها، راجِع مقالات الأحداث المقترَحة في "مركز مساعدة إحصاءات 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: هي مَعلمة عامة الأغراض ومفيدة لتجميع مقياس رئيسي ذي صلة Analytics بحدث.VALUE وتشمل الأمثلة الأرباح والمسافة والوقت والنقاط.

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

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

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

Android

يمكنك تفعيل التسجيل المفصّل للأحداث في "سجلّ تصحيح الأخطاء" في Android Studio للمساعدة في التأكّد من أنّ حزمة 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" في لوحة البيانات

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

للوصول إلى هذه البيانات في وحدة تحكّم Firebase، اتّبِع الخطوات التالية:

  1. في وحدة تحكّم Firebase، افتح مشروعك.
  2. انقر على Analytics من القائمة لعرض لوحة بيانات إعداد التقارير Analytics.

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