يتمّ بدء الأحداث المجمّعة تلقائيًا عن طريق تفاعلات رئيسية مع تطبيقك.
إذا كنت تستخدِم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، ليس عليك كتابة أيّ رمز إضافي لجمع هذه الأحداث. على الرغم من أن بعض هذه الأحداث قد لا يكون متاحًا في تقارير AdMob، ستكون هذه الأحداث متاحة بعد الربط بمنصة Firebase.
للاطّلاع على تقارير الأحداث في Firebase، انقر على علامة التبويب الأحداث في لوحة بيانات "إحصاءات Google" في وحدة تحكُّم Firebase.
يسرد الجدول التالي الأحداث المجمّعة والعوامل المُشغِّلة لها ومَعلماتها.
| اسم الحدث | يتم بدؤه تلقائيًا عندما | المعلمات |
|---|---|---|
| ad_click | ينقر مستخدِم على إعلان |
ad_event_id |
| ad_exposure | يظهر إعلان واحد على الأقل من الإعلانات المعروضة من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" على الشاشة | firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
| ad_impression | يشاهد مستخدِم مرّة ظهور للإعلان |
ad_event_id |
| ad_query | يتم تقديم طلب إعلان من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" | ad_event_id |
| ad_reward | يتم منح مكافأة بواسطة إعلان يضم مكافأة يُعرض من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" | ad_unit_id, reward_type, reward_value |
| adunit_exposure | تظهر وحدة إعلانية معروضة من خلال حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" على الشاشة | firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
| app_clear_data | يعيد المستخدِم ضبط بيانات التطبيق أو يمحوها، ما يؤدي إلى إزالة كل الإعدادات وبيانات تسجيل الدخول | |
| app_exception | يتعطّل التطبيق أو يعرِض استثناءً | fatal, timestamp |
| app_remove |
تتمّ إزالة حزمة تطبيق أو يتمّ "إلغاء تثبيتها" من جهاز Android ملاحظة: Android فقط يحسِب الحدث app_remove عمليات إزالة حزم التطبيق بغض النظر عن مصدر التثبيت، ويتغير العدد استنادًا إلى النطاق الزمني الذي تستخدِمه للتقرير. يحسِب مقياسَا عمليات الإزالة اليومية بحسب الجهاز وعمليات الإزالة اليومية بحسب المستخدِم عمليات إزالة حزم التطبيق فقط عندما يتم تثبيتها من Google Play، ويتم تسجيلها على أساس يومي. |
|
| app_update |
يتم تحديث التطبيق إلى إصدار جديد وتشغيله مجددًا ويتمّ تمرير رقم تعريف إصدار التطبيق السابق كمعلَمة. يختلف هذا الحدث من حيث مفهومه عن مقياس عمليات الترقية اليومية حسب الجهاز، ويتمّ الإبلاغ عن المقياس بواسطة Google Play Developer Console. تشير الترقية إلى تحديث البرنامج الثنائي للتطبيق، حيث يتمّ بدء حدث app_update في المرّة التالية التي يتمّ فيها تشغيل التطبيق الذي تمّت ترقيته. |
previous_app_version |
| first_open |
يفتح المستخدِم التطبيق للمرة الأولى بعد تثبيته أو إعادة تثبيته لمراجعة أعداد عمليات التنزيل الأوّلية، انتقِل إلى Google Play Console أو iTunesConnect. |
previous_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause |
| in_app_purchase |
يكمل المستخدِم عملية شراء داخل التطبيق، بما في ذلك الاشتراك الأوّلي، تتمّ معالجتها من خلال App Store على iTunes أو من خلال Google Play ويتمّ تمرير معرِّف المنتج، واسم المنتج، والعملة، والكمية كمعلَمات. بالنسبة إلى أحداث in_app_purchase لنظام التشغيل Android، اربط تطبيقك ببرنامج Firebase واربط تطبيقك ببرنامج Play. ملاحظة: لا يتمّ تتبُّع أرباح شراء التطبيقات المدفوعة وعمليات ردّ الأموال (لنظام التشغيل iOS فقط) تلقائيًا. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
| os_update |
يتم تحديث نظام تشغيل الجهاز إلى إصدار جديد يتمّ تمرير رقم تعريف إصدار نظام التشغيل السابق كمعلَمة. |
previous_os_version |
| screen_view | يتم الانتقال من شاشة إلى أخرى واستيفاء أيّ من المعايير التالية:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id |
| session_start | يتفاعل مستخدِم مع التطبيق لمدة تتجاوز الحدّ الأدنى لمدة الجلسة، وذلك بعد التوقّف عن النشاط لفترة تتجاوز مدة مهلة الجلسة | |
| user_engagement | دوريًا، أثناء عمل التطبيق في المقدِّمة. | engagement_time_msec |