تحديد المشاكل وحلّها في ما يتعلّق بتنفيذ الإصدار 2.2 من إطار الشفافية والموافقة الصادر عن مكتب IAB في الاتحاد لأوروبي

تقبل Google الآن، بصفتها مورِّدًا، سلاسل الموافقة والشفافية باستخدام الإصدار 2.2 من إطار الشفافية والموافقة الصادر عن مكتب IAB في الاتّحاد الأوروبّي.

• الإصدار 2.1 من إطار الشفافية والموافقة: سنواصل قبول سلاسل الإصدار 2.1 من إطار الشفافية والموافقة، ولكنّنا نشجِّع منصّات إدارة الموافقة (CMP) على اتّباع إرشادات مكتب IAB بشأن خطوات التنفيذ المهمّة مع الانتقال إلى استخدام الإصدار 2.2 من إطار الشفافية والموافقة على مستوى المجال.
• حلول إدارة الموافقات في Google: تتوافق حلول إدارة الموافقات في Google المتوفّرة في علامة التبويب "الخصوصية والمراسلة" في "مدير إعلانات Google" وAdSense وAdMob مع الإصدار 2.2 من إطار الشفافية والموافقة الذي يخصّ رسائل اللوائح التنظيمية الأوروبّية، وذلك بما يتماشى مع متطلّبات مكتب IAB المعدَّلة لمنصّات إدارة الموافقة.

لمساعدة الناشرين في إدارة الأخطاء وعمليات الضبط الخاطئة المتعلّقة بإطلاق الإصدار 2.2 من إطار الشفافية والموافقة الصادر عن مكتب IAB في أوروبّا، نقدّم تقريرًا بالأخطاء التي رصدناها.

---

في هذه المقالة، ستتعرّف على مزيد من المعلومات عن كيفية معالجة أخطاء تنفيذ الإصدار 2.2 من إطار الشفافية والموافقة، بما في ذلك:

• الإرشادات المعدَّلة
• مركز السياسات
• تقرير الأخطاء
• تحديد المشاكل وحلّها

---

الإرشادات المعدَّلة

طرق إصلاح الأخطاء الشائعة

يمكنك تحديد وحلّ بعض الأخطاء الأكثر شيوعًا في "مدير الإعلانات" وAdSense وAdMob باتّخاذ الإجراءات التالية:

يمكنك الحصول على موافقة المستخدِمين مرة أخرى باستخدام سلاسل الشفافية والموافقة التي لا يتم تحقيق الربح منها
^{(الأخطاء 1.1 و3.1 و4.1 و5.1 و5.2 و6.1)}

الأخطاء ذات الصلة

الخطأ 1.1. يمكن تطبيق هذه الإرشادات أيضًا على الأخطاء 3.1 و4.1 و5.1 و5.2 و6.1.

الإرشادات المعدَّلة

يمكنك طلب الموافقة من المستخدِمين مرة أخرى.

الأسباب

سيستفيد الناشرون من طلب الموافقة مرّة أخرى إذا كان قد سبق أن استخدَموا سلاسل خارج الإطار أو ذات نطاق عالمي، أو كانت أرقام تعريف منصّة إدارة الموافقة غير صالحة (من الاختبارات)، أو كانت أرقام تعريف قائمة المورّدين العالميين (GVL) غير صالحة (من الاختبارات)، أو لم تتمّ إضافة Google كمُورِّد حاصل على الموافقة المناسبة في مرحلة معيّنة خلال عملية التطبيق.

الأخطاء 1.1 و1.2 و1.3: من المهمّ التحقّق ممّا إذا كانت هذه الأخطاء تمثّل عددًا كبيرًا من الزيارات أم لا. في هذه الحالة، قد تكون هناك مشكلة في منصّة إدارة الموافقة، وعليك التأكُّد من منح 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 فورًا عند التسجيل باستخدام بيانات الموافقة والشفافية الحالية، حتى إذا كانت حالة منصّة إدارة الموافقة loading وكانت المنصّة تتضمّن بيانات موافقة وشفافية غير كاملة. يتيح ذلك للنصّ البرمجي للطلب الوصول إلى مَعلمة listenerId المسجّلة. بالإضافة إلى ذلك، يجب طلب هذه الدالّة عند إجراء كلّ تغيير في سلسلة الموافقة والشفافية، ما لم تتمّ إزالة هذه الدالة باستخدام RemoveEventListener.

