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

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

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

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

يحدِّد المثال التالي هذه المَعلمات:

const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = getConsentToStorage();

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