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

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

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

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

يقدّم الإصدار 23.0.0 من "مكتبة الوصول الآلي" (PAL) السمة forceLimitedAds ويزيل السمة allowStorage. تتوفّر هذه السمة في الفئة ConsentSettings.

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

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

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

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

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

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

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

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

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

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

يعالج المثال التالي خصوصية المستخدم واستخدام البيانات في عملية تنفيذ "مكتبة الوصول الآلي":

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);