أخطاء سلسلة الموافقة التي تقتل إيرادات إعلاناتك بصمت
تسرّب الإيرادات الصامت
عندما ينحدر eCPM لديك بضع نقاط مئوية كل شهر، نادرًا ما يكون السبب المخزون أو الأسعار الدنيا. في الغالب يكون السبب TC string معطوبة — إشارة IAB Transparency & Consent Framework (TCF) التي تسافر مع كل طلب إعلان. السلسلة المشوّهة أو المفقودة لا ترمي خطأً صاخبًا. بدلًا من ذلك، يعود خادم الإعلانات بهدوء إلى إعلانات غير مخصّصة، وينسحب شركاء الطلب، وتنزف الإيرادات دون أي تنبيه واحد. بالنسبة لناشري التطبيقات والألعاب الذين يحقّقون أرباحًا في المنطقة الاقتصادية الأوروبية والمملكة المتحدة، إنه أكثر الأسباب التي يُتغافل عنها لفقدان الدخل.
ماذا تحمل TC String فعليًا
TC string هي كتلة مشفّرة بـ base64 ينشئها Consent Management Platform (CMP) الخاص بك. تشفّر خيارات المستخدم: الأغراض الموافَق عليها، البائعون المسموح لهم، معرّف CMP الخاص بك، إصدار السياسة، وطابع زمني. يفكّ المشترون شفرتها في أجزاء من الثانية ليقرروا ما إذا كان بإمكانهم المزايدة باستهداف مخصّص. هناك إشارتان لا تقلان أهمية:
gdprApplies— علم (1 أو 0 أو undefined) يخبر المشترين بما إذا كان GDPR ضمن النطاق.- Google Consent Mode v2 — إشارات
ad_storageوad_user_dataوad_personalizationالتي يقرأها Google بشكل مستقل عن سلسلة TCF.
إذا كانت أيٌّ من هذه خاطئة، يتبخّر الطلب — حتى عندما يكون المستخدم قد وافق فعلًا.
الأخطاء الخمسة التي تكلّفك المال بصمت
1. سلسلة مفقودة أو منتهية الصلاحية. إذا لم يكتب CMP سلسلة أبدًا، أو إذا تقادمت الموافقة المخزّنة مؤقتًا بعد نافذة إعادة المطالبة لديك، تخرج الطلبات دون إشارة. يعامل المشترون "لا سلسلة" كـ "لا موافقة" ويزايدون فقط بطلب سياقي منخفض eCPM، أو يتخطّون المزاد.
2. معرّف CMP خاطئ. كل CMP معتمد لديه معرّف مسجّل مدمج في السلسلة. إذا كُتب معرّف غير معروف، يرفضه Google وبائعو IAB — وهذا شائع بعد عملية ترحيل مع بقاء SDK القديم مدمجًا.
3. بائع غير معلَن. قد يملك شريك الطلب موافقة كاملة، لكن إذا لم يكن معرّف البائع الخاص به في قائمة البائعين المسموح بهم، فلا يمكنه المزايدة بشكل مخصّص. كثيرًا ما ينسى الناشرون تحديث القائمة بعد إضافة شريك.
4. gdprApplies مشوّه. تمرير سلسلة "1" بدلًا من عدد صحيح، أو تركها undefined لمستخدم في المنطقة الاقتصادية الأوروبية بوضوح، يربك المشترين. يمكن أيضًا أن يعرّضك gdprApplies=0 الخاطئ لمخاطر الامتثال بينما يبدو سليمًا.
5. عدم إطلاق إشارات Consent Mode. قد تكون سلسلة TCF مثالية بينما يبقى Consent Mode في حالته الافتراضية المرفوضة — على سبيل المثال، عندما يحمّل SDK الإعلانات قبل حسم الموافقة. عندئذٍ يقدّم Google إعلانات غير مخصّصة بصرف النظر عن TC string.
سير عمل لتصحيح الأخطاء خطوة بخطوة
اعمل من الجهاز للخارج نحو خادم الإعلانات، وأعد الإنتاج في حالة نظيفة — امسح بيانات التطبيق أو استخدم ملف متصفح جديدًا كي لا تضلّلك الموافقة القديمة.
- الخطوة 1 — التقط السلسلة الخام. على الويب، اقرأها عبر
__tcfapi('getTCData', 2, cb). في التطبيق، استخرج مفتاحIABTCF_TCStringمنSharedPreferences(Android) أوNSUserDefaults(iOS). - الخطوة 2 — فك التشفير وتحقّق. الصقها في فاكّ تشفير IAB TCF أو مُحقِّق CMP. أكّد أن معرّف CMP هو لك، وأن إصدار السياسة والطابع الزمني حديثان، وأن معرّفات البائعين الرئيسية لديك تظهر في القائمة.
- الخطوة 3 — افحص طلب الإعلان. استخدم Charles Proxy أو مفتّش شبكة لمراقبة طلب GAM، وتحقّق من أن المعاملين
gdprوgdpr_consentيحملان القيم الصحيحة. - الخطوة 4 — تحقّق من Consent Mode. استخدم Google Tag Assistant لتأكيد أن
ad_user_dataوad_personalizationينقلبان إلى granted عندما يوافق المستخدم. - الخطوة 5 — أكّد في GAM. افتح بُعد إعداد التقارير الإعلانات غير المخصّصة في Ad Manager. إن ارتفاعًا في حركة NPA لا يطابق معدل الانسحاب لديك هو بصمة سلسلة سيئة.
إصلاح السبب الجذري
ترقيع طلب سيئ واحد سهل؛ منع الطلب التالي هو العمل الحقيقي. اجعل الإعلانات تنتظر الموافقة قبل التهيئة، وأبقِ قائمة البائعين لديك متزامنة مع مكدّس الطلب، وتتبّع نسبة الانطباعات المخصّصة إلى غير المخصّصة — التحوّل هناك هو تحذيرك الأبكر.
هنا يثبت CMP المعتمد من Google جدارته. يصدِر FlexyConsent سلاسل IAB TCF 2.3 صالحة بمعرّف CMP صحيح وإعلانات البائعين، ويطلق إشارات Consent Mode v2 بحيث يتتبّع ad_user_data و ad_personalization خيار المستخدم، ويُظهر تحليلات معدل الموافقة عبر الويب و Android و iOS — بحيث تظهر السلسلة المعطوبة على لوحة معلومات، لا في مدفوعاتك.
أبرز النقاط
- السلسلة TC السيئة لا تتعطّل — بل تخفّض رتبتك بصمت إلى إعلانات غير مخصّصة و eCPM أقل.
- خمسة جناة: سلاسل مفقودة/منتهية الصلاحية، معرّف CMP خاطئ، بائعون غير معلَنين،
gdprAppliesمشوّه، وإشارات Consent Mode ميتة. - صحّح الأخطاء من الجهاز إلى خادم الإعلانات: التقط، فك التشفير، افحص الطلب، تحقّق من Consent Mode، تحقّق من GAM.
- تتبّع نسبتك المخصّصة-إلى-NPA باستمرار — CMP معتمد مثل FlexyConsent يجعل السلاسل الصالحة وإشارات Consent Mode v2 الصحيحة هي الإعداد الافتراضي.