مركز السياسات

يُبلِغ مركز السياسات الناشرين في حال عدم التزام تطبيق أو موقع إلكتروني بمتطلّبات إدارة الموافقة في Google.

تقرير الأخطاء

سنرسل إشعارًا إلى الناشرين في واجهة مستخدم المنتج إذا اكتشفنا مشكلة في سلسلة الموافقة والشفافية تتعلّق بواحد أو أكثر من المواقع الإلكترونية أو التطبيقات التابعة لهم. من صفحة "موافقة المستخدم في الاتّحاد الأوروبّي" في الحساب، يمكن للناشرين الذين لديهم أخطاء النقر على تنزيل تقرير أخطاء إطار الشفافية والموافقة لتنزيل تقرير تفصيلي عن الأخطاء التي تمّ اكتشافها خلال آخر 7 أيّام.

ملاحظة: لا يتوفّر هذا التقرير إلّا في حال اكتشاف أخطاء خلال آخر 7 أيّام.

للوصول إلى صفحة "موافقة المستخدم في الاتّحاد الأوروبّي" وتقرير "أخطاء إطار الشفافية والموافقة": 

• في مدير إعلانات Google: انقر على المشرف، ثمّ موافقة المستخدم في الاتّحاد الأوروبّي.
• في AdMob وAdSense: انقر على عناصر التحكُّم بحظر الإعلانات ثمّ موافقة المستخدم في الاتّحاد الأوروبّي.

سيحتوي التقرير على المعلومات التالية عن كلّ خطأ من الأخطاء المرصودة: 

• النطاق/MobileAppID: الموقع الإلكتروني أو تطبيق الأجهزة الجوّالة الذي تمّ ضبطه بشكلٍ غير صحيح
• مسار الوحدة الإعلانية: الوحدة الإعلانية المرتبطة بالخطأ.
• رمز الخطأ: الرمز الذي تم تحديده للخطأ. 
• عدد الأخطاء: عدد طلبات البحث التي تحتوي على الخطأ الذي تمت ملاحظته خلال الأسبوع السابق.
• تاريخ آخر رصد: تاريخ آخر اكتشاف للخطأ. 

يمكن للناشرين استخدام رموز الخطأ الواردة في التقرير للعثور على الإجراءات المقترحة لتنفيذها في جداول تحديد المشاكل وحلّها التالية ولحل الأخطاء أيضًا.

تحديد المشاكل وحلّها

لمساعدة الناشرين في تصحيح عمليات دمج الإصدار 2.2 من إطار الشفافية والموافقة الصادر عن مكتب IAB التي تمّ ضبطها بشكل غير صحيح، أنشأنا الجداول التالية عن أنواع أخطاء سلسلة الموافقة والشفافية الأكثر شيوعًا، بالإضافة إلى الاقتراحات ذات الصلة لتحديد المشاكل وحلّها.

استخدِم الجداول لفهم المشاكل التي تحدث على مستوى طلبات الإعلان وكذلك سلوك النظام ذي الصلة.

سيناريوهات الموافقة المحدودة

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

