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

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

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

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

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

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

تعديل عملية تنفيذ "الموافقة المحدودة" استنادًا إلى إطار الشفافية والموافقة

يتطلّب استخدام "مكتبة الوصول الآلي" على Android اتّخاذ إجراء عند التحديث إلى الإصدار 23.0.0، ما يتيح لـ "مكتبة الوصول الآلي" قراءة بيانات "إطار الشفافية والموافقة" من الجهاز لتحديد موافقة المستخدم على تخزين البيانات على جهازه أم لا. تضيف هذه النسخة أيضًا السمة forceLimitedAds وتزيل السمة allowStorage. لا تعدِّل تطبيقك لاستخدام السمة forceLimitedAds إلا إذا كان تفعيل الإعلانات المحدودة المستند إلى إطار الشفافية والموافقة لا يستوفي متطلبات تطبيقك. لمزيد من المعلومات حول تحديد الموافقة استنادًا إلى "إطار الشفافية والموافقة"، يُرجى الاطّلاع على مقالة تكامُل الناشر مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB في أوروبا.

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

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

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

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

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

ConsentSettings consentSettings = ConsentSettings.builder()
            .directedForChildOrUnknownAge(false)
            .build();
// PAL Android version 23.0.0 introduces
// `ConsentSettings.forceLimitedAds` and removes `ConsentSettings.allowStorage`.
// Best practice is to not set `forceLimitedAds` 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.

GoogleAdManagerSettings adManagerSettings = GoogleAdManagerSettings.builder()
            // Add this line if the "Programmatic limited ads" toggle is turned
            // off in Ad Manager.
            .disableLimitedAdsStorage(true)
            // Add this line if the
            // "First party identifiers for ads on app" toggle is turned
            // off in Ad Manager.
            .disableFirstPartyIdentifiers(true)
            .build();

nonceLoader = new NonceLoader(this, consentSettings, adManagerSettings);