Penargetan

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan. Untuk contoh yang berfungsi, download aplikasi Android API Demo.

Download Demo API

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 update 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), ada setelan yang disebut "tag perlakuan untuk anak-anak". Dengan menetapkan tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda diberi otorisasi 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 menunjukkan bahwa Anda ingin Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak, kami mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut.

Setelan ini dapat digunakan dengan semua versi SDK layanan Google Play melalui RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• 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. Hal ini akan 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.

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

Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan 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)

Catatan: Aplikasi di Program Didesain untuk Keluarga sebagai Aplikasi yang terutama ditujukan untuk anak-anak dan pengguna yang login ke akun Google yang dikelola dengan Family Link secara otomatis memiliki semua konten yang diperlakukan ditujukan untuk anak-anak untuk semua permintaan iklan.

Pengguna 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 diperhatikan bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Harap tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. Perlu diingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang mana pun berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.

Saat menggunakan fitur ini, tag untuk Pengguna yang berusia di bawah Usia Dewasa di Eropa (TFUA) akan disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. Permintaan untuk vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga, juga dinonaktifkan.

Seperti setelan yang ditujukan untuk anak-anak, ada metode di RequestConfiguration.Builder untuk menyetel 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 untuk pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa. Hal ini juga akan 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 untuk pengguna di Wilayah Ekonomi Eropa (EEA) 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 untuk pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.

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

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 yang ditujukan untuk anak-anak dan setTagForUnderAgeOfConsent() tidak boleh disetel secara bersamaan ke true. Jika demikian, setelan yang ditujukan untuk anak-anak akan diutamakan.

Pemfilteran konten iklan

Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklannya menggunakan metode setMaxAdContentRating. Iklan AdMob yang ditampilkan saat dikonfigurasikan memiliki rating konten pada atau di bawah tingkat tersebut. Kemungkinan nilai tambahan jaringan ini didasarkan pada klasifikasi label konten digital, dan harus merupakan 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:

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)

Catatan: Setelan filter rating konten yang ditentukan melalui SDK akan menggantikan setelan apa pun yang dikonfigurasi menggunakan UI AdMob.

Permintaan iklan

Objek AdRequest mengumpulkan informasi penargetan untuk dikirim bersama permintaan iklan.

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