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

اختيار المنصة:

iOS+ Android الويب Flutter Unity C++‎

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

قبل البدء

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

إذا أردت جمع بيانات تحديد المصدر في الحملات لتطبيقات منصة Apple، احرص على إضافة إطار عمل AdSupport إلى مشروعك.

أحداث السجلّ

بعد إنشاء مثيل 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() مع ضبط المَعلمة على null.