السيناريو	الوصف	الإجراء المقترح اتخاذه
1.1	غير مسموح لشركة Google، كمورِّد، بموجب الموافقة أو المصلحة المشروعة.	تأكَّد ممّا إذا كان المستخدم قد رفض Google عمدًا كمُورِّد، أو أنّ هناك أخطاءً تخصّ التطبيق في منصّة إدارة الموافقة، أو أنّ هناك قيودًا مفروضة على الناشرين.
1.2	ما مِن موافقة على الغرض 1 لبلدان المنطقة الاقتصادية الأوروبية والمملكة المتحدة وسويسرا.	تأكَّد ممّا إذا كان المستخدم قد حظر عمدًا الغرض 1 أو إذا كان السبب يعود إلى أخطاء في استخدام منصّة إدارة الموافقة. يجب أن يتأكّد الناشرون في سويسرا من إعداد الحقلين PublisherCC وPurposeOneTreatment بشكل صحيح إذا كانوا لا يطلبون الموافقة من المستخدمين.    بدءًا من كانون الأول (ديسمبر) 2021، سنتوقّف عن التعامل مع PurposeOneTreatment في طلبات الإعلانات التي تنشأ في ألمانيا بما يتوافق مع قانون حماية بيانات الاتصالات السلكية واللاسلكية ووسائط الإعلام الألمانية.
1.3	تتوفر موافقة للغرض 1، ولكنها تفتقد الأسس القانونية للإعلانات الأساسية.	تأكَّد ممّا إذا كان المستخدم قد رفض عمدًا المصالح المشروعة في الأغراض الأخرى أو إذا كان السبب يعود إلى أخطاء في تنفيذ منصّة إدارة الموافقة.

الإعدادات الخاطئة

عند حدوث هذه المشاكل، ستحاول Google عرض إعلانات محدودة.

الخطأ	الوصف	الإجراء المقترح اتخاذه
2.1a	لا تتلقّى العلامة أو حزمة تطوير البرامج (SDK) أيًّا من سلاسل الموافقة والشفافية، وذلك لأنّ حالة منصّة إدارة الموافقة هي stub أو loading أو error.	إذا كنت تستدعي الدالّة يدويًا لطلب الإعلانات، تأكَّد من الردّ على getTCData TCData.eventStatus = 'tcloaded'‎ أو 'cmpuishown' + 'useractioncomplete'. ويشير ذلك إلى أنّ منصّة إدارة الموافقة مستعدّة لمنح المستخدم حرّية الاختيار في ما يتعلّق بمنح الموافقة. إذا لم تستدعِ هذه الدالّة لطلب الإعلانات يدويًا، ننصحك بالتعاون مع منصّة إدارة الموافقة للتأكُّد من أنّها تطبّق عملية توفير getTCData وتعرض TCData.eventStatus = 'tcloaded' أو 'cmpuishown' + 'useractioncomplete' للإشارة إلى أنّ موافقة المستخدم جاهزة للاستخدام من خلال واجهة برمجة التطبيقات.
2.1b	تحقّق كلا الشرطين التاليين: إعداد منصّة إدارة الموافقة على ‎&gdpr=1 المَعلمة ‎&gdpr_consent=‎ مُدرجة في الطلب، ولكن سلسلة الموافقة والشفافية فارغة.	اطلب من منصّة إدارة الموافقة التأكّد من تنفيذ واجهات برمجة التطبيقات (API) التابعة لها كما يلزم استنادًا إلى المواصفات الفنية الخاصة بإطار الشفافية والموافقة الصادرة عن مكتب IAB.
2.2a	لا يمكن تحليل سلسلة الشفافية والموافقة لأنها ليست بترميز base64. مثال: "2"	على منصّات إدارة الموافقة (أو الناشرين) إرسال بيانات بترميز base64 فقط في معلمات gdpr_consent=.
2.2b	لا يمكن تحليل سلسلة الموافقة والشفافية بسبب خطأ في فكّ الترميز. مثال: تتضمّن عددًا غير صحيح من وحدات البت	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة والشفافية.
2.2c	لا يمكن تحليل سلسلة الموافقة والشفافية بسبب خطأ في البيانات. مثال: الطابع الزمني غير صحيح، رقم تعريف المُورِّد طويل للغاية	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة والشفافية.

المشاكل في سلسلة الموافقة والشفافية

في ما يلي مشاكل سلسلة الموافقة والشفافية المرتبطة بطلب عرض الإعلان. عند حدوث هذه المشاكل، ستحاول Google عرض إعلانات محدودة.

