تنظیمات آگهی‌های محدود و شناسه طرف اول

آگهی‌های محدود به برنامه‌ها اجازه می‌دهد وقتی کاربران شما با هم‌رسانی داده‌های شخصی‌شان موافقت نمی‌کنند آگهی ارائه دهند. حالت آگهی‌های محدود جمع‌آوری، هم‌رسانی، و استفاده از داده‌های شخصی برای انتخاب آگهی را متوقف می‌کند. اگر کاربران شما انتخاب کنند که داده‌های شخصی را هم‌رسانی نکنند، این ویژگی به آگهی‌ها اجازه می‌دهد به ارائه خدمات ادامه دهند.

این راهنما استفاده از تنظیمات آگهی‌های محدود در برنامه شما و مطابقت رفتار برنامه با تنظیمات جهانی شبکه Google Ad Manager شما را پوشش می‌دهد.

پیکربندی تنظیمات آگهی‌های محدود مشتری

نسخه ۲۳.۰.۰ «زبان خط‌مشی تبلیغات» دارایی forceLimitedAds را معرفی می‌کند و دارایی allowStorage را برمی‌دارد. این دارایی در کلاس ConsentSettings است.

از نسخه ۲۳.۰.۰، «کتابخانه تبلیغات پلاتفرم» (PAL) داده‌های «چارچوب شفافیت و موافقت» (TCF) را از دستگاه می‌خواند تا موافقت کاربر برای ذخیره‌سازی محلی را تعیین کند. قبلاً، برنامه شما مسئول تعیین رضایت ذخیره‌سازی بود. برنامه شما همچنان باید پارامترهای gdpr= و gdpr_consent= را در نشانی وب برچسب آگهی بگذراند.

اگر تعیین خودکار براساس TCF کافی نیست، مستقیماً دارایی forceLimitedAds را در برنامه‌تان تنظیم کنید. برای جزئیات، به یکپارچه‌سازی ناشر با IAB Europe TCF مراجعه کنید. اگر دارایی forceLimitedAds را روی مقدار true تنظیم کنید، PAL نمی‌تواند شناسه‌های کاربر را در نانس ارسال‌شده به سرور ذخیره یا ارسال کند. تنظیم کردن دارایی forceLimitedAds روی مقدار true مانند افزودن پارامتر ltd=1 به نشانی وب درخواست آگهی در کیت‌های توسعه نرم‌افزار IMA (آگهی‌های رسانه‌ای تعاملی) است. برای جزئیات بیشتر درباره آگهی‌های محدود، به ltd (آگهی‌های محدود) مراجعه کنید. وقتی ویژگی forceLimitedAds را روی مقدار true تنظیم می‌کنید، PAL پارامتر ltd=1 را در تک‌منظوره قرار می‌دهد.

برای حفظ رفتار کنونی در برنامه‌تان، ممکن است لازم باشد پیاده‌سازی‌تان را به‌روز کنید، حتی اگر قبلاً دارایی allowStorage را تنظیم نکرده باشید. دارایی allowStorage روی مقدار false پیش‌فرض تنظیم شد که آگهی‌های محدود را فعال کرد. دارایی forceLimitedAds به‌طور پیش‌فرض روی مقدار false تنظیم می‌شود که آگهی‌های محدودشده را فعال نمی‌کند.

به‌روزرسانی پیاده‌سازی PAL برای تعیین مبتنی بر TCF

‫PAL Android هنگام به‌روزرسانی به نسخه ۲۳.۰.۰ نیاز به اقدام دارد. این نسخه به PAL اجازه می‌دهد داده‌های TCF را از دستگاه بخواند تا موافقت کاربر برای فضای ذخیره‌سازی محلی را تعیین کند. این نسخه همچنین دارایی forceLimitedAds را اضافه می‌کند و دارایی allowStorage را برمی‌دارد. فقط درصورتی برنامه‌تان را به‌روز کنید تا از دارایی forceLimitedAds استفاده کند که فعال‌سازی آگهی‌های محدود مبتنی بر «چارچوب رضایت کاربر» الزامات برنامه‌تان را برآورده نکند. برای کسب اطلاعات بیشتر درباره تعیین مبتنی بر TCF، به یکپارچه‌سازی ناشر با IAB Europe TCF مراجعه کنید.

مطابقت با تنظیمات جهانی Google Ad Manager

اگر تنظیمات Ad Manager آگهی‌های محدود برنامه‌ریزی‌شده یا شناسه‌های طرف اول برای آگهی‌ها در برنامه‌ها را به‌روزرسانی می‌کنید، از این میاناهای برنامه‌سازی کاربردی جدید برای مطابقت دادن تنظیمات در Ad Manager استفاده کنید. اگر از واسط‌های برنامه‌سازی کاربردی استفاده نمی‌کنید، ممکن است PAL شناسه‌ها را در نانسی که در درخواست آگهی به سرور استفاده می‌شود بگنجاند. بااین‌حال، Ad Manager ممکن است براساس تنظیمات در Ad Manager نشان‌ها را حذف کند.

میاناهای برنامه‌سازی کاربردی به‌شرح زیر است:

  • disableLimitedAdsStorage - شناسه‌های فقط تشخیص ترافیک نامعتبر و استفاده از فضای ذخیره‌سازی محلی برای آگهی‌های محدود را غیرفعال می‌کند. اگر تنظیم آگهی‌های محدود برنامه‌ریزی‌شده را در Ad Manager در سرپرست > تنظیمات سراسری به‌روزرسانی کرده‌اید، از این API برای غیرفعال کردن استفاده از فضای ذخیره‌سازی محلی برای آگهی‌های محدود در PAL استفاده کنید. توجه داشته باشید که این تنظیم برای آگهی‌های غیرمحدود اعمال نمی‌شود.
  • disableFirstPartyIdentifiers - شناسه‌های طرف اول مورداستفاده برای انتخاب آگهی را غیرفعال می‌کند. اگر تنظیم شناسه‌های طرف اول برای آگهی‌ها در برنامه‌ها را در Ad Manager در تنظیمات سرپرست > سراسری به‌روز کرده‌اید، از این میانای برنامه کاربردی برای غیرفعال کردن چنین شناسه‌هایی در 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);