أحداث السجلّ

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

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

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

قبل البدء

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

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

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

لمساعدتك في البدء، تحدِّد حزمة تطوير البرامج لخدمة "إحصاءات 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'
});
analytics_log_event_params.js

Web

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

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

  • المَعلمات المخصَّصة: يمكن استخدام المَعلمات المخصَّصة كسمات أو مقاييس في تقارير "إحصاءات Google". يمكنك استخدام السمات المخصّصة لبيانات مَعلمات الأحداث غير الرقمية والمقاييس المخصّصة لأي بيانات مَعلمات يتم تمثيلها رقميًا بشكل أفضل. بعد تسجيل مَعلمة مخصّصة باستخدام حزمة تطوير البرامج (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'});
analytics_log_event_custom_params.js

Web

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

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

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

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