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


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

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

قبل البدء

تأكَّد من أنّك قد أعددت مشروعك وأنّه يمكنك الوصول إلى "إحصاءات Google" على النحو описан في البدء في استخدام "إحصاءات Google".

أحداث السجلّ

بعد إنشاء مثيل FirebaseAnalytics، يمكنك استخدامه لتسجيل الأحداث باستخدام طرق log في المكتبة.

الأحداث المحدّدة مسبقًا

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

يمكنك العثور على طرق التسجيل لأنواع الأحداث المقترَحة في مرجع واجهة برمجة التطبيقات.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

بدلاً من ذلك، يمكنك تسجيل الحدث نفسه باستخدام logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

يمكن أن يكون ذلك مفيدًا إذا كنت تريد تحديد مَعلمات إضافية غير المَعلمات المُحدَّدة (المطلوبة). يمكنك إضافة المَعلمات التالية إلى أيّ حدث:

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

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

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

  • يمكن أن تتألّف أسماء المَعلمات من 40 حرفًا كحدّ أقصى، ويجب أن تبدأ بحرف أبجدي، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط. يمكن استخدام نوعَي السلسلة والقيمة الرقمية. يمكن أن يصل طول قيم مَعلمات السلسلة إلى 100 حرف. البادئات "firebase" و"google" و"ga_" محجوزة ولا يجب استخدامها لأسماء المَعلمات.

الأحداث المخصّصة

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

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

ضبط مَعلمات الحدث التلقائية

يمكنك تسجيل المَعلمات على مستوى الأحداث باستخدام setDefaultEventParameters(). ترتبط المَعلمات التلقائية بجميع الأحداث المستقبلية التي يتم تسجيلها.

كما هو الحال مع المَعلمات المخصّصة، سجِّل مَعلمات الأحداث التلقائية لضمان ظهورها في تقارير "إحصاءات Google".

قيم المَعلمات الصالحة هي String وnum. يؤدي ضبط قيمة المفتاح على null إلى محو هذه المَعلمة. يؤدي إدخال قيمة فارغة إلى محو جميع المَعلمات.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

إذا تم تحديد مَعلمة في الطريقة logEvent() أو log- ، يتم استخدام هذه القيمة بدلاً من القيمة التلقائية.

لمحو مَعلمة تلقائية، استخدِم setDefaultEventParameters()metode مع ضبط المَعلمة على null.

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

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

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