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

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

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

قبل البدء

لاستخدام Google Analytics، عليك إجراء ما يلي:

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

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

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

• أضِف Firebase حزمة تطوير البرامج (SDK) Unity (على وجه التحديد، 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: 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 التي يسجّلها تطبيقك. اطّلِع على مزيد من المعلومات عن لوحة البيانات.