كيفية تصحيح أخطاء التتبع في Google Analytics وTag Manager
إذا لم تظهر الحجوزات التي تمت من خلال أداة الدفع في Google Analytics، تساعدك سجلات التصحيح المضمنة في الأداة على معرفة المرحلة التي تتوقف عندها.
1. تعرّف أولًا على كيفية إرسال الأداة للأحداث
في إعدادات الأداة، ضمن Analytics، يحدد الخيار Send events via كيفية عمل التتبع. يعمل الخياران بطريقة مختلفة جدًا، ولذلك يختلف ما ينبغي أن تتوقع رؤيته عند تصحيح الأخطاء.
Google Analytics 4 — ترسل الأداة كل حدث حجز مباشرةً إلى موقعك في Analytics. عند اختيار Use existing tag (وهو الإعداد الافتراضي)، تستخدم علامة Google Analytics الموجودة أصلًا في صفحتك؛ أما عند اختيار Use custom tag، فتحمّل الأداة علامتها الخاصة باستخدام معرّف القياس الذي تدخله. في كلتا الحالتين، تكون الأداة هي التي تتواصل مع Google، ولذلك يمكنك رؤية بيانات الحجز الصادرة في علامة التبويب Network في متصفحك.
Google Tag Manager — لا ترسل الأداة أي شيء إلى Google Analytics. بل تسلّم كل حدث إلى حاوية Tag Manager، وتقرر الحاوية ما الذي ستفعله به. عند اختيار Use existing container (وهو الإعداد الافتراضي)، تستخدم الحاوية الموجودة أصلًا في صفحتك؛ أما عند اختيار Use custom container، فتحمّل الحاوية باستخدام معرّف الحاوية الذي تدخله. في كلتا الحالتين، لن تصل أي بيانات إلى Google Analytics ما لم تُعِدّ علامة داخل Tag Manager لإرسالها. وهذا هو السبب الأكثر شيوعًا لاختفاء الحجوزات: فالأداة تعمل بشكل صحيح تمامًا، لكن لا توجد علامة تلتقط الأحداث. راجع القسم 5.
يوجد أيضًا مفتاح رئيسي باسم Enable Google Analytics في أعلى القسم نفسه. يؤدي هذا المفتاح إلى تشغيل التتبع أو إيقافه لكلا الخيارين — فإذا كان متوقفًا، فلن يتم تتبع أي شيء حتى عند تفعيل Tag Manager.
2. فعّل تسجيل التصحيح
- في لوحة تحكم TicketingHub، افتح إعدادات أداة الدفع التي تريد اختبارها.
- في قسم Analytics، فعّل Enable analytics debug logging ثم احفظ التغييرات.
أثناء تفعيل هذا الخيار، تكتب الأداة سطرًا في وحدة تحكم المتصفح على موقعك لكل حدث. عند تحديد Google Analytics 4، يؤدي ذلك أيضًا إلى تفعيل وضع تصحيح الأخطاء لعلامة Google. وعند استخدام Google Tag Manager، استخدم المعاينة أو فعّل وضع تصحيح الأخطاء في علامة GA4 لرؤية الأحداث في DebugView. يوضح تسجيل وحدة التحكم جانب الأداة فقط — فلا يمكنه معرفة ما تفعله Google بعد ذلك، ولذلك لا يحل محل GA4 DebugView أو GTM Preview.
3. افتح وحدة تحكم المتصفح على موقعك
- افتح الصفحة على موقعك الإلكتروني التي تضم أداة الدفع (وليس لوحة تحكم TicketingHub).
- افتح أدوات المطور في متصفحك (F12، أو انقر بزر الماوس الأيمن ← فحص)، ثم انتقل إلى علامة التبويب Console.
- إذا كان متصفحك يعرض محددًا للإطارات في وحدة التحكم، فتأكد من تحديد الإطار top — إذ تُبلغ الأداة صفحتك بالأحداث، وليس إطارها الخاص.
- فعّل Preserve log من إعدادات وحدة التحكم — فإذا كانت الأداة تعيد التوجيه إلى صفحة أخرى بعد إتمام الحجز، تُكتب الرسائل المتعلقة بحدث الشراء النهائي قبل إعادة التوجيه مباشرةً، وإلا فسيتم مسحها قبل أن تتمكن من قراءتها.
- أجرِ حجزًا تجريبيًا. تأكد من أن وحدة التحكم مفتوحة قبل تحميل الصفحة (أو أعد تحميل الصفحة وهي مفتوحة)، حتى ترى أيضًا الرسائل التي تظهر أثناء بدء تشغيل الصفحة.
4. معنى رسائل وحدة التحكم
| الرسالة | المعنى |
|---|---|
Triggering GA event … / Triggering GTM event … | أرسلت الأداة الحدث إلى Google Analytics، أو سلّمته إلى حاوية Tag Manager الخاصة بك. |
… event … processed | تم استلام الحدث ومعالجته، وعادةً ما تذكر الرسالة العلامة أو الحاوية التي عالجته. في Tag Manager، يعني ذلك أن حاويتك استلمت الحدث — وليس أن أي شيء أُرسل إلى Google. راجع القسم 5. |
… event … was not confirmed within …ms | لم يُبلغ أي شيء الأداة بأنه عالج الحدث خلال بضع ثوانٍ. لا يعني ذلك بالضرورة فقدان الحدث — تحقق من GA4 DebugView لمعرفة ما إذا كان قد وصل. توجد الأسباب الشائعة في القسم 6. |
… event … was still waiting for confirmation when the page navigated away | أعادت الأداة التوجيه إلى صفحة أخرى قبل اكتمال الفحص، وهذا أمر طبيعي إذا كنت تستخدم إعادة توجيه بعد الشراء. لا يعني ذلك فشل الحدث — أكّد وصوله في GA4 DebugView. |
… failed to load … | تعذر تحميل برنامج Google النصي — ويحدث ذلك عادةً بسبب حظره بواسطة مانع إعلانات أو مرشح شبكة. |
… event … dropped … | تعذر إرسال الحدث على الإطلاق. توضح الرسالة السبب: لا تتوفر خدمة Google Analytics أو Tag Manager على الصفحة بعد، أو أن Tag Manager متوقف في إعدادات الأداة. |
تتعمد الأداة الإبلاغ فقط عما يمكنها التأكد منه. فهي تعرف ما إذا كان برنامج Google النصي قد تم تحميله وما إذا كانت علامتك قد أكدت معالجة حدث — لكنها لا تعرف ما إذا كانت Google قد قبلت البيانات، ولذلك توجهك إلى DebugView بدلًا من التخمين.
5. إذا كنت تستخدم Google Tag Manager، فأعدّ علاماتك
Tag Manager حاوية وليس أداة تتبع. عندما تسلّمه الأداة حدث حجز، تتحقق حاويتك من المشغلات وتشغّل العلامات المطابقة. إذا لم تتطابق أي علامة، يتوقف الحدث عند هذه النقطة ببساطة — وستظل وحدة التحكم تعرض processed، لأن حاويتك استلمت الحدث بالفعل.
لن تلتقط حاوية جديدة هذه الأحداث تلقائيًا. إذ يتم إعداد معظم علامات Analytics للعمل عند التشغيل على “Initialization” أو “All Pages”، وهما لا يتطابقان مع أحداث الحجز في الأداة.
لإرسال حجوزات الأداة إلى Google Analytics، تحتاج داخل حاوية Tag Manager إلى ما يلي:
- Google tag (أو علامة إعداد GA4) تتضمن معرّف القياس (
G-…). - GA4 Event tag لكل حدث حجز تريد تتبعه، باستخدام مشغل Custom Event يتطابق اسم الحدث فيه مع أحد أحداث الأداة.
ترسل الأداة أسماء الأحداث التالية:
| الحدث | وقت حدوثه |
|---|---|
page_view | ينتقل الزائر إلى خطوة أخرى من الأداة |
select_item | يتم تحديد منتج أو باقة من قائمة المنتجات/الفعاليات |
add_to_cart | تتم إضافة العناصر إلى السلة |
view_cart | يظهر ملخص الطلب |
begin_checkout | تظهر خطوة بيانات العميل |
add_payment_info | تظهر خطوة الدفع، قبل إرسال البيانات |
purchase | تنجح عملية الدفع أو يتم تأكيد طلب لا يتبقى عليه أي مبلغ مستحق |
بالنسبة إلى أحداث التسوق، اضبط علامتك لإرسال بيانات التجارة الإلكترونية من Data Layer. ترسل الأداة حقول التجارة الإلكترونية القياسية في Google Analytics — مثل العملة والقيمة والعناصر ومعرّف المعاملة — بالتنسيق الذي تتوقعه Google، ولذلك لا تحتاج إلى أي تعيين مخصص.
استخدم GTM Preview (Tag Assistant) للتحقق من إعداداتك: فهو يعرض كل حدث يصل من الأداة والعلامات التي تم تشغيلها أو لم يتم تشغيلها بالضبط. إذا وصل حدث ولم يتم تشغيل أي علامة، فهذا يعني أن المشغل لا يتطابق معه؛ وإذا تم تشغيل علامة ولم يصل شيء إلى Analytics، فتحقق من معرّف القياس في العلامة.
توقع أمرًا واحدًا: عند استخدام Tag Manager، لن ترى بيانات الحجز المتجهة إلى Google Analytics في علامة التبويب Network من الأداة نفسها. قد تحمّل الأداة البرنامج النصي لحاوية Tag Manager، لكن الطلبات التي تحمل بيانات الحجز تصدر من علاماتك أنت، بعد تشغيلها.
6. الأسباب والحلول الشائعة
- مانعات الإعلانات وإضافات الخصوصية — تحظر هذه الأدوات برامج Google النصية للتتبع في قوائم الحظر الافتراضية تقريبًا. اختبر في نافذة خاصة/متخفية مع تعطيل الإضافات، أو في ملف تعريف متصفح نظيف. تذكّر أن الزوار الذين يستخدمون مانعات الإعلانات لن يتم تتبعهم أيضًا، ولذلك يكون بعض الحجوزات المفقودة أمرًا طبيعيًا.
- تتم معالجة الأحداث، لكن لا يظهر شيء في Analytics — عند استخدام Tag Manager، يعني هذا دائمًا تقريبًا عدم وجود علامة معدة للعمل عند وقوع أحداث الأداة. راجع القسم 5.
- لا تظهر أي رسائل في وحدة التحكم إطلاقًا — قد يكون التتبع متوقفًا بالكامل. تحقق من تفعيل Enable Google Analytics، وتذكر أنه يتحكم أيضًا في Tag Manager. تأكد كذلك من تحميل الصفحة ووحدة التحكم مفتوحة مسبقًا.
- تظهر رسالة تفيد بإسقاط كل حدث لأن Tag Manager متوقف — فعّل Enable Google Tag Manager في إعدادات الأداة. يجب تفعيل كل من هذا الخيار وEnable Google Analytics حتى يعمل خيار Tag Manager.
- لا تظهر رسائل Tag Manager، بل رسائل Google Analytics فقط — تم إعداد الأداة لإرسال الأحداث عبر Google Analytics 4، ولذلك يتم تجاهل إعدادات Tag Manager. غيّر Send events via إلى Google Tag Manager. تستخدم الأداة طريقة واحدة أو الأخرى، وليس كلتيهما.
- معرّف قياس أو معرّف حاوية غير صحيح — تحقق من أن المعرّف في إعدادات الأداة يطابق موقع Analytics (
G-…) أو حاوية Tag Manager (GTM-…). - شرائط الموافقة — إذا لم يوافق الزائر على ملفات تعريف ارتباط Analytics، فقد يؤخر Google Consent Mode الأحداث عمدًا. امنح موافقة Analytics في صفحة الاختبار قبل استخلاص أي استنتاجات.
- إضافات التخزين المؤقت أو التحسين — تتداخل بعض إضافات التخزين المؤقت أو التحسين في WordPress مع برامج Analytics النصية. حاول تعطيلها مؤقتًا، أو أضف البرامج النصية إلى قائمة الاستثناءات الخاصة بها.
7. أكّد البيانات باستخدام أدوات Google
توضح وحدة التحكم أن الأداة أدت دورها. وللتأكد من وصول البيانات:
- يعرض GA4 DebugView (Analytics ← Admin ← DebugView) الأحداث التي تصل إلى موقعك في الوقت الفعلي.
- يعرض GTM Preview (Tag Assistant) العلامات التي يتم تشغيلها لكل حدث ترسله الأداة.