تتيح الإعلانات المحدودة للتطبيقات عرض الإعلانات عندما لا يوافق المستخدمون على مشاركة البيانات الشخصية. يوقف وضع "الإعلانات المحدودة" جمع البيانات الشخصية ومشاركتها واستخدامها لاختيار الإعلانات. إذا اختار المستخدمون عدم مشاركة البيانات الشخصية، تتيح هذه الميزة استمرار عرض الإعلانات.
يتناول هذا الدليل كيفية استخدام إعدادات "الإعلانات المحدودة" في تطبيقك، ومطابقة سلوك التطبيق مع الإعدادات العامة لشبكة "مدير إعلانات Google".
ضبط إعدادات الإعلانات المحدودة على مستوى العميل
تعمل "منصة إدارة الخصوصية" على تعديل طريقة معالجة الإعدادات بهدف تحسين التحكّم في خصوصية المستخدم واستخدام البيانات. يقدّم الإصدار 1.90.0 من PAL السمة forceLimitedAds ويوقف نهائيًا السمة allowStorage الحالية. تتوفّر هذه السمات في الفئة
ConsentSettings.
اعتبارًا من الإصدار 1.90.0، تقرأ "مكتبة الوصول الآلي" بيانات "إطار الشفافية والموافقة" من الجهاز لتحديد ما إذا كان المستخدم موافقًا على تخزين البيانات على جهازه أم لا. يؤدي هذا التغيير في قراءة بيانات إطار الشفافية والموافقة إلى إلغاء الحاجة إلى الموقع allowStorage الحالي. يجب أن يمرِّر تطبيقك المَعلمتَين gdpr= وgdpr_consent= في عنوان URL لعلامة الإعلان.
إذا لم يكن التحديد التلقائي المستند إلى إطار الشفافية والموافقة كافيًا، اضبط السمة
forceLimitedAds مباشرةً في تطبيقك. لمزيد من التفاصيل، اطّلِع على مقالة
تكامُل الناشر مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB في أوروبا.
يؤدي ضبط السمة forceLimitedAds على القيمة true إلى منع PAL من تخزين معرّفات المستخدمين أو إرسالها في الرقم العشوائي الذي يتم إرساله إلى الخادم.
يؤدي ضبط السمة forceLimitedAds على القيمة true إلى النتيجة نفسها التي يحقّقها إضافة المَعلمة ltd=1 إلى عنوان URL لطلب الإعلان في حِزم تطوير البرامج (SDK) الخاصة بـ "الإعلانات التفاعلية" (IMA). للاطّلاع على تفاصيل حول "الإعلانات المحدودة"، يُرجى الرجوع إلى
ltd (الإعلانات المحدودة).
عند ضبط السمة forceLimitedAds على القيمة true، يتضمّن PAL المَعلمة ltd=1 في الرقم العشوائي.
للحفاظ على السلوك الحالي في تطبيقك، قد يكون تعديل عملية التنفيذ مطلوبًا حتى ولو لم يتم ضبط قيمة السمة allowStorage من قبل.
تكون القيمة التلقائية للسمة allowStorage هي false، ما يؤدي إلى تفعيل الإعلانات المحدودة. تكون القيمة التلقائية للسمة forceLimitedAds هي false، ما لا يتيح عرض إعلانات محدودة.
تعديل على المرحلة 1 من تحديد إطار الشفافية والموافقة
يجهّزك إصدار المرحلة 1 من PAL HTML5 للانتقال من السمة
ConsentSettings.allowStorage إلى التحديد التلقائي للإعلانات المحدودة استنادًا إلى إطار الشفافية والموافقة.
خلال هذه المرحلة الانتقالية، ستأخذ "مكتبة الوصول الآلي" في الاعتبار بيانات "إطار الشفافية والموافقة" الخاصة بالمستخدم، والسمة allowStorage الحالية، والسمة forceLimitedAds الأحدث.
خلال هذه المرحلة، عليك دائمًا ضبط السمة allowStorage على القيمة true للسماح لواجهة برمجة التطبيقات PAL بتحديد ما إذا كانت الإعلانات المحدودة تنطبق استنادًا إلى بيانات إطار الشفافية والموافقة. إذا أردت تفعيل الإعلانات المحدودة بغض النظر عن قرار إطار الشفافية والموافقة، اضبط السمة forceLimitedAds على القيمة true.
خلال المرحلة 1، تفعّل "مكتبة الوصول الآلي" الإعلانات المحدودة في أي من الحالات التالية:
- تكون قيمة السمة
allowStorageهيfalseأو غير مضبوطة. لا ننصح باستخدام هذا الإعداد للموقعallowStorage، لأنّه مخصّص فقط للتطبيقات التي لم يتم تحديثها. - السمة
forceLimitedAdsهي قيمةtrue. - يرصد PAL عدم منح الموافقة على الغرض 1 بموجب إطار الشفافية والموافقة الصادر عن مكتب IAB (مكتب الإعلانات التفاعلية).
يعرض الجدول التالي جميع الحالات المحتملة وما إذا كانت الإعلانات المحدودة مفعّلة:
| الموافقة على الغرض 1 في "إطار الشفافية والموافقة" | موقع واحد (allowStorage) |
موقع واحد (forceLimitedAds) |
تفعيل الإعلانات المحدودة |
|---|---|---|---|
| تم منح الإذن بالوصول | True | صح | True |
| لم يتم المنح | True | صح | True |
| تم منح الإذن بالوصول | True | خطأ (تلقائي) | خطأ |
| لم يتم المنح | True | خطأ (تلقائي) | True |
| تم منح الإذن بالوصول | خطأ (تلقائي) | True | True |
| لم يتم المنح | خطأ (تلقائي) | True | True |
| تم منح الإذن بالوصول | خطأ (تلقائي) | خطأ (تلقائي) | True |
| لم يتم المنح | خطأ (تلقائي) | خطأ (تلقائي) | True |
الاستعداد لتحديد إطار الشفافية والموافقة في المرحلة 2
تزيل الإصدارات في المرحلة 2 وظائف من الموقع allowStorage. نخطّط لإطلاق المرحلة 2 بعد 90 يومًا من إطلاق المرحلة 1، أي في 10 آذار (مارس) 2026 تقريبًا. قبل هذا التاريخ، عليك تعديل عملية التنفيذ لاستخدام المَعلمة ConsentSettings.forceLimitedAds.
في الإصدار 2 من "ميزة الحدّ من المعالجة"، تتيح هذه الميزة عرض إعلانات محدودة استنادًا فقط إلى عدم توفّر الموافقة على الغرض 1 من "إطار الشفافية والموافقة" والسمة الاختيارية ConsentSettings.forceLimitedAds:
| الموافقة على الغرض 1 في "إطار الشفافية والموافقة" | موقع واحد (forceLimitedAds) |
تفعيل الإعلانات المحدودة |
|---|---|---|
| تم منح الإذن بالوصول | True | True |
| لم يتم المنح | True | True |
| تم منح الإذن بالوصول | خطأ (تلقائي) | خطأ |
| لم يتم المنح | خطأ (تلقائي) | True |
مطابقة الإعدادات العامة في "مدير إعلانات 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);