Penargetan

Panduan ini menjelaskan cara memberikan informasi penargetan ke Google Mobile Ads SDK.

Download Demo API

Prasyarat

• Selesaikan Panduan memulai.

RequestConfiguration

RequestConfiguration mengumpulkan informasi penargetan yang diterapkan secara global ke setiap permintaan iklan. Untuk tag penargetan yang tersedia, lihat dokumentasi RequestConfiguration.Builder.

Untuk mengupdate konfigurasi permintaan, dapatkan builder dari konfigurasi yang ada, lakukan update yang diinginkan, lalu tetapkan sebagai berikut:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Setelan yang ditujukan untuk anak-anak

Untuk keperluan Children's Online Privacy Protection Act (COPPA), ada setelan yang disebut "tag perlakuan untuk anak-anak". Dengan menyetel tag ini, Anda menyatakan bahwa pemberitahuan ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian akun Google Anda.

Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak atau tidak saat membuat permintaan iklan. Jika Anda menunjukkan bahwa Anda ingin Google memperlakukan konten Anda sebagai konten yang ditujukan untuk anak-anak, kami akan mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut.

Anda dapat menerapkan setelan yang ditujukan untuk anak-anak melalui setTagForChildDirectedTreatment():

• Panggil setTagForChildDirectedTreatment dengan TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Tindakan ini mencegah transmisi ID iklan Android (AAID).

• Panggil setTagForChildDirectedTreatment dengan TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA.

• Panggil setTagForChildDirectedTreatment dengan TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED jika Anda tidak ingin menunjukkan cara Anda ingin konten Anda diperlakukan sehubungan dengan COPPA dalam permintaan iklan.

Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai konten yang ditujukan untuk anak-anak untuk tujuan COPPA:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Pengguna yang berusia di bawah usia dewasa

Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna yang berusia di bawah usia dewasa di Wilayah Ekonomi Eropa (EEA). Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap General Data Protection Regulation (GDPR). Perlu diketahui 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 membebaskan penayang tertentu dari kewajibannya berdasarkan hukum. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.

Saat menggunakan fitur ini, parameter Tag untuk Pengguna yang Berusia di bawah Usia Legal di Eropa (TFUA) disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. Hal ini juga menonaktifkan permintaan ke vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga.

Seperti setelan konten yang ditujukan untuk anak-anak, ada metode di RequestConfiguration.Builder untuk menetapkan parameter TFUA: setTagForUnderAgeOfConsent(), dengan opsi berikut.

• Panggil setTagForUnderAgeOfConsent() dengan TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE untuk menunjukkan bahwa Anda ingin permintaan iklan menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia di bawah usia dewasa. Hal ini juga mencegah transmisi ID iklan Android (AAID).

• Panggil setTagForUnderAgeOfConsent() dengan TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE untuk menunjukkan bahwa Anda ingin permintaan iklan tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia di bawah usia dewasa.

• Panggil setTagForUnderAgeOfConsent() dengan TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED untuk menunjukkan bahwa Anda belum menentukan apakah permintaan iklan harus menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berusia di bawah usia dewasa.

Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Tag untuk mengaktifkan Setelan untuk anak-anak dan setTagForUnderAgeOfConsent() tidak boleh ditetapkan secara bersamaan ke true. Jika demikian, setelan yang ditujukan untuk anak-anak akan diprioritaskan.

Pemfilteran konten iklan

Untuk mematuhi Kebijakan Iklan Tidak Pantas Google Play yang menyertakan penawaran terkait dalam iklan, semua iklan dan penawaran terkait yang ditampilkan dalam aplikasi Anda harus sesuai dengan rating konten aplikasi Anda, meskipun konten itu sendiri sudah mematuhi 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 iklannya menggunakan metode setMaxAdContentRating . Iklan AdMob yang ditampilkan saat ini dikonfigurasi memiliki rating konten pada atau di bawah tingkat tersebut. Kemungkinan nilai untuk tambahan jaringan ini didasarkan pada klasifikasi label konten digital, dan harus berupa salah satu 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 yang tidak lebih tinggi dari G:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

Publisher Privacy Treatment (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 penayang (PPT) disertakan dalam semua permintaan iklan mendatang selama sisa sesi.

Secara default, permintaan iklan ke Google menayangkan iklan yang dipersonalisasi. Kode berikut akan menonaktifkan personalisasi iklan untuk semua permintaan iklan:

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Permintaan iklan

Objek AdRequest mengumpulkan informasi penargetan untuk dikirim bersama permintaan iklan.

Lihat contoh Penargetan Iklan untuk implementasi penargetan iklan di aplikasi Android API Demo.