سجل الأحداث

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

يقوم 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 Analytics.

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

• الأحداث المقترحة: راجع قائمة ثوابت 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);

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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

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

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

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

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

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