[إحصاءات Google‏ 4] الأحداث المجمّعة تلقائيًا

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

تجمع "إحصاءات Google" الأحداث لتطبيقات Android وiOS، ما لم يُذكَر خلاف ذلك. يمكن أن تكون أسماء هذه الأحداث ومَعلماتها مفيدة عند الوصول إلى بيانات الأحداث الأوليّة في BigQuery.

ملاحظة

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

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution

يجب أن يكون عدد أحرف القيمة المخصَّصة لمَعلمات الأحداث هو 100 حرف أو أقل. ويجب أن يكون عدد أحرف المَعلمة page_title هو 300 حرف أو أقل. ويجب أن يكون عدد أحرف المَعلمة page_referrer ‏420 حرفًا أو أقلّ. ويجب أن يكون عدد أحرف المَعلمة page_location ‏1,000 حرف أو أقلّ.

إذا تم إلغاء مَعلمة page_location، تأكَّد من صلاحية مسار عنوان URL. وفي حال تحديد مسار عنوان URL غير صالح، ستكون سمة موقع الصفحة فارغة. يمكنك استخدام أداة إنشاء عناوين URL للحملات للتحقق ممّا إذا كان مسار عنوان URL صالحًا أم لا.

الحدث حالات البدء التلقائي... المَعلمات

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 فقط

يختلف هذا الحدث عن مقياسَي عمليات الإزالة اليومية بحسب الجهاز وعمليات الإزالة اليومية بحسب المستخدم، اللذَين يتم تسجيلهما من خلال Google Play Console. يحتسِب حدث app_remove عدد مرات إزالة حِزم التطبيقات بغض النظر عن مصدر التثبيت، ويتغير العدد بالاستناد إلى النطاق الزمني الذي تستخدِمه في التقرير. ويعمل مقياسا عمليات الإزالة اليومية بحسب الجهاز وعمليات الإزالة اليومية بحسب المستخدم على احتساب عدد مرّات إزالة حِزم التطبيقات فقط إذا تم تثبيتها من Google Play، واللذَين يتم تسجيلهما في التقارير بشكل يومي.

 

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 (منطقية)

عندما يعيد المستخدِم فتح التطبيق من خلال رابط ديناميكي

ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات

source, medium, campaign, link_id, accept_time

عندما يتم تحديث التطبيق إلى إصدار جديد ويتم فتحه من خلال رابط ديناميكي

نظام التشغيل Android فقط

ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات

source, medium, campaign, link_id, accept_time

عندما يفتح المستخدِم التطبيق لأول مرة من خلال رابط ديناميكي.

ملاحظة: يجري إيقاف هذا الحدث تدريجيًا لأنّ ميزة "روابط Firebase الديناميكية" أصبحت متوقّفة نهائيًا في الوقت الحالي. مزيد من المعلومات عن هذه التغييرات

source, medium, campaign, link_id, accept_time

خطأ

(التطبيقات)

عند تسجيل الدخول إلى حدث لا يمكن تسجيله لأنّه غير صالح بطريقة ما

تحتوي المَعلمات التالية على معلومات إضافية: ‎_err (firebase_error) و‎_ev (firebase_error_value) و‎_el (firebase_error_length).

لا يظهر هذا الحدث في التقارير ولا يتم تصديره إلى 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

scroll

(المواقع الإلكترونية)

في المرة الأولى التي يصل فيها المستخدِم إلى أسفل كل صفحة (أي عندما يظهر 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

* يتم تمرير عملة أو قيمة no_ad_impression من خلال الدمج التلقائي.

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟

هل تحتاج إلى مزيد من المساعدة؟

جرِّب الخطوات التالية:

بحث
محو البحث
إغلاق البحث
تطبيقات Google
القائمة الرئيسية
2954611543859279311
true
مركز مساعدة البحث
true
true
true
true
true
69256