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

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

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

تسجِّل "إحصاءات 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" التقارير. يمكن القيام بذلك عن طريق: Analytics > الأحداث > إدارة التعريفات المخصّصة > إنشاء سمات مخصّصة

    يمكن استخدام المعلمات المخصصة في الجمهور التعريفات التي يمكن تطبيقها على كل تقرير. يتم تضمين المعلمات المخصصة أيضًا في البيانات تصديره إلى 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. تعرض لوحة البيانات هذه تقارير الأحداث. التي يتم إنشاؤها تلقائيًا لكل نوع مختلف من الأحداث التي يسجلها تطبيقك.