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

اختيار المنصة: iOS+ Android Web Flutter Unity C++


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

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

قبل البدء

تأكَّد من إعداد مشروعك ومن إمكانية الوصول إلى "إحصاءات Google" كما هو موضّح في مقالة البدء في استخدام "إحصاءات Google".

أحداث السجلّ

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

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

يمكنك الاطّلاع على تفاصيل التنفيذ لعدة أحداث ومَعلماتها في الـ مرجع أحداث gtag.js.

يوضّح المثال التالي كيفية تسجيل حدث select_content:

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});

Web

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

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

  • المَعلمات المخصّصة: يمكن استخدام المَعلمات المخصّصة كـ سمات أو مقاييس في تقارير Analytics. يمكنك استخدام السمات المخصصة لبيانات مَعلمات الأحداث غير الرقمية والمقاييس المخصصة لأي بيانات مَعلمات يتم تمثيلها بشكل أفضل رقميًا. بعد تسجيل مَعلمة مخصّصة باستخدام حزمة تطوير البرامج (SDK)، سجِّل السمة أو المقياس لضمان ظهور هذه المَعلمات المخصّصة في تقارير "إحصاءات Google". لإجراء ذلك، انتقِل في وحدة تحكّم Firebase إلى إحصاءات Google > التعريفات المخصّصة.

    يمكن استخدام المَعلمات المخصّصة في تعريفات الجمهور التي يمكن تطبيقها على كل تقرير. يتم أيضًا تضمين المَعلمات المخصّصة في البيانات المُصدَّرة إلى BigQuery إذا كان تطبيقك مرتبطًا بمشروع BigQuery. يمكنك العثور على نماذج طلبات بحث وغير ذلك الكثير في BigQuery Export في "إحصاءات Google‏ 4".

  • المَعلمة value: ‏value هي مَعلمة للأغراض العامة مفيدة لتجميع مقياس رئيسي مرتبط بحدث معيّن. تشمل الأمثلة الإيرادات والمسافة والوقت والنقاط.

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

Web

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

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

Web

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

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

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

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

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

  • يتم تعديل لوحة البيانات بشكلٍ دوري على مدار اليوم. لإجراء اختبار فوري، استخدِم DebugView.