هل يتكامل نظامكم مع Google Analytics 4؟

نعم. ترسل Checkout Widget أحداث الحجز إلى Google Analytics 4 (GA4) طوال رحلة الحجز. تغطي هذه التعليمات الإصدار الحالي من Checkout Widget؛ راجعوا الأدوات القديمة إذا كنتم تستخدمون الإصدار الأقدم.

إعداد التتبّع

في إعدادات أداة Checkout Widget، افتحوا Analytics، وفعّلوا Enable Google Analytics. ضمن Send events via، اختاروا الطريقة التي ترسل بها الأداة أحداث الحجز. تستخدم الأداة طريقة واحدة في كل مرة:

• Google Analytics 4 — اختاروا Use existing tag إذا كان موقعكم يحمّل علامة Google Analytics مسبقًا، أو اختاروا Use custom tag وأدخلوا معرّف القياس في GA4 (G-…). سترسل الأداة الأحداث من خلال تلك العلامة تلقائيًا.
• Google Tag Manager — فعّلوا Enable Google Tag Manager، ثم استخدموا حاوية موقعكم الحالية أو أدخلوا معرّف حاوية مخصّصًا (GTM-…). ترسل الأداة الأحداث إلى Data Layer. تصل أحداث الحجز إلى GA4 بعد إعداد علامات أحداث GA4 باستخدام مشغّلات Custom Event المطابقة وبيانات التجارة الإلكترونية من Data Layer ونشرها في حاويتكم. راجعوا دليل إعداد Tag Manager.

احفظوا إعداداتكم لتمكين التتبّع. تجنّبوا إعادة إرسال أحداث الحجز نفسها عبر Tag Manager أو باستخدام تعليمات برمجية مخصّصة في الوقت الذي ترسل فيه الأداة هذه الأحداث أيضًا عبر Google Analytics 4، إذ قد تُحتسب عمليات الشراء والإيرادات مرتين.

الأحداث المُرسلة تلقائيًا

الحدث	متى ترسله Checkout Widget
page_view	عند عرض إحدى خطوات الأداة، بما في ذلك شاشات الاختيار والدفع والنجاح والخطأ
select_item	عند اختيار منتج أو باقة أو قسيمة منتج من قائمة المنتجات/الفعاليات
add_to_cart	عند إضافة حجز أو باقة إلى السلة
view_cart	عند عرض السلة
begin_checkout	عند عرض خطوة بيانات العميل
add_payment_info	عند عرض خطوة الدفع — قبل إرسال بيانات الدفع
purchase	عند نجاح الدفع أو تأكيد طلب لم يعد يتطلب أي مبلغ للدفع

تعتمد الخطوات على رحلة الحجز. فعلى سبيل المثال، قد يتجاوز الحجز المجاني شاشة الدفع.

محتوى الأحداث

• مشاهدات الصفحة: يحدّد page_title وpage_path خطوة الأداة، مثل tier_selection أو extras_selection أو basket أو payment. أما page_location فهو عنوان URL لصفحة موقعكم التي تحتوي على الأداة.
• اختيار المنتج: يحدّد كل من item_list_id وitem_list_name ومصفوفة items المنتج أو الباقة المحددة.
• أحداث السلة وإتمام الحجز: تتضمن currency وvalue الرقمي وorder_id وlocale وitems. وتحدّد العناصر أنواع التذاكر والكميات وأسعار الوحدات والمنتج/الباقة المرتبطة بها. يستخدم الاختيار معرّفات المنتجات/الباقات، بينما تستخدم الأحداث اللاحقة معرّفات أنواع التذاكر.
• الشراء: يتضمن أيضًا transaction_id (مرجع الطلب). ويُدرج coupon في begin_checkout وadd_payment_info وpurchase عند توفره. كما تتضمن أحداث Analytics أيضًا widget_id.

نطاق الإيرادات: تمثّل value إجمالي التذاكر المتتبَّعة في حجوزات المنتجات والباقات، بما في ذلك قسائم المنتجات. ولا تشمل الإضافات أو البضائع أو مشتريات بطاقات الهدايا، ولذلك قد تختلف الإيرادات في GA4 عن إجمالي الطلب الكامل.

التتبّع المخصّص

لإعداد تتبّع مخصّص، يمكن لمطوّر موقعكم الاستماع إلى الأحداث السبعة نفسها على document باستخدام البادئة th:، مثل th:purchase. وتوجد بياناتها في event.detail، كما تظل متاحة عند إيقاف التتبّع المدمج في Google Analytics.

التحقّق من الإعداد

أكملوا حجزًا تجريبيًا على الصفحة التي أُدرجت فيها أداتكم. تحقّقوا من Realtime أو DebugView في GA4؛ فقد تستغرق التقارير العادية من 24 إلى 48 ساعة حتى تُحدَّث. وبالنسبة إلى Tag Manager، استخدموا Preview للتحقّق من تشغيل علامات GA4، ثم انشروا تغييراتكم.

للاطّلاع على تسجيلات وحدة التحكّم والأحداث المفقودة ومشكلات الموافقة أو أدوات حظر الإعلانات، اتّبعوا كيفية تصحيح أخطاء التتبّع في Google Analytics وTag Manager.