Panduan ini menjelaskan cara memberikan informasi penargetan untuk permintaan iklan. Untuk contoh yang berfungsi, download aplikasi Android API Demo.
Prasyarat
- Selesaikan panduan Memulai.
RequestConfiguration
RequestConfiguration
adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global
melalui metode statis
MobileAds
.
Untuk memperbarui konfigurasi permintaan, dapatkan builder dari konfigurasi yang ada, lakukan pembaruan yang diinginkan, dan tetapkan sebagai berikut:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Setelan yang ditujukan untuk anak-anak
Untuk mematuhi Children's Online Privacy Protection Act (COPPA), terdapat setelan yang disebut "tag perlakuan untuk anak-anak". Dengan menyetel tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat mengakibatkan penghentian akun Google Anda.
Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak atau tidak saat membuat permintaan iklan. Jika Anda menyatakan bahwa Anda ingin Google memperlakukan konten Anda sebagai konten yang ditujukan untuk anak-anak, kami akan mengambil langkah-langkah untuk menonaktifkan iklan PMM dan pemasaran ulang di permintaan iklan tersebut.
Setelan ini dapat digunakan dengan semua versi SDK layanan Google Play melalui RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
:
Panggil
setTagForChildDirectedTreatment
denganTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA. Hal ini akan mencegah transmisi ID iklan Android (AAID).Panggil
setTagForChildDirectedTreatment
denganTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
untuk menunjukkan bahwa Anda tidak ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA.Panggil
setTagForChildDirectedTreatment
denganTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
jika Anda tidak ingin menunjukkan bagaimana Anda ingin konten diperlakukan sehubungan dengan COPPA dalam permintaan iklan.
Contoh berikut menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai COPPA:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Pengguna di bawah usia dewasa
Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia di bawah usia dewasa. Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap General Data Protection Regulation (GDPR). Perhatikan bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. Perhatikan bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang tertentu berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.
Saat menggunakan fitur ini, parameter Tag untuk Pengguna yang berusia di bawah Usia Dewasa di Eropa (TFUA) disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. API ini juga menonaktifkan permintaan untuk vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga.
Seperti setelan yang ditujukan untuk anak-anak, ada metode di
RequestConfiguration.Builder
untuk menyetel parameter TFUA:
setTagForUnderAgeOfConsent()
,
dengan opsi berikut.
Panggil
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
untuk menunjukkan bahwa Anda ingin agar permintaan iklan menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa. Hal ini juga akan mencegah transmisi ID iklan Android (AAID).Panggil
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
untuk menunjukkan bahwa Anda ingin permintaan iklan tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.Panggil
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
untuk menunjukkan bahwa Anda belum menentukan apakah permintaan iklan harus menerima perlakuan untuk pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.
Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Tag untuk mengaktifkan Setelan ditujukan untuk anak-anak dan setTagForUnderAgeOfConsent()
tidak boleh ditetapkan secara bersamaan ke true
.
Jika ya, setelan yang ditujukan untuk anak-anak lebih diprioritaskan.
Pemfilteran konten iklan
Untuk mematuhi Kebijakan Iklan yang Tidak Pantas Google Play yang mencakup penawaran terkait dalam iklan, semua iklan dan penawaran terkait yang ditampilkan dalam aplikasi harus sesuai dengan rating konten aplikasi Anda, meskipun kontennya sendiri sudah sesuai dengan kebijakan Google Play.
Alat seperti rating konten iklan maksimum dapat membantu Anda memiliki kontrol yang lebih besar atas konten iklan yang ditampilkan kepada pengguna. Anda dapat menetapkan rating konten maksimum untuk membantu mematuhi kebijakan platform.
Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklan mereka menggunakan
metode
setMaxAdContentRating
. Iklan AdMob yang ditampilkan jika konfigurasi ini dikonfigurasikan memiliki rating konten pada atau di bawah tingkat tersebut. Nilai yang mungkin untuk tambahan jaringan ini didasarkan pada
klasifikasi label konten digital, dan harus berupa salah satu dari string
berikut:
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
Kode berikut mengonfigurasi objek RequestConfiguration
untuk menentukan bahwa
konten iklan yang ditampilkan harus sesuai dengan penetapan label konten digital
tidak lebih tinggi dari G
:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Pelajari lebih lanjut:
Menetapkan rating konten maksimum untuk setiap permintaan iklan
Menetapkan rating konten iklan maksimum untuk aplikasi atau akun
Perlakuan Privasi Penayang (Beta)
Perlakuan Privasi Penayang
(PPT) API adalah alat opsional yang memungkinkan aplikasi menunjukkan apakah akan menonaktifkan personalisasi
iklan untuk semua permintaan iklan menggunakan metode
setPublisherPrivacyPersonalizationState()
.
Saat menggunakan fitur ini, parameter perlakuan privasi (PPT) penayang
disertakan dalam semua permintaan iklan berikutnya untuk sisa sesi tersebut.
Secara default, permintaan iklan ke Google menerima tayangan iklan yang dipersonalisasi. Kode berikut menonaktifkan personalisasi iklan untuk semua permintaan iklan:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Permintaan iklan
Objek AdRequest
mengumpulkan informasi
penargetan untuk dikirim bersama permintaan iklan.