إعدادات الإعلانات المحدودة ومعرّف الطرف الأول

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

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

ضبط إعدادات الإعلانات المحدودة على مستوى العميل

يقدّم الإصدار 1.109.0 من PAL السمة forceLimitedAds ويزيل السمة allowStorage. هذه السمة مضمّنة في الفئة ConsentSettings.

اعتبارًا من الإصدار 1.109.0، تقرأ "مكتبة الوصول الآلي" بيانات "إطار الشفافية والموافقة" من الجهاز لتحديد ما إذا كان المستخدم موافقًا على تخزين البيانات على جهازه أم لا. في السابق، كان تطبيقك مسؤولاً عن تحديد الموافقة على التخزين. سيظلّ عليك تمرير المَعلمتَين gdpr= وgdpr_consent= في عنوان URL لعلامة الإعلان.

إذا لم يكن التحديد التلقائي المستند إلى "إطار الشفافية والموافقة" كافيًا، اضبط السمة forceLimitedAds مباشرةً في تطبيقك. لمزيد من التفاصيل، اطّلِع على تكامل الناشر مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB في أوروبا. يؤدي ضبط السمة forceLimitedAds على القيمة true إلى منع PAL من تخزين معرّفات المستخدمين أو إرسالها في الرقم الخاص الذي يتم إرساله إلى الخادم. يؤدي ضبط السمة forceLimitedAds على القيمة true إلى النتيجة نفسها التي يحقّقها إضافة المَعلمة ltd=1 إلى عنوان URL لطلب عرض الإعلان في حِزم تطوير البرامج لإعلانات الوسائط التفاعلية (IMA). للاطّلاع على تفاصيل حول "الإعلانات المحدودة"، يُرجى الرجوع إلى ltd (الإعلانات المحدودة). عند ضبط الخاصية forceLimitedAds على القيمة true، يتضمّن PAL المَعلمة ltd=1 في الرقم العشوائي.

للحفاظ على السلوك الحالي في تطبيقك، قد يكون تعديل عملية التنفيذ مطلوبًا حتى ولو لم يتم ضبط قيمة السمة allowStorage من قبل. تم ضبط القيمة التلقائية للسمة allowStorage على false، ما أدّى إلى تفعيل الإعلانات المحدودة. تكون القيمة التلقائية للسمة forceLimitedAds هي false، ما لا يتيح عرض إعلانات محدودة.

مطابقة الإعدادات العامة في "مدير إعلانات Google"

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

في ما يلي واجهات برمجة التطبيقات:

• disableLimitedAdsStorage - يؤدي إلى إيقاف ملفات تعريف الارتباط المخصّصة لرصد الزيارات غير الصالحة فقط وإيقاف استخدام مساحة التخزين المحلية لعرض الإعلانات المحدودة. إذا عدّلت إعدادات الإعلانات المحدودة الآلية في "مدير إعلانات Google" ضمن المشرف > الإعدادات العامة، استخدِم واجهة برمجة التطبيقات هذه لإيقاف استخدام مساحة التخزين المحلية للإعلانات المحدودة في "برنامج الوصول المبكر إلى ميزة الخصوصية". يُرجى العِلم بأنّ هذا الإعداد لا ينطبق على الإعلانات غير المحدودة.
• disableFirstPartyIdentifiers - يؤدي إلى إيقاف معرّفات الطرف الأول المستخدَمة لاختيار الإعلانات. إذا عدّلت إعداد ملفات تعريف الارتباط الخاصة بالطرف الأول للإعلانات على الويب في "مدير إعلانات Google" ضمن المشرف > الإعدادات العامة، استخدِم واجهة برمجة التطبيقات هذه لإيقاف مثل هذه المعرّفات في "اتفاقية معالجة البيانات المحدودة". يُرجى العِلم أنّ هذا الإعداد لا ينطبق على استخدام ملفات تعريف الارتباط ومساحة التخزين المحلية لرصد الزيارات غير الصالحة.

التعامل مع موافقة المستخدم في تطبيقك

يتناول المثال التالي خصوصية المستخدم واستخدام البيانات في عملية تنفيذ PAL:

const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = true;
// During the PAL Phase 1 release, best practice is to always set the
// `allowStorage` property to a `true` value to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.

const adManagerSettings = new goog.pal.GoogleAdManagerSettings();
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = true;
// Add this line if the "First party cookies for ads on web" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true;

const nonceLoader = new goog.pal.NonceLoader(consentSettings, adManagerSettings);