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

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

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

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

قبل البدء

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

أحداث السجلّ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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