إنّ إضافة الأحداث المقترَحة إلى موقعك الإلكتروني أو تطبيقك للأجهزة الجوّالة تساعدك في قياس ميزات وسلوكيات إضافية، وكذلك في إنشاء تقارير أكثر فائدة. ولا يتم إرسال هذه الأحداث تلقائيًا لأنها تتطلب سياقًا إضافيًا لتحقيق فائدة.
استخدِم الروابط الواردة في هذه المقالة للاطّلاع على المَعلمات المخصَّصة لكل حدث. يجب إرسال الأحداث المُقترَحة مع المَعلمات المخصَّصة لها للحصول على أكبر قدر من التفاصيل في تقاريرك وللاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها.
للتعرّف على كيفية إعداد حدث مُقترَح على موقعك الإلكتروني، عليك الاطّلاع على دليل إعداد الأحداث. بالنسبة إلى مشروع تطبيقك، اطّلِع على دليل تسجيل الأحداث. تعمل البيانات من هذه الأحداث على تعديل السمات والمقاييس المحدّدة مسبقًا تلقائيًا كي تتمكّن من تحليل البيانات في تقاريرك.
للاطّلاع على الترجمة بلغتك، فعِّل الترجمة والشرح على YouTube. انقر على رمز الإعدادات أسفل مشغِّل الفيديو، ثم انقر على "ترجمة وشرح" واختَر اللغة التي تريدها.
بالنسبة إلى جميع المواقع
ننصح باستخدام الأحداث التالية مع جميع العملاء في جميع مجالات الأنشطة التجارية. وتتضمّن الأقسام اللاحقة في هذه المقالة بعض هذه الأحداث عندما نقترح إرسال الأحداث لحالة الاستخدام المحدّدة.
| الحدث | يبدأ عند اتخاذ المستخدِم الإجراء التالي |
|---|---|
| ad_impression | رؤية إعلان، للتطبيقات فقط |
| earn_virtual_currency | ربح عملة افتراضية (عملات معدنية أو جواهر أو رموز مميّزة أو غير ذلك) |
| generate_lead | إرسال نموذج أو طلب للحصول على معلومات |
| join_group | الانضمام إلى مجموعة |
| login | تسجيل الدخول |
| purchase | إكمال عملية شراء |
| refund | استرداد الأموال |
| search | البحث في موقعك الإلكتروني أو تطبيقك |
| select_content | اختيار محتوى على موقعك الإلكتروني أو تطبيقك |
| share | مشاركة محتوى من موقعك الإلكتروني أو تطبيقك |
| sign_up | الاشتراك للحصول على حساب على موقعك الإلكتروني أو تطبيقك |
| spend_virtual_currency | إنفاق عملة افتراضية (عملات معدنية أو جواهر أو رموز مميّزة أو غير ذلك) |
| tutorial_begin | بدء برنامج تعليمي أثناء عملية الإعداد |
| tutorial_complete | إكمال برنامج تعليمي أثناء عملية الإعداد |
بالنسبة إلى المبيعات على الإنترنت
ننصح باستخدام هذه الأحداث إذا كنت تريد قياس المبيعات على موقعك الإلكتروني أو تطبيقك. وهي مفيدة للبيع بالتجزئة والتجارة الإلكترونية والتعليم والعقارات والسفر. ويؤدّي إرسال الأحداث إلى تعبئة تقرير عمليّات الشراء في التجارة الإلكترونية. للمزيد من المعلومات عن هذه الأحداث، اطّلِع على دليل قياس التجارة الإلكترونية لموقعك الإلكتروني. وبالنسبة إلى الأحداث في مشروع تطبيقك، يمكنك الاطّلاع على دليل قياس التجارة الإلكترونية (التطبيق).
| الحدث | يبدأ عند اتخاذ المستخدِم الإجراء التالي |
|---|---|
| add_payment_info | إرسال معلومات الدفع أثناء الدفع |
| add_shipping_info | إرسال معلومات الشحن أثناء الدفع |
| add_to_cart | إضافة سلع إلى سلّة التسوّق |
| add_to_wishlist | إضافة سلع إلى قائمة الأمنيات |
| begin_checkout | بدء عملية الدفع |
| purchase | إكمال عملية شراء |
| refund | استرداد الأموال |
| remove_from_cart | إزالة سلع من سلّة التسوّق |
| select_item | اختيار عنصر من قائمة السلع أو العروض |
| select_promotion | اختيار عرض ترويجي |
| view_cart | الاطّلاع على سلّة التسوّق |
| view_item | الاطّلاع على سلعة |
| view_item_list | الاطّلاع على قائمة السلع أو العروض |
| view_promotion | الاطّلاع على عرض ترويجي على موقعك الإلكتروني أو تطبيقك |
الألعاب
نقترح استخدام هذه الأحداث لمواقع الألعاب. يؤدي إرسال هذه الأحداث إلى تعبئة تقارير الألعاب.
| الحدث | يبدأ عند اتخاذ المستخدِم الإجراء التالي |
|---|---|
| earn_virtual_currency | ربح عملة افتراضية (عملات معدنية أو جواهر أو رموز مميّزة أو غير ذلك) |
| join_group | الانضمام إلى مجموعة |
| level_end | إكمال مستوى في لعبة |
| level_start | بدء مستوى جديد في اللعبة |
| level_up | الانتقال إلى مستوى أعلى في اللعبة |
| post_score | نشر النتيجة |
| select_content | اختيار المحتوى |
| spend_virtual_currency | إنفاق عملة افتراضية (عملات معدنية أو جواهر أو رموز مميّزة أو غير ذلك) |
| tutorial_begin | بدء برنامج تعليمي أثناء عملية الإعداد |
| tutorial_complete | إكمال برنامج تعليمي أثناء عملية الإعداد |
| unlock_achievement | فتح إنجاز |
التحقّق من أحداثك
راقِب الأحداث المُقترَحة بعد الإعداد باستخدام أداة DebugView. ويمكنك أيضًا عرض تقرير الوقت الفعلي للاطّلاع على الأحداث الواردة من مستخدمين حقيقيين عند بدء الأحداث.
الأحداث المقترَحة في "إحصاءات Google"
يقدِّم تقرير الأحداث اقتراحات بشأن الأحداث التي يجب جمعها استنادًا إلى البيانات التي جمعتها من قبل أو فئة التطبيق في متجر Google Play أو متجر App Store لنظام التشغيل iOS (مثل التجارة الإلكترونية والسفر). تظهر ثلاثة اقتراحات في أعلى جدول "الأحداث" تلقائيًا.
- للاطّلاع على مزيد من الاقتراحات، انقر على عرض الكل.
- لعرض مقتطف الرمز من أجل جمع حدث ما، انقر على صف الحدث.
- لرفض اقتراح، مرِّر مؤشر الماوس فوق اسم الحدث، ثم انقر على الرمز
.
بعض الاعتبارات المتعلّقة بتحديث حِزم تطوير البرامج (SDK) إلى الإصدار 17.2.5 (أو إصدار أحدث) لنظام التشغيل Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) لنظام التشغيل iOS
إذا كنت تستخدِم إصدارات سابقة من إحدى حزمَتي تطوير البرامج (SDK) وكنت تخطِّط للترقية إلى الإصدار 17.2.5 (أو إصدار أحدث) لنظام التشغيل Android و/أو الإصدار 16.20.0 (أو إصدار أحدث) لنظام التشغيل iOS، عليك مراعاة ما يلي:
- بمجرّد الترقية، لن تتمكّن من الوصول إلى بيانات المنتجات إلّا داخل مصفوفة المنتجات المتكرّرة، ولن تكون هذه البيانات متوفّرة في مَعلمات الأحداث العادية كما كان الحال قبل هذه الإصدارات من حزمتَي تطوير البرامج.
- تم إجراء هذا التغيير للسماح بتحليل منتجات متعددة.
- قد تحتاج إلى تعديل الإشارات المرجعية إلى بيانات السلع/المنتجات نتيجةً لذلك.
هناك تغيير في تنسيق مخطط BigQuery أثناء هذه الترقية. وستبدأ بيانات السلع/المنتجات في الظهور في حقل متكرّر، ما يسمح بتحليل منتجات متعددة ضمن حدث واحد. ويجب الحرص على تعديل أيّ طلب بحث يشير إلى حقول بيانات السلع/المنتجات أثناء هذه الترقية.