ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

سجل الأحداث

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

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

قبل ان تبدأ

قبل أن تتمكن من استخدام Google Analytics ، تحتاج إلى:

  • سجل مشروع الوحدة الخاص بك وقم بتكوينه لاستخدام Firebase.

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

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

  • أضف حزمة Firebase Unity SDK (على وجه التحديد ، FirebaseAnalytics.unitypackage ) إلى مشروع الوحدة لديك.

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

سجل الأحداث

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

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

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

  • الأحداث المقترحة: انظر قائمة ثوابت 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 Parameter: VALUE هي معلمة غرض عام مفيدة لتجميع مقياس رئيسي يتعلق بحدث Analytics. تشمل الأمثلة الإيرادات والمسافة والوقت والنقاط.

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

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

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

ذكري المظهر

يمكنك تمكين التسجيل المطول في Android Studio Debug Log للمساعدة في التحقق من تسجيل الأحداث بشكل صحيح بواسطة 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

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

iOS

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

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

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

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

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

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