- الإصدار 2.1 من إطار الشفافية والموافقة: سنواصل قبول سلاسل الإصدار 2.1 من إطار الشفافية والموافقة، ولكنّنا نشجِّع منصّات إدارة الموافقة (CMP) على اتّباع إرشادات مؤسسة IAB بشأن خطوات التنفيذ المهمّة في ما يتعلّق بانتقال الصناعة إلى استخدام الإصدار 2.2 من إطار الشفافية والموافقة.
- حلول إدارة الموافقات من Google: تخطِّط حلول إدارة الموافقات من Google لإتاحة الإصدار 2.2 من إطار الشفافية والموافقة مع رسائل طلب موافقة المستخدمين بموجب اللائحة العامة لحماية البيانات (GDPR) بحلول أوائل تشرين الثاني (نوفمبر)، وذلك تزامنًا مع الموعد النهائي الذي حدّدته مؤسسة IAB لتنفيذ منصّات إدارة الموافقة في 20 تشرين الثاني (نوفمبر) 2023. وتجدر الإشارة إلى أن حلول إدارة الموافقات من Google متاحة ضِمن علامة التبويب "الخصوصية والمراسلة" في "مدير إعلانات Google" وAdSense وAdMob.
وضع مكتب الإعلانات التفاعلية في أوروبا (IAB Europe) اللمسات الأخيرة على الإصدار 2.0 من إطار الشفافية والموافقة الذي تم تطويره في مختبر IAB التقني بالتعاون مع الشركات الأعضاء المشتركة. تدعم Google الآن الإصدار 2.0 من إطار الشفافية والموافقة بالكامل.
لمنح الناشرين الوقت الكافي لإدارة الأخطاء وعمليات الضبط الخاطئة المتعلقة بإطلاق الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية في أوروبا (IAB Europe)، ستوفر Google للناشرين تقريرًا بالأخطاء التي رصدناها وفترة سماح لمدة 150 يومًا يمكن خلالها تصحيح الأخطاء.
في هذه المقالة، ستتعرّف على مزيد من المعلومات عن كيفية معالجة أخطاء تنفيذ الإصدار 2.0 من إطار الشفافية والموافقة، بما في ذلك:
الإرشادات المعدَّلة
التعديلات
- تذكير بشأن متطلبات إطار الشفافية والموافقة لإعادة الحصول على الموافقة كل 13 شهرًا:
You are required by IAB TCF policy to remind users about their consent choices at least once every 13 months. If the consent decision is more than 13 months old, the TC string will no longer be considered valid by Google and Google will not serve ads to that user. We suggest that you work with your CMP to remind users about their consent choices before the 13-month limit is reached.
- تمت إزالة نوع الخطأ 3.2. ستظل سلاسل الشفافية والموافقة (TC) التي تم تعديلها في آخر 13 شهرًا صالحة.
طرق إصلاح الأخطاء الشائعة
يمكنك تحديد وحلّ بعض الأخطاء الأكثر شيوعًا في "مدير الإعلانات" وAdSense وAdMob باتّخاذ الإجراءات التالية:
يمكنك الحصول على موافقة المستخدِمين مرة أخرى باستخدام سلاسل الشفافية والموافقة (TC) التي لا يتم تحقيق الربح منها(الأخطاء 1.1 و3.1 و4.1 و5.1 و5.2 و6.1)
الأخطاء ذات الصلة
الإرشادات المعدَّلة
يمكنك طلب الموافقة من المستخدِمين مرة أخرى.
الأسباب
سيستفيد الناشرون من طلب الموافقة مرة أخرى إذا كان قد سبق أن استخدَموا سلاسل "خارج الإطار" أو "النطاق العالمي"، أو أرقام تعريف غير صالحة خاصة بمنصّة إدارة الموافقة (CMP) (من الاختبارات)، أو أرقام تعريف غير صالحة خاصة بقائمة المورّدين العالميين (GVL) (من الاختبارات)، أو لم تتم إضافة Google كمورّد مع الحصول على الموافقة المناسبة في أي وقت خلال عملية التنفيذ.
الأخطاء 1.1 و1.2 و1.3: من المهم التحقّق مما إذا كانت هذه الأخطاء تمثّل عددًا كبيرًا من الزيارات. في هذه الحالة، ضع في اعتبارك أنّه قد تكون هناك مشكلة في منصّة إدارة الموافقة (CMP) وتأكَّد من منح شركة Google الموافقة المطلوبة للأغراض اللازمة إلى جانب كونها مورّدًا للموافقة والمصلحة المشروعة (رقم تعريف المورّد 755).
مواصفات مكتب IAB
وفقًا لمواصفات مكتب IAB، يمكن أن تحتفظ منصّات إدارة الموافقة بسلاسل الموافقة في ذاكرة التخزين المؤقّت لمدة 13 شهرًا.
AddEventHandler في غضون 500 ملّي ثانية(الأخطاء 2.1a و2.1b و2.0a و2.0b و2.0c)
الأخطاء ذات الصلة
الخطأ 2.1a. يمكن تطبيق هذه الإرشادات أيضًا على الأخطاء 2.1b و2.0a و2.0b و2.0c.
الإرشادات المعدَّلة
على الرغم من عدم فرض متطلبات خاصّة بالمهلة الآن، ننصح منصّات إدارة الموافقة بمراجعة عمليات التنفيذ جيدًا من أجل التأكّد من الردّ فورًا على استدعاءات AddEventListener getTCData.
في حال عدم استجابة منصّة إدارة الموافقة، قد لا يتم تحقيق الربح من الطلب.
الأسباب
تتقيّد Google بمواصفات مكتب IAB التي تنص على ضرورة ردّ منصّة إدارة الموافقة فورًا على دالة AddEventListener. وفي حال عدم استجابة منصّة إدارة الموافقة على الفور، قد لا يتم تحقيق الربح من الطلب.
بالإضافة إلى ذلك، تكون استجابات منصّة إدارة الموافقة جزءًا من سلسلة الأحداث التي تؤثّر في مدى سرعة إجراء طلب الإعلان. ويؤدي تقليل الوقت الذي يفصل بين تحميل الصفحة وطلبات الإعلانات إلى الحد من مرات ظهور الإعلان التي يفقدها الناشر.
مواصفات مكتب IAB
مواصفات مكتب IAB السارية: مواصفات AddEventListener من IAB (على GitHub)
AddEventListener فورًا عند التسجيل باستخدام بيانات الشفافية والموافقة الحالية، حتى إذا كانت حالة منصّة إدارة الموافقة (CMP) قيد التحميل وكانت المنصّة تتضمّن بيانات شفافية وموافقة غير كاملة. يتيح ذلك للنص البرمجي للاستدعاء الوصول إلى listenerId المسجّل. بالإضافة إلى ذلك، يجب استدعاء هذه الدالة عند إجراء كل تغيير في سلسلة الشفافية والموافقة، ما لم تتم إزالتها باستخدام RemoveEventListener.تقرير الأخطاء
سنرسل إشعارًا إلى الناشرين في واجهة المستخدم ضمن المنتج إذا اكتشفنا مشكلة في سلسلة الشفافية والموافقة تتعلق بواحد أو أكثر من المواقع الإلكترونية أو التطبيقات التابعة لهم. يمكن للناشرين الذين لديهم أخطاء، على صفحة "موافقة المستخدم في الاتحاد الأوروبي" في حسابهم، النقر على تنزيل تقرير أخطاء إطار الشفافية والموافقة لتنزيل تقرير تفصيلي عن الأخطاء التي تم اكتشافها خلال آخر 7 أيام.
- مدير الإعلانات: انقر على المشرف
موافقة المستخدم في الاتحاد الأوروبي.
- AdMob وAdSense: انقر على عناصر التحكّم بحظر الإعلانات
سيحتوي التقرير على المعلومات التالية عن كل خطأ من الأخطاء المرصودة:
- النطاق/MobileAppID: الموقع الإلكتروني أو التطبيق للأجهزة الجوّالة الذي تم ضبطه بشكلٍ خاطئ.
- مسار الوحدة الإعلانية: الوحدة الإعلانية المرتبطة بالخطأ.
- رمز الخطأ: الرمز الذي تم تحديده للخطأ.
- عدد الأخطاء: عدد طلبات البحث التي تحتوي على الخطأ الذي تمت ملاحظته خلال الأسبوع السابق.
- تاريخ آخر رصد: تاريخ آخر اكتشاف للخطأ.
يمكن للناشرين استخدام رموز الخطأ الواردة في التقرير للعثور على الإجراءات المقترحة لتنفيذها في جداول تحديد المشاكل وحلّها التالية ولحل الأخطاء أيضًا.
تحديد المشاكل وحلّها
لمساعدة الناشرين على تصحيح عمليات دمج الإصدار 2.0 من إطار الشفافية والموافقة الصادرة عن مكتب IAB (أي IAB TCF v2.0) التي تم ضبطها بشكل خاطئ، أنشأنا الجداول التالية حول أنواع أخطاء سلسلة الشفافية والموافقة الأكثر شيوعًا، بالإضافة إلى الاقتراحات ذات الصلة لتحديد المشاكل وحلّها.
استخدِم الجداول لفهم المشاكل التي تحدث على مستوى طلبات الإعلان وكذلك سلوك النظام ذي الصلة.
سيناريوهات الموافقة المحدودة
يؤدي السيناريوهان 1.1 و1.3 دائمًا إلى تجاهل طلبات الإعلان بدون ملئها، في حين لن يؤدي السيناريو 1.2 إلى ذلك. تحظى دائمًا جميع هذه السيناريوهات الثلاثة بالأولوية على أخطاء الضبط الخاطئ، حتى إذا كانت هناك أخطاء متعددة في طلب معيّن.
| السيناريو | الوصف | الإجراء المقترح اتخاذه |
|---|---|---|
| 1.1 | غير مسموح لشركة Google، بصفتها مورِّدًا، بموجب الموافقة أو المصلحة المشروعة. يتم تجاهل طلبات الإعلان بدون ملئها. | تأكَّد ما إذا كان المستخدم قد رفض Google عمدًا كمُورِّد، أو أنّ هناك أخطاء حدثت في تنفيذ منصّة إدارة الموافقات، أو أنّ هناك قيودًا مفروضة على الناشرين. |
| 1.2 | ما مِن موافقة على الغرض 1 لبلدان المنطقة الاقتصادية الأوروبية والمملكة المتحدة. |
تأكَّد ما إذا كان المستخدم قد حظر عمدًا الغرض 1 أو إذا كان السبب يعود إلى أخطاء تنفيذ في منصّة إدارة الموافقة. يجب أن يتأكّد الناشرون في سويسرا من إعداد الحقلين
PublisherCC وPurposeOneTreatment بشكل صحيح إذا كانوا لا يطلبون الموافقة من المستخدمين. بدءًا من كانون الأول (ديسمبر) 2021، سنتوقّف عن التعامل مع |
| 1.3 | تتوفر موافقة للغرض 1، ولكنها تفتقد الأسس القانونية للإعلانات الأساسية. يتم تجاهل طلبات الإعلان بدون ملئها. |
تأكَّد ما إذا كان المستخدم قد رفض عمدًا المصالح المشروعة في الأغراض الأخرى أو إذا السبب يعود إلى أخطاء في تنفيذ منصّة إدارة الموافقات. |
الضبط الخاطئ
لن تتم تعبئة طلبات الإعلان أثناء حدوث أخطاء في الضبط.
| الخطأ | الوصف | الإجراء المقترح اتخاذه |
|---|---|---|
| 2.1a | لا تتلقّى العلامة أو حزمة تطوير البرامج (SDK) أيًا من سلاسل الموافقة والشفافية، وذلك لأنّ حالة منصّة إدارة الموافقة هي stub أو loading أو error. |
إذا كنت توجّه الدالة يدويًا لطلب الإعلانات، تأكَّد من الردّ على إذا لم تستدعِ هذه الدالة لطلب الإعلانات يدويًا، ننصحك بالتعاون مع منصّة إدارة الموافقة (CMP) للتأكّد من أنّها تنفّذ دعم |
| 2.1b |
تحقّق كلا الشرطين التاليين:
|
اطلب من منصّة إدارة الموافقة التأكّد من تنفيذ واجهات برمجة التطبيقات كما يلزم استنادًا إلى المواصفات الفنّية التي تخصّ إطار الشفافية والموافقة الصادر عن مكتب IAB. |
| 2.0a |
لا يمكن تحليل سلسلة الموافقة والشفافية لأنّها ليست بترميز base64. مثال: |
على منصّات إدارة الموافقة (أو الناشرين) إرسال بيانات بترميز base64 فقط في مَعلمات gdpr_consent=. |
| 2.0b |
لا يمكن تحليل سلسلة الموافقة والشفافية بسبب خطأ في فكّ الترميز. مثال: تتضمن عددًا غير صحيح من وحدات البت |
يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة والشفافية. |
| 2.0c |
لا يمكن تحليل سلسلة الموافقة والشفافية بسبب خطأ في البيانات. مثال: الطابع الزمني غير صحيح، رقم تعريف المُورِّد طويل للغاية |
يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة والشفافية. |
مشاكل سلسلة الموافقة والشفافية
مشاكل سلسلة الموافقة والشفافية المرتبطة بطلب الإعلان. سيتم تجاهل طلبات الإعلان ولن يتم ملؤها.
| الخطأ | الوصف | الإجراء المقترح اتخاذه |
|---|---|---|
| 3.1 | رقم تعريف منصّة إدارة الموافقة غير صالح |
تأكَّد من استخدام منصّة إدارة موافقة معتمَدة من مكتب IAB، ومن ضبط رقم تعريفها بشكل صحيح في سلاسل الموافقة والشفافية. إذا كانت منصّة إدارة الموافقة صالحة عند إنشاء سلسلة الموافقة والشفافية، ولكن حذفها لاحقًا مكتب IAB، عليك الحصول على الموافقة مرّة أخرى باستخدام منصّة إدارة موافقة صالحة. |
| 3.2 | لم تعد مستخدمة. | ما مِن إجراءات مقترَحة. المعنى السابق: كان تاريخ إنشاء سلسلة الموافقة والشفافية قبل أكثر من 13 شهرًا. |
يجب الحصول على الموافقة مرة أخرى
يجب الحصول على موافقة من المستخدم. في حال حصلت على موافقة من مستخدم قبل أكثر من 13 شهرًا أو كنت تستخدم نسخة من "قائمة المورّدين العالميين" (GVL) لم يتم إدراج Google فيها بعد، عليك الحصول على موافقة المستخدم مرة أخرى، وإلّا سيتم تجاهل طلبات الإعلان ولن يتم ملؤها.
| الخطأ | الوصف | الإجراء المقترَح |
|---|---|---|
| 3.3 | يعود تاريخ إجراء آخر تعديل على سلسلة الموافقة والشفافية إلى أكثر من 13 شهرًا. |
على منصّة إدارة الموافقة أن تحذف سلسلة الموافقة والشفافية القديمة وتحصل على الموافقة مرّة أخرى. من المتوقَّع حدوث عدد صغير من هذه الأخطاء إذا تم إرسال طلبات الإعلانات باستخدام سلسلة الموافقة والشفافية المنتهية الصلاحية قبل أن تنهي منصّة إدارة الموافقة صلاحية موافقة المستخدِم وتحصل عليها مرة أخرى. إذا كنت تستخدِم حلول إدارة الموافقات من Google، يمكنك الاطّلاع على خطوات تحديد المشاكل وحلّها في التطبيقات، وذلك من أجل تصحيح الأخطاء 3.3. بالنسبة إلى ناشري AdSense الذين يستخدمون حلول إدارة الموافقات من Google، ليس عليهم اتّخاذ أيّ إجراء بشأن الأخطاء 3.3. |
| 4.1 | تمّ إنشاء سلسلة الموافقة والشفافية باستخدام نسخة من قائمة المورّدين العالميين لم يتمّ إدراج Google فيها إلى الآن. | يمكنك الحصول على الموافقة مرة أخرى باستخدام نسخة حالية من "قائمة المورّدين العالميين". |
النطاق العالمي والنطاق "خارج الإطار"
المشاكل المتعلقة بالنطاق العالمي والنطاق "خارج الإطار" (مدير الإعلانات وAdMob وAdSense). لن يتم عرض الإعلانات إذا كانت سلسلة الشفافية والموافقة تشير إلى "خارج الإطار" أو "النطاق العالمي".
| الخطأ | الوصف | الإجراء المقترَح |
|---|---|---|
| 5.1 | سماح سلسلة الموافقة والشفافية بالموافقة خارج الإطار | يجب أن توجّه منصّة إدارة الموافقة الخاصة بك لإزالة الإشارات "خارج الإطار" من سلاسل الشفافية والموافقة. |
| 5.2 | سلسلة الموافقة والشفافية ذات النطاق العالمي | عليك توجيه منصّة إدارة الموافقة لتعديل سلاسل الموافقة والشفافية من أجل أن تصبح مخصّصة للخدمة. |
استمرار عرض الإعلانات
سيستمر عرض الإعلانات المخصّصة وغير المخصّصة باستخدام الإعدادات الحالية بدون التأثير على تحقيق الربح (المادي).
| الخطأ | الوصف | الإجراء المقترَح |
|---|---|---|
| 6.1 | إصدار سلسلة الموافقة والشفافية بالقيمة 1 أو 1.1 (سلسلة من الإصدار 1.0). |
يجب أن ترسل منصّة إدارة الموافقة سلاسل الإصدار 2.0 من إطار الشفافية والموافقة. |
ستعالج Google المشاكل
عند حدوث هذه المشاكل، ستسعى Google لتخفيف المشكلة بنفسها عند الضرورة ومتابعة المعالجة العادية لإطار الشفافية والموافقة.
| الخطأ | الوصف | الإجراء المقترَح |
|---|---|---|
| 7.1 | المعلمة gdprApplies غير معرّفة أو مضبوطة على قيمة غير صالحة أو لا يمكن فك ترميزها، ولكن تتوفر سلسلة شفافية وموافقة صالحة. |
غير متاح |
| 7.2 | تمّ إنشاء سلسلة الموافقة والشفافية باستخدام نسخة من قائمة مورّدين عالميين أحدث من النسخة الحالية التي تتوافق معها تكنولوجيا عرض الإعلانات من Google. | غير متاح |
| 7.3 | بعض الأغراض و/أو الميزات و/أو المُورِّدين خارج النطاق (غير معروفة). | غير متاح |
| 7.4 | تتضمّن سلسلة الشفافية والموافقة رمز نسخة tcf_policy_version أقدم من أحدث نسخة من "قائمة المورّدين العالميين" (GVL). |
على منصّة إدارة الموافقة أن تحذف سلسلة الشفافية والموافقة وتحصل على الموافقة مرة أخرى باستخدام أحدث نسخة من "قائمة المورّدين العالميين" (GVL). |
| 7.5 |
يحتوي الطلب على المعلمة |
غير متاح |
| 7.6 | رمز بلد الناشر غير صالح، ولكن الموافقة على الغرض 1 متوفرة. | يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة والشفافية. |
| 7.7 | رمز اللغة غير صالح. | سيتم عرض إعلانات محدودة فقط. يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة والشفافية. |
| 7.8 | حقل إصدار سلسلة الشفافية والموافقة ليس بالقيمة 1 أو 2. |
سيتم عرض إعلانات محدودة فقط. يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة والشفافية. |
| 7.9 | إصدار سلسلة الموافقة الإضافية (AC) ليس بالقيمة 1 |
يجب أن تضبط منصّة إدارة الموافقة إصدار سلسلة الموافقة الإضافية على القيمة 1. |
مشاكل سلسلة الموافقة الإضافية
عند حدوث هذه المشاكل، ستتعامل Google مع سلسلة الموافقة الإضافية على أنّها غير صالحة ولن يتمّ التعامل مع أيّ مورّدين إضافيين خارج سلسلة الموافقة والشفافية.
| الخطأ | الوصف | الإجراء المقترَح |
|---|---|---|
| 8.1 | سلسلة الموافقة الإضافية لا تستخدِم فاصل الإصدار (~). |
يجب أن تستخدم منصة إدارة الموافقة "~" باعتباره الحرف الثاني من سلسلة الموافقة الإضافية لفصل رقم الإصدار عن قائمة المورّدين المعتمدين. |
| 8.2 | تحتوي سلسلة الموافقة الإضافية على قائمة مورّدين لا تتبع التنسيق المتوقع (قائمة int64s مفصولة بفواصل ' . ') | يجب أن تتولّى منصّة إدارة الموافقة تصحيح أخطاء تطبيق سلسلة الموافقة الإضافية. |