الخطأ	الوصف	الإجراء المقترح اتخاذه
3.1	رقم تعريف منصّة إدارة الموافقة غير صالح	تأكَّد من استخدام منصّة إدارة موافقة معتمَدة من مكتب IAB، ومن ضبط رقم تعريفها بشكل صحيح في سلاسل الموافقة والشفافية. إذا كانت منصّة إدارة الموافقة صالحة عند إنشاء سلسلة الموافقة والشفافية، ولكن حذفها لاحقًا مكتب IAB، عليك الحصول على الموافقة مرّة أخرى باستخدام منصّة إدارة موافقة صالحة.
3.2	لم تعد مستخدمة.	ما مِن إجراءات مقترَحة. المعنى السابق: كان تاريخ إنشاء سلسلة الموافقة والشفافية قبل أكثر من 13 شهرًا.

يجب الحصول على الموافقة مرّة أخرى.

يجب الحصول على موافقة من المستخدم. في حال استخدام نسخة من "قائمة المورّدين العالميين" لم يتم إدراج Google فيها بعد، عليك الحصول على موافقة المستخدم مرّة أخرى، وإلّا ستحاول Google عرض إعلانات محدودة.

الخطأ	الوصف	الإجراء المقترح اتخاذه
3.3	لم تعد مستخدمة.	ما مِن إجراءات مقترَحة. المعنى السابق: يعود تاريخ إجراء آخر تعديل على سلسلة الموافقة والشفافية إلى أكثر من 13 شهرًا.
4.1	تمّ إنشاء سلسلة الموافقة والشفافية باستخدام نسخة من قائمة المورّدين العالميين لم يتمّ إدراج Google فيها إلى الآن.	يمكنك الحصول على الموافقة مرّة أخرى باستخدام نسخة حالية من قائمة المورّدين العالميين.

النطاق العالمي والنطاق خارج الإطار

في ما يلي المشاكل المتعلّقة بالنطاق العالمي والنطاق خارج الإطار (إدارة إعلانات Google وAdMob وAdSense). عند حدوث هذه المشاكل، ستحاول Google عرض إعلانات محدودة.

الخطأ	الوصف	الإجراء المُقترَح
5.1	سماح سلسلة الموافقة والشفافية بالموافقة خارج الإطار	يجب ضبط منصّة إدارة الموافقة لإزالة الإشارات خارج الإطار من سلاسل الموافقة والشفافية.
5.2	سلسلة الموافقة والشفافية ذات النطاق العالمي	يجب ضبط منصّة إدارة الموافقة لتعديل سلاسل الموافقة والشفافية كي تصبح مخصّصة للخدمات.

عرض الإعلانات محدود

سيتمّ عرض الإعلانات المحدودة.

الخطأ	الوصف	الإجراء المُقترَح
6.1	نسخة سلسلة الموافقة والشفافية بالقيمة 1 أو 1.1 (سلسلة من النسخة 1.0).	يجب أن ترسل منصّة إدارة الموافقة سلاسل النسخة 2.2 من إطار الشفافية والموافقة.

ستعالج Google المشاكل

عند حدوث هذه المشاكل، ستسعى Google لتخفيف المشكلة بنفسها عند الضرورة ومتابعة المعالجة العادية لإطار الشفافية والموافقة.

