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

اختيار النظام الأساسي:

iOS+ Android الويب Flutter Unity C++‎

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

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

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

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

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

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

في وحدة تحكّم Firebase، يمكنك الاطّلاع على إحصاءات مجمّعة حول أحداثك في لوحة بيانات إحصاءات > الأحداث.

يُرجى ملاحظة ما يلي بشأن لوحة البيانات هذه:

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

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

مزيد من المعلومات حول لوحة البيانات