سجل الأحداث

يوضح لك هذا الدليل كيفية تسجيل الأحداث في تطبيقك.

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

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

قبل ان تبدأ

تأكد من أنك قمت بإعداد المشروع الخاص بك ويمكن الوصول إلى تحليلات كما هو موضح في الشروع في Analytics .

سجل الأحداث

بعد أن كنت قد تكوين firebase.analytics() المثال، يمكنك أن تبدأ في تسجيل الأحداث مع logEvent() الأسلوب. إذا كنت بالفعل على دراية مع جوجل تحليلات، وهذا الأسلوب هو ما يعادل استخدام event القيادة في gtag.js .

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

ملاحظة: للحصول على أقصى قدر من التفاصيل في التقارير وتسجيل الأحداث واقترح أن يكون له معنى بالنسبة التطبيق والمعلمات التي ينص عليها القانون. يضمن هذا أيضًا الاستفادة من أحدث ميزات Google Analytics بمجرد توفرها.

يمكنك العثور على تفاصيل التنفيذ لعدة أحداث والمعلمات الخاصة بهم في إشارة الحدث gtag.js .

يوضح المثال التالي كيفية الدخول على select_content الحدث:

إصدار الويب 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

إصدار الويب 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

بالإضافة إلى المعلمات المحددة ، يمكنك إضافة المعلمات التالية إلى أي حدث:

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

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

إصدار الويب 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

إصدار الويب 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

عرض الأحداث في لوحة القيادة

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

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