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

اختيار المنصة:

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

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

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

قبل البدء

قبل أن تتمكّن من استخدام Google Analytics، عليك تنفيذ ما يلي:

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

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

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

• أضِف حزمة تطوير البرامج (SDK) لـ Firebase 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);

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

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

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

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

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

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

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