تشخيص Google Consent Mode

إن أظهرت Google Ads أو GA4 أو خدمات Google الأخرى مشكلات في إشارات الموافقة، فاتّبع خطوات التشخيص هذه للتحقّق من تنفيذ أرقام٣٦٠ لـ GCM v2.

إشارات وضع الموافقة أو TCF غائبة أو خاطئة في علامات Google لديك؟ تواصل مع دعم أرقام٣٦٠ أوّلًا، لا مع Google. راسلنا على admin@arqam360.com أو استخدم صفحة التواصل. نتولّى تشخيص إعداد أرقام٣٦٠ لديك، وشريط الموافقة، وإشارات وضع الموافقة، في كلّ الباقات. وقد يطلب منك دعم Google ما يثبت أنّك تواصلت أوّلًا مع منصّة إدارة الموافقة التي تستخدمها.

وضع التشخيص: افحص ترتيب تحميل الموافقة

لا يعمل وضع الموافقة كما صُمّم إلا إذا ضُبطت حالة الموافقة الافتراضيّة قبل أن تعمل أيّ علامة من Google. ويفحص نصّ أرقام٣٦٠ البرمجي ذلك في كلّ تحميل للصفحة، قبل أن يضبط حالته الافتراضيّة مباشرةً. ويعرض وضع التشخيص النتيجة كاملةً في وحدة تحكّم المتصفّح (أدوات المطوّر، ثمّ Console). ولا يرى الزوّار شيئًا في الحالتين. فعّله بإحدى هذه الطرق:

• أضف data-debug="true" إلى وسم نصّ أرقام٣٦٠ البرمجي، كما في المثال أدناه. يبقى مفعّلًا في كلّ تحميل للصفحة حتى تحذفه.
• أضف ?debug=1 إلى رابط الصفحة، مثل https://yourstore.com/?debug=1. ولا يتأثّر إلا ذلك التحميل.
• أو أضف ?arqam_debug=1 إن كان موقعك يستخدم معامل debug لغرض آخر.

<script src="https://cdn.arqam360.com/widget-v2.js"
        data-key="YOUR_SITE_KEY"
        data-debug="true"></script>

ما تراه دون وضع التشخيص

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

• حالة افتراضيّة متأخّرة: "[Arqam360] Consent Mode: Google tags ran before the أرقام٣٦٠ consent default was set, so they may have sent data before consent applied. Load the أرقام٣٦٠ script before every Google tag (gtag.js / Google Tag Manager). Detected: …". ويذكر الجزء Detected ما رصده الفحص: علامة من Google عملت قبله (window.google_tag_manager موجود)، أو أمر مثل "config" سبق في dataLayer أيّ حالة موافقة افتراضيّة، أو طلبات إلى Google بدأت قبله، مع روابطها.
• واجهة TCF متأخّرة، حين يكون TCF مفعّلًا فقط: "[Arqam360] TCF: Google tags ran before the أرقام٣٦٠ TCF stub (window.__tcfapi) was registered, so they could not read the visitor's TC string. Load the أرقام٣٦٠ script before every Google tag."
• وينتهي التحذيران بالإرشاد نفسه: "First check whether the late tag is served from your own domain through Google tag gateway (GTG); if it is, follow the GTG instructions in this guide: https://arqam360.com/help/installation/google-tag-gateway"، أي: تحقّق أوّلًا إن كانت العلامة المتأخّرة تُقدَّم من نطاقك عبر بوابة علامات Google (GTG)، فإن كانت كذلك فاتّبع تعليمات الدليل.

ما يضيفه وضع التشخيص

حين يكون وضع التشخيص مفعّلًا، تعرض وحدة التحكّم أيضًا:

• نجاح الفحص: "[Arqam360 debug] Consent Mode check passed: the consent default was set before any Google tag ran." ومع تفعيل TCF تصبح "the consent default and the TCF stub were set". لا شيء يحتاج إلى إصلاح.
• نجاة بالمصادفة: "[Arqam360 debug] Consent Mode: a Google tag script appears before the أرقام٣٦٠ script (…). It has not run yet, so the default is on time on this load, but on a faster connection it can run first. Move the أرقام٣٦٠ script above it."، يليها إرشاد بوابة علامات Google نفسه. الترتيب نجح في هذا التحميل مصادفةً، فأصلحه.
• بوابة علامات Google: "[Arqam360 debug] A Google tag on this page is served from a first-party URL, which usually means Google tag gateway. See https://arqam360.com/help/installation/google-tag-gateway".
• النتيجة الكاملة: "[Arqam360 debug] Load-order findings:" يليها كائن تستطيع توسيعه. الحقول late و tcfLate و risk تبيّن المشكلة التي وُجدت، والحقول ran و queued و firstCommand و requests و scriptsBefore تبيّن ما رصده الفحص، والحقل gtgSuspected يبيّن إن بدت علامة من Google مقدَّمة عبر بوابة علامات Google.

إن وجد الفحص حالة افتراضيّة متأخّرة

العلامة المتأخّرة تُقدَّم من نطاقك؟ يشرح دليل بوابة علامات Google (GTG) وتوقيت الموافقة كيف تتحقّق من ذلك وماذا تغيّر.

أدوات التشخيص

• Google Tag Assistant (tagassistant.google.com) — لمراقبة حالة الموافقة لحظيًّا
• Console في أدوات المطوّر بالمتصفّح — لعرض استدعاءات gtag() وأحداث الموافقة
• تشخيصات Google Ads — لفحص تغطية الموافقة في حسابك على Google Ads
• GA4 DebugView — لرؤية الأحداث ومعاملات الموافقة لحظيًّا

مشكلات شائعة

• لا تصل إشارة الموافقة — نصّ أرقام٣٦٠ البرمجي يُحمَّل بعد علامة Google. الحلّ: اجعل أرقام٣٦٠ يُحمَّل أوّلًا.
• الموافقة عالقة على denied — تحقّق من عدم وجود خطأ JavaScript يمنع انطلاق تحديث الموافقة.
• بعض المعاملات فقط تتحدّث — تأكّد من أنّ فئات الموافقة لديك مربوطة بمعاملات GCM الصحيحة.
• يعرض Tag Assistant القيمة 'Unknown' — امسح ذاكرة Tag Assistant المؤقّتة وأعِد الربط.

إن عملت علامة من Google قبل حالة الموافقة الافتراضيّة، أو كانت علاماتك تستخدم بوابة علامات Google: بوابة علامات Google (GTG) وتوقيت الموافقة.

الطريقتان لتشغيل وضع الموافقة، وكيف تنتقل بينهما: وضع الموافقة: الأساسي أم المتقدّم.