الخطأ	الوصف	الإجراء المُقترَح
7.1	المعلمة gdprApplies غير معرّفة أو مضبوطة على قيمة غير صالحة أو لا يمكن فك ترميزها، ولكن تتوفر سلسلة شفافية وموافقة صالحة.	ما من إجراء مقترح
7.2	تمّ إنشاء سلسلة الموافقة والشفافية باستخدام نسخة من قائمة المورّدين العالميين أحدث من النسخة الحالية التي تتوافق معها تكنولوجيا عرض الإعلانات من Google.	ما من إجراء مقترح
7.3	بعض الأغراض و/أو الميزات و/أو المُورِّدين خارج النطاق (غير معروفة).	ما من إجراء مقترح
7.4	تتضمّن سلسلة الموافقة والشفافية رمز tcf_policy_version أقدم من أحدث نسخة من قائمة المورّدين العالميين.	على منصّة إدارة الموافقة أن تحذف سلسلة الموافقة والشفافية الأقدم وتحصل على الموافقة مرّة أخرى باستخدام أحدث نسخة من قائمة المورّدين العالميين.
7.5	يحتوي طلب على المَعلمة &gdpr=1، ولكنّه لا يحتوي مطلقًا على المَعلمة &gdpr_consent في عنوان URL الخاصّ بالطلب.	ما من إجراء مقترح
7.6	رمز بلد الناشر غير صالح، ولكن الموافقة على الغرض 1 متوفرة.	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة والشفافية.
7.7	رمز اللغة غير صالح.	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة والشفافية.
7.8	حقل إصدار سلسلة الشفافية والموافقة ليس بالقيمة 1 أو 2.	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة والشفافية من خلال طلب موافقة جديدة إذا تمّ رصد سلسلة موافقة وشفافية غير صالحة. إذا كنت تستخدِم حلول إدارة الموافقات من Google، يمكنك الاطّلاع على خطوات تحديد المشاكل وحلّها في التطبيقات، وذلك من أجل تصحيح هذا النوع من الأخطاء. بالنسبة إلى ناشري AdSense الذين يستخدمون حلول إدارة الموافقات من Google، ليس عليهم اتّخاذ أيّ إجراء بشأن هذا النوع من الأخطاء.
7.9	قيمة نسخة سلسلة الموافقة الإضافية لا تساوي 1 أو 2.	يجب أن تضبط منصّة إدارة الموافقة نسخة سلسلة الموافقة الإضافية على القيمة 1 أو 2.

مشاكل سلسلة الموافقة الإضافية

عند حدوث هذه المشاكل، ستتعامل Google مع سلسلة الموافقة الإضافية على أنّها غير صالحة ولن يتمّ التعامل مع أيّ مورّدين إضافيين خارج سلسلة الموافقة والشفافية.

الخطأ	الوصف	الإجراء المُقترَح
8.1	سلسلة الموافقة الإضافية لا تستخدِم فاصل النسخة (~).	يجب أن تستخدم منصّة إدارة الموافقة الفاصل "~" على أنّه الحرف الثاني من سلسلة الموافقة الإضافية لفصل رقم النسخة عن قائمة المورّدين الذين تمّت الموافقة عليهم.
8.2	تحتوي سلسلة الموافقة الإضافية على قائمة مورّدين لا تتبع التنسيق المتوقّع (قائمة int64s مفصولة بـ ".")	يجب أن تتولّى منصّة إدارة الموافقة تصحيح الأخطاء في عملية تطبيق سلسلة الموافقة الإضافية.

شهادة اعتماد منصّة إدارة الموافقة

عند حدوث هذه المشاكل، ستحاول Google عرض إعلانات غير مخصّصة.

الخطأ	الوصف	الإجراء المُقترَح
9.1	منصّة إدارة الموافقة المتوافقة مع إطار الشفافية والموافقة والمضمّنة في الطلب غير معتمَدة من Google.	يجب اعتماد منصّة إدارة الموافقة من Google.

لا تتضمّن طلبات الإعلانات إشارات إطار الشفافية والموافقة

عند حدوث هذه المشاكل، ستحاول Google عرض إعلانات محدودة.

الخطأ	الوصف	الإجراء المُقترَح
10.1	الطلب وارد من المنطقة الاقتصادية الأوروبية أو المملكة المتحدة أو سويسرا، أو تمّت إضافة علامة إليه يدويًا لفرض "اللائحة العامة لحماية البيانات" (GDPR) من خلال المَعلمة gdpr=1، ولكنّ الطلب لا يتضمّن إشارات إطار الشفافية والموافقة.	على الناشر إجراء تكامل مع منصّة لإدارة الموافقة معتمَدة من Google ومتوافقة مع إطار الشفافية والموافقة و/أو التأكّد من ضبط المَعلمة gdpr=1 فقط للمستخدمين الذين تسري عليهم "اللائحة العامة لحماية البيانات".