Targeting

Pilih platform: Android iOS Unity Flutter Android (Lama)

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

Untuk contoh yang berfungsi, download aplikasi Android API Demo.

Download Demo API

Prasyarat

Sebelum melanjutkan, siapkan Google Mobile Ads SDK (Legacy).

RequestConfiguration

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

Untuk memperbarui konfigurasi permintaan, dapatkan builder dari konfigurasi yang ada, lakukan pembaruan yang dipilih, dan tetapkan sebagai berikut:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Untuk memastikan semua permintaan iklan menerapkan perubahan konfigurasi permintaan, tetapkan konfigurasi permintaan sebelum Anda Melakukan inisialisasi Google Mobile Ads SDK (Legacy).

Menetapkan perlakuan berdasarkan usia

Untuk membantu Anda mengelola kepatuhan terhadap peraturan privasi yang berlaku terkait anak-anak dan remaja, Google Mobile Ads SDK (Legacy) menyediakan setelan perlakuan usia. Setelan perlakuan usia memungkinkan Anda menunjukkan apakah Google Mobile Ads SDK (Legacy) harus menerapkan perlindungan penayangan iklan tertentu untuk anak-anak, remaja, atau usia yang tidak ditentukan.

Anda dapat menetapkan perlakuan berdasarkan usia dengan metode setAgeRestrictedTreatment() menggunakan RequestConfiguration.Builder API.

Contoh berikut menunjukkan bahwa panggilan iklan akan menerima perlakuan usia anak:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Untuk menunjukkan perlakuan usia remaja atau yang tidak ditentukan, ganti setelan CHILD dengan yang berikut:

• TEEN
• UNSPECIFIED

Saat menggunakan setelan ini, Google Mobile Ads SDK (Legacy) menyertakan parameter tfat dalam permintaan iklan. Berkonsultasilah dengan penasihat hukum Anda untuk menentukan persyaratan usia yang berlaku bagi pengguna Anda berdasarkan kewajiban hukum dan peraturan Anda. Untuk mengetahui informasi selengkapnya, lihat Memberi tag pada panggilan iklan dari aplikasi untuk perlakuan pembatasan usia.

Bermigrasi ke perlakuan berdasarkan usia dari TFCD dan TFUA

Setelan perlakuan usia menggantikan setelan .setTagForChildDirectedTreatment() (TFCD) dan .setTagForUnderAgeOfConsent() (TFUA) yang tidak digunakan lagi.

Tabel berikut menunjukkan setelan TFCD dan TFUA serta padanan perlakuan berdasarkan usia:

TFCD

TFCD	Perlakuan berdasarkan usia
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Tidak ada nilai yang ditetapkan .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
Tidak ada ekuivalen	AgeRestrictedTreatment.TEEN

TFUA

TFUA	Perlakuan berdasarkan usia
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
Tidak ada nilai yang ditetapkan .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Tidak ada ekuivalen	AgeRestrictedTreatment.TEEN

Memahami interaksi perlakuan usia dengan TFCD dan TFUA

Jika Anda menetapkan setelan perlakuan usia dan setelan TFCD atau TFUA, Google akan menerapkan perlakuan yang paling ketat.

Catatan: Aplikasi dalam Program Didesain untuk Keluarga sebagai Aplikasi yang ditujukan terutama untuk anak-anak dan pengguna yang login ke Akun Google yang dikelola dengan Family Link akan otomatis membuat semua konten diperlakukan sebagai ditujukan untuk anak-anak untuk semua permintaan iklan.

Meneruskan perlakuan berdasarkan usia dengan Mediasi AdMob

Jika Anda menetapkan perlakuan usia menggunakan Google Mobile Ads SDK (Legacy), adaptor mediasi akan meneruskan sinyal perlakuan usia ke SDK pihak ketiga yang dimediasi.

Tabel berikut mencantumkan versi adaptor mediasi yang mendukung penerusan sinyal perlakuan yang dibatasi usia ke SDK pihak ketiga yang dimediasi:

Nama adaptor mediasi	Versi minimum yang didukung
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

Setelan yang ditujukan untuk anak-anak

Peringatan: Metode setTagForChildDirectedTreatment() tidak digunakan lagi. Sebagai gantinya, tetapkan metode setAgeRestrictedTreatment().

Untuk tujuan Children's Online Privacy Protection Act (COPPA), ada setelan yang disebut "beri tag untuk perlakuan untuk anak-anak". Dengan menetapkan tag ini, Anda menyatakan bahwa notifikasi 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 agar Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak atau tidak saat membuat panggilan iklan. Jika Anda menunjukkan bahwa Anda ingin Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak, kami akan mengambil langkah-langkah untuk menonaktifkan iklan IBA dan iklan pemasaran ulang pada 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 pengiriman 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 sesuai dengan tujuan COPPA.

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

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

Kotlin

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

Java

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

Catatan: Aplikasi dalam Program Didesain untuk Keluarga sebagai Aplikasi yang ditujukan terutama untuk anak-anak dan pengguna yang login ke Akun Google yang dikelola dengan Family Link akan otomatis membuat semua konten diperlakukan sebagai ditujukan untuk anak-anak untuk semua permintaan iklan.

Pengguna berusia di bawah usia dewasa

Peringatan: Metode setTagForUnderAgeOfConsent() tidak digunakan lagi. Sebagai gantinya, tetapkan metode setAgeRestrictedTreatment().

Anda dapat menandai permintaan iklan Anda untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia dewasa. Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap General Data Protection Regulation (GDPR). Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. 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, parameter Tag untuk Pengguna di Bawah Usia Dewasa di Eropa (TFUA) akan disertakan dalam panggilan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. Permintaan ke 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 menetapkan parameter TFUA: setTagForUnderAgeOfConsent(), dengan opsi berikut.

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

• Panggil setTagForUnderAgeOfConsent() dengan TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE untuk menunjukkan bahwa Anda ingin panggilan 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 panggilan iklan harus menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia dewasa.

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

Kotlin

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

Java

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

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 yang Tidak Pantas Google Play yang mencakup penawaran terkait dalam iklan, semua iklan dan penawaran terkaitnya yang ditampilkan dalam aplikasi Anda harus sesuai dengan rating konten aplikasi Anda, meskipun konten itu sendiri sudah sesuai dengan kebijakan Google Play.

Alat seperti rating konten iklan maksimum dapat membantu Anda mengontrol lebih banyak aspek pada konten iklan yang ditampilkan kepada pengguna Anda. 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 lebih rendah dari tingkat tersebut. Nilai yang mungkin untuk detail tambahan untuk 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:

Kotlin

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

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

Pelajari lebih lanjut:

• Menetapkan rating konten maksimum untuk setiap permintaan iklan

• Menetapkan rating konten iklan maksimum untuk aplikasi atau akun

Catatan: Setelan filter rating konten yang ditentukan melalui Google Mobile Ads SDK (Legacy) akan menggantikan setelan apa pun yang dikonfigurasi menggunakan UI AdMob.

Perlakuan Privasi Penayang (Beta)

API Publisher Privacy Treatment (PPT) adalah alat opsional yang memungkinkan aplikasi menunjukkan apakah akan menonaktifkan personalisasi iklan untuk semua panggilan iklan menggunakan metode setPublisherPrivacyPersonalizationState(). Saat menggunakan fitur ini, parameter perlakuan privasi penayang (PPT) akan disertakan dalam semua panggilan iklan berikutnya selama sisa sesi.

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

Kotlin

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

Java

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

Catatan: Untuk panggilan iklan dengan sinyal privasi multi-pengguna, sinyal yang paling ketat akan diprioritaskan. Lihat dokumentasi Publisher Privacy Treatment API untuk mengetahui contoh spesifiknya.

Permintaan iklan

Objek AdRequest mengumpulkan informasi penargetan yang akan dikirim dengan permintaan iklan.

Menambahkan detail tambahan untuk jaringan

Detail tambahan untuk jaringan adalah detail tambahan yang dikirim dengan permintaan iklan yang spesifik untuk satu sumber iklan.

Cuplikan kode berikut menetapkan kunci parameter tambahan collapsible dengan nilai bottom ke Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)
AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);
AdRequestSnippets.java