تؤدي تفاعلات أساسية مع تطبيقك و/أو موقعك الإلكتروني (كما هو موضّح تحت اسم الحدث في الجدول أدناه) إلى ظهور الأحداث المجمّعة تلقائيًا. وما دمت تستخدم علامة Google أو حزمة تطوير البرامج (SDK) "إحصاءات Google لبرنامج Firebase"، ليس عليك كتابة أيّ رمز إضافي لجمع هذه الأحداث.
تجمع "إحصاءات Google" الأحداث لتطبيقات Android وiOS، ما لم يُذكَر غير ذلك. يمكن أن تكون أسماء هذه الأحداث ومَعلماتها مفيدة عند الوصول إلى بيانات الأحداث الأوليّة في BigQuery.
للتعرّف على كلّ مَعلمة حدث مُدرَجة أدناه وكيفية تعديل كلّ مَعلمة لسمة أو مقياس في "إحصاءات Google"، اطّلِع على مقالة مَعلمات الأحداث على "إحصاءات Google".
ملاحظة:
في ما يلي عدّة مَعلمات يتم جمعها تلقائيًا مع كلّ حدث، بما في ذلك الأحداث المخصّصة:
- مصدر البيانات من الموقع الإلكتروني:
- اللغة
- page_location
- page_referrer
- page_title
- screen_resolution
- مصدر بيانات التطبيق:
- app_version
- firebase_screen_id
- firebase_screen_class
يجب أن يكون عدد أحرف القيمة المخصَّصة لمَعلمات الأحداث هو 100 حرف أو أقل. ويجب أن يكون عدد أحرف المَعلمة page_title هو 300 حرف أو أقل. ويجب أن يكون عدد أحرف المَعلمة page_referrer 420 حرفًا أو أقلّ. ويجب أن يكون عدد أحرف المَعلمة page_location 1,000 حرف أو أقلّ.
إذا تم إلغاء مَعلمة page_location، تأكَّد من صلاحية مسار عنوان URL. وفي حال تحديد مسار عنوان URL غير صالح، ستكون سمة موقع الصفحة فارغة. يمكنك استخدام أداة إنشاء عناوين URL للحملات للتحقق ممّا إذا كان مسار عنوان URL صالحًا أم لا.
يتم جمع المَعلمتَين firebase_screen_id وfirebase_screen_class تلقائيًا ما لم تُوقف تتبّع مشاهدات الصفحات في التطبيق.
| الحدث | حالات البدء التلقائي... | المَعلمات |
|---|---|---|
|
ad_click (التطبيقات) |
عندما ينقر مستخدِم على إعلان أحداث الناشرِين الواردة من AdMob عبر "SDK لإعلانات Google على الأجهزة الجوّالة" أو "مدير الإعلانات" من خلال دمج "مدير الإعلانات" لا يتم تصدير هذا الحدث إلى BigQuery. |
ad_event_id |
|
ad_exposure (التطبيقات) |
عند عرض إعلان واحد على الأقلّ على الشاشة من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة" لا يظهر هذا الحدث في التقارير ولا يتم تصديره إلى BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
ad_impression (التطبيقات) |
عندما يرى مستخدِم مرّة ظهور للإعلان أحداث الناشرِين الواردة من AdMob عبر "SDK لإعلانات Google على الأجهزة الجوّالة" أو "مدير الإعلانات" من خلال دمج "مدير الإعلانات" لا يتم تصدير هذا الحدث إلى BigQuery. |
ad_event_id, value* |
|
ad_query (التطبيقات) |
عند تقديم طلب إعلان من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة" لا يظهر هذا الحدث في التقارير ولا يتم تصديره إلى BigQuery. |
ad_event_id |
|
ad_reward (التطبيقات) |
عند منح مكافأة بواسطة إعلان مقابل مكافأة يُعرض من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة" | ad_unit_code, reward_type, reward_value |
|
adunit_exposure (التطبيقات) |
عندما تظهر على الشاشة وحدة إعلانية من خلال "حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة" لا يظهر هذا الحدث في التقارير ولا يتم تصديره إلى BigQuery. |
firebase_screen, firebase_screen_id, firebase_screen_class, exposure_time |
|
app_clear_data (التطبيقات) |
عندما يعيد المستخدِم ضبط بيانات التطبيق أو يمحوها، ويزيل كل الإعدادات وبيانات تسجيل الدخول نظام التشغيل Android فقط |
|
|
app_exception (التطبيقات) |
عندما يتعطّل التطبيق أو يعرض استثناءً يتم إرسال الحدث عند دمج Firebase Crashlytics. |
fatal وtimestamp وengagement_time_msec |
|
app_remove (التطبيقات) |
عند إزالة (إلغاء تثبيت) حزمة تطبيق من جهاز Android نظام التشغيل Android فقط |
|
|
app_store_refund (التطبيقات) |
عند ردّ أموال عملية شراء داخل التطبيق بواسطة Google Play نظام التشغيل Android فقط لا يتم تصدير هذا الحدث إلى BigQuery. |
product_id, value, currency, quantity |
|
app_store_ subscription_cancel (التطبيقات) |
عند إلغاء اشتراك مدفوع في Google Play نظام التشغيل Android فقط يتطلب اشتراكًا أوليًا بتاريخ 1 يوليو 2019 أو بعده. لا يتم تصدير هذا الحدث إلى BigQuery. |
product_id, price, value, currency, cancellation_reason |
|
app_store_ subscription_convert (التطبيقات) |
عند تحويل اشتراك يتضمن فترة تجريبية مجانية إلى اشتراك مدفوع يتم ضبط هذا الحدث على أنّه حدث رئيسي تلقائي. يتطلب اشتراكًا أوليًا بتاريخ 1 يوليو 2019 أو بعده. ويتم تسجيل الاشتراك الأولي للفترة التجريبية المجانية كحدث in_app_purchase مع ضبط معلَمة الاشتراك على "صحيح". لا يتم تصدير هذا الحدث إلى BigQuery. |
product_id, price, value, currency, quantity |
|
app_store_ subscription_renew (التطبيقات) |
عند تجديد اشتراك مدفوع يتم ضبط هذا الحدث على أنّه حدث رئيسي تلقائي. يتطلب اشتراكًا أوليًا بتاريخ 1 يوليو 2019 أو بعده. لا يتم تصدير هذا الحدث إلى BigQuery. |
product_id, price, value, currency, quantity, renewal_count |
|
app_update (التطبيقات) |
عند تحديث التطبيق إلى إصدار جديد وتشغيله مجددًا يتمّ ضبط رقم تعريف إصدار التطبيق السابق كمَعلمة. يختلف هذا الحدث من حيث مفهومه عن مقياس "عمليات الترقية اليومية بحسب الجهاز" الذي يتم تسجيله في التقارير بواسطة Google Play Console. ويُقصد بالترقية تحديث برنامج التطبيق الثنائي، في حين يبدأ حدث app_update في المرة التالية التي يتم فيها تشغيل التطبيق الذي تمت ترقيته. |
previous_app_version |
|
نقرة (المواقع الإلكترونية) |
في كل مرة ينقر المستخدم على رابط يؤدي إلى الانتقال من النطاق الحالي يتم تلقائيًا بدء أحداث ناتجة عن نقرات تؤدّي إلى خارج النطاق في كل مرة يتم النقر على رابط ينقل الزائر إلى خارج النطاق الحالي. أمّا روابط النطاقات التي تمّ ضبطها لميزة القياس على جميع النطاقات، فلن تؤدّي إلى بدء الأحداث الناتجة عن النقرات التي تؤدّي إلى خارج النطاق. تملأ المَعلمات السمات التالية:
يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
link_classes وlink_domain وlink_id وlink_url وoutbound (منطقية) |
|
dynamic_link_app_open (التطبيقات) |
عندما يعيد المستخدِم فتح التطبيق من خلال رابط ديناميكي ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ app_update (التطبيقات) |
عندما يتم تحديث التطبيق إلى إصدار جديد ويتم فتحه من خلال رابط ديناميكي نظام التشغيل Android فقط ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات |
source, medium, campaign, link_id, accept_time |
|
dynamic_link_ first_open (التطبيقات) |
عندما يفتح المستخدِم التطبيق لأول مرة من خلال رابط ديناميكي. ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات |
source, medium, campaign, link_id, accept_time |
|
خطأ (التطبيقات) |
عند تسجيل الدخول إلى حدث لا يمكن تسجيله لأنّه غير صالح بطريقة ما لا يظهر هذا الحدث في التقارير ولا يتم تصديره إلى BigQuery. |
firebase_error، firebase_error_value |
|
file_download (المواقع الإلكترونية) |
عندما ينقر المستخدِم على رابط يؤدي إلى ملف (بامتداد شائع) بالأنواع التالية:
يتم جمع هذا الحدث تلقائيًا من خلال القياس المحسّن. الاطّلاع على امتدادات الملفات التي تؤدي إلى تشغيل الحدث |
file_extension, file_name link_classes, link_id, link_text, link_url |
|
firebase_campaign (التطبيقات) |
عند تشغيل التطبيق باستخدام معلَمات الحملة |
مصدر، وسيط، حملة، عبارة، محتوى، gclid، aclid، cp1، anid، click_timestamp، campaign_info_source |
|
firebase_in_app_ message_action (التطبيقات) |
عند اتخاذ المستخدِم إجراء بشأن رسالة داخل التطبيق في Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_dismiss (التطبيقات) |
عند رفض المستخدِم رسالة داخل التطبيق في Firebase | message_name, message_device_time, message_id |
|
firebase_in_app_ message_impression (التطبيقات) |
عند رؤية المستخدِم رسالة داخل التطبيق في Firebase | message_name, message_device_time, message_id |
|
first_open (التطبيقات) |
في المرة الأولى التي يشغِّل فيها المستخدِم تطبيقًا بعد تثبيته أو إعادة تثبيته لا يتم بدء هذا الحدث عندما ينزِّل المستخدِم التطبيق على الجهاز، لكن عند استخدامه للمرة الأولى. لمعرفة أعداد عمليات التنزيل الأوّلية، انتقِل إلى Google Play Console أو iTunesConnect. يتيح هذا الحدث قياس الأحداث الرئيسية من النوع first_open للمستخدِمين الذين يقبلون طلب تتبُّع التطبيقات على نظام التشغيل iOS 14 من Apple. |
previous_gmp_app_id, updated_with_analytics, previous_first_open_count, system_app, system_app_update, deferred_analytics_collection, reset_analytics_cause, engagement_time_msec |
|
first_visit (التطبيقات، المواقع الإلكترونية) |
في المرّة الأولى التي يزور فيها المستخدِم موقعًا إلكترونيًا أو يشغِّل أحد تطبيقات Android الفورية مع تفعيل "إحصاءات Google" | |
|
form_start (المواقع الإلكترونية) |
في المرة الأولى التي يتفاعل فيها المستخدم مع نموذج في جلسة ملاحظة: لا يمكنك استخدام المَعلمات في تقاريرك إلا بعد إنشاء السمات المخصّصة لها. يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
form_id وform_name وform_destination |
|
form_submit (المواقع الإلكترونية) |
عندما يرسل المستخدم نموذجًا ملاحظة: لا يمكنك استخدام المَعلمات في تقاريرك إلا بعد إنشاء السمات المخصّصة لها. يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
form_id وform_name وform_destination وform_submit_text |
|
in_app_purchase (التطبيقات) |
عندما يُكمل المستخدم عملية شراء داخل التطبيق، بما في ذلك الاشتراك الأوليّ، الذي تتم معالجته من خلال Apple App Store أو "متجر Google Play" يتم نقل معرِّف المنتج واسم المنتج والعملة والكمية كمَعلمات. لا يتم بدء هذا الحدث إلا من خلال إصدارات التطبيق التي تتضّمن حزمة تطوير برامج (SDK) "إحصاءات Google لبرنامج Firebase". Android: للاطّلاع على بيانات الشراء داخل التطبيق لتطبيقات Android، يمكنك ربط "إحصاءات Google" بمنصّة Google Play. تجدر الإشارة إلى أنّ "إحصاءات Google" لا تقيس تلقائيًا الأرباح المحقَّقة من عمليات شراء التطبيقات المدفوعة. وعلاوةً على ذلك، فإنّ الأرباح التي يتم عرضها في تقارير "إحصاءات Google" قد تختلف عن القيَم التي تظهر لك في Google Play Console. تتجاهل "إحصاءات Google" الأحداث التي يتم وضع علامة عليها باعتبارها غير صالحة أو أحداث اختبارية. اطّلِع على مزيد من المعلومات عن اختبار خدمة "الفوترة في Google Play". نظام التشغيل iOS: يُرجى العلم أنّ "إحصاءات Google" لا تقيس تلقائيًا الأرباح المحقّقة من عمليات شراء التطبيقات المدفوعة وعمليات ردّ الأموال. تتجاهل "إحصاءات Google" الأحداث التي يتم وضع علامة عليها باعتبارها غير صالحة أو مُدرَجة في وضع الحماية. |
product_id, price, value, currency, quantity, subscription, free_trial, introductory_price |
|
notification_dismiss (التطبيقات) |
عندما يرفض مستخدِم إشعارًا تم إرساله من خلال خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" (FCM) نظام التشغيل Android فقط |
message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_foreground (التطبيقات) |
عندما يتم تلقّي إشعار مُرسَل من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" أثناء تشغيل التطبيق في المقدّمة. | message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
notification_open (التطبيقات) |
عندما يفتح المستخدِم إشعارًا مُرسَلاً من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" | message_name, message_time, message_device_time, message_id, topic, label, message_channel |
|
notification_receive (التطبيقات) |
عند تلقي الجهاز لإشعار مُرسَل من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" أثناء تشغيل التطبيق في الخلفية نظام التشغيل Android فقط |
message_name, message_time, message_device_time, message_id, topic, label, message_channel, message_type |
|
os_update (التطبيقات) |
عند تحديث نظام تشغيل الجهاز إلى إصدار جديد. يتمّ ضبط رقم تعريف إصدار نظام التشغيل السابق كمَعلمة. | previous_os_version |
|
page_view (المواقع الإلكترونية) |
كل مرة يتم فيها تحميل الصفحة أو تغيير حالة سجلّ التصفُّح بواسطة الموقع الإلكتروني النشط يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
page_location (page URL), page_referrer (previous page URL), engagement_time_msec |
|
screen_view (التطبيقات) |
عند ظهور انتقال شاشة والتوافق مع أي من المعايير التالية:
|
firebase_screen, firebase_screen_class, firebase_screen_id, firebase_previous_screen, firebase_previous_class, firebase_previous_id, engagement_time_msec |
|
التمرير (المواقع الإلكترونية) |
في المرة الأولى التي يصل فيها المستخدِم إلى أسفل كل صفحة (أي عندما يظهر 90% من عمقها الرأسي) يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
engagement_time_msec |
|
session_start (التطبيقات، المواقع الإلكترونية) |
عندما يتفاعل المستخدِم مع التطبيق أو الموقع الإلكتروني يتم إنشاء رقم تعريف جلسة ورقم جلسة تلقائيًا مع كل جلسة، ويتم ربطهما بكل حدث في الجلسة. مزيد من المعلومات |
|
|
user_engagement (التطبيقات، المواقع الإلكترونية) |
عندما يتم تشغيل التطبيق في المقدّمة أو تكون صفحة الويب محل التركيز لمدّة ثانية واحدة على الأقل مزيد من المعلومات |
engagement_time_msec |
|
video_complete (المواقع الإلكترونية) |
عند انتهاء الفيديو يُستخدَم هذا الحدث مع فيديوهات YouTube المضمَّنة التي تم فيها تفعيل ميزة التوافق مع واجهة برمجة تطبيقات JavaScript. يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_progress (المواقع الإلكترونية) |
عندما يتقدم الفيديو إلى أكثر من 10% و25% و50% و75% من مدته الزمنية يُستخدَم هذا الحدث مع فيديوهات YouTube المضمَّنة التي تم فيها تفعيل ميزة التوافق مع واجهة برمجة تطبيقات JavaScript. يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
video_start (المواقع الإلكترونية) |
عند بدء تشغيل الفيديو يُستخدَم هذا الحدث مع فيديوهات YouTube المضمَّنة التي تم فيها تفعيل ميزة التوافق مع واجهة برمجة تطبيقات JavaScript. يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
video_current_time, video_duration, video_percent, video_provider, video_title, video_url, visible (boolean) |
|
view_search_results (المواقع الإلكترونية) |
في كل مرة يجري فيها أحد المستخدِمين عملية بحث عن موقع إلكتروني، ويشار إليه بوجود معلَمة طلب بحث عن عنوان URL يتم جمع هذا الحدث بشكلٍ تلقائي من خلال ميزة القياس المحسَّن. |
search_term واختياريًا q_<additional key="">’‘ (حيث يتطابق <additional key=""> مع معلمة طلب بحث إضافية تحدّدها ليتم جمعها ضمن الإعدادات المتقدمة) ملاحظة: يرسل هذا الحدث المَعلمة unique_search_term فقط عندما تكون قيمتها 1 (أي عندما تكون السلسلة فريدة لتلك الجلسة). |
ملاحظة: ستؤدي امتدادات الملفات التي تتطابق مع التعبير العادي التالي إلى ظهور الحدث file_download:
pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma
* لا يتم تمرير عملة أو قيمة ad_impression من خلال الدمج التلقائي