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


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

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

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

قبل البدء

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

أحداث السجلّ

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

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

ملاحظة: للحصول على أكبر قدر من التفاصيل في التقارير، سجِّل الأحداث المقترَحة التي تتناسب مع تطبيقك ومعلَماتها المحدَّدة. ويضمن ذلك أيضًا استفادتك من أحدث ميزات "إحصاءات 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". يمكنك إجراء ذلك من خلال: إحصاءات 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 وحدة التحكّم. يتم تعديل لوحات البيانات هذه بشكل دوري على مدار اليوم. لإجراء اختبار فوري، استخدِم ناتج logcat كما هو موضّح في القسم السابق.

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