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

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

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

قبل البدء

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

سجِّل مشروعك على Unity واضبطه لاستخدام Firebase.
- إذا كان مشروعك في Unity يستخدم Firebase حاليًا، يكون تسجيلها وإعدادها لمنصة Firebase
- وإذا لم يكن لديك مشروع Unity، يمكنك تنزيل نموذج تطبيق.
أضِف حزمة تطوير البرامج (SDK) لنظام التشغيل Unity Firebase (خاصةً FirebaseAnalytics.unitypackage) إلى لمشروع Unity الخاص بك.

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

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

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

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

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

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.

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

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

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

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

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