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

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

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

وضع مكتب الإعلانات التفاعلية في أوروبا (IAB Europe) اللمسات الأخيرة على الإصدار 2.0 من إطار الشفافية والموافقة الذي تم تطويره في مختبر IAB التقني بالتعاون مع الشركات الأعضاء المشتركة. تدعم Google الآن الإصدار 2.0 من إطار الشفافية والموافقة بالكامل.

لمنح الناشرين الوقت الكافي لإدارة الأخطاء وعمليات الضبط الخاطئة المتعلقة بإطلاق الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية في أوروبا (IAB Europe)، ستوفر Google للناشرين تقريرًا بالأخطاء التي رصدناها وفترة سماح لمدة 150 يومًا يمكن خلالها تصحيح الأخطاء.

---

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

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

---

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

التعديلات

• تذكير بشأن متطلّبات إطار الشفافية والموافقة لإعادة الحصول على الموافقة كلّ 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)}

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

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

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

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

الأسباب

سيستفيد الناشرون من طلب الموافقة مرّة أخرى إذا كان قد سبق أن استخدَموا سلاسل خارج الإطار أو ذات نطاق عالمي، أو كانت أرقام تعريف منصّة إدارة الموافقة غير صالحة (من الاختبارات)، أو كانت أرقام تعريف "قائمة المورّدين العالميين" (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 فورًا عند التسجيل باستخدام بيانات الشفافية والموافقة الحالية، حتى إذا كانت حالة منصّة إدارة الموافقة 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، ولكنها تفتقد الأسس القانونية للإعلانات الأساسية.	تأكَّد ما إذا كان المستخدم قد رفض عمدًا المصالح المشروعة في الأغراض الأخرى أو إذا كان السبب يعود إلى أخطاء في تنفيذ منصّة إدارة الموافقة.

الضبط الخاطئ

لن تتم تعبئة طلبات الإعلان أثناء حدوث أخطاء في الضبط.

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

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

مشاكل سلسلة الموافقة والشفافية المرتبطة بطلب الإعلان. سيتم تجاهل طلبات الإعلان ولن يتم ملؤها.

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

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

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

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

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

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

الخطأ	الوصف	الإجراء المقترَح
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 و"حزمة تطوير البرامج لمنصّة UMP" في تطبيقك، تأكَّد من تطبيق الحزمة بشكل صحيح وأنّه يتمّ طلب requestConsentInfoUpdate عند بدء تشغيل التطبيق في كلّ مرّة.
7.9	قيمة نسخة سلسلة الموافقة الإضافية (AC) لا تساوي 1 أو 2.	يجب أن تضبط منصّة إدارة الموافقة نسخة سلسلة الموافقة الإضافية على القيمة 1 أو 2.

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

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

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