定位

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan. Untuk contoh kerja, unduh aplikasi Android API Demo.

Unduh Demo API

Prasyarat

PermintaanKonfigurasi

RequestConfiguration adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui metode statis MobileAds .

Untuk memperbarui konfigurasi permintaan, dapatkan pembuat dari konfigurasi yang ada, lakukan pembaruan yang diinginkan, dan atur sebagai berikut:

Jawa

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

Kotlin

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

Pengaturan yang ditujukan untuk anak-anak

Untuk tujuan Children's Online Privacy Protection Act (COPPA) , ada pengaturan yang disebut "tag untuk perlakuan yang ditujukan untuk 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 mengakibatkan penghentian akun Google Anda.

Sebagai pengembang aplikasi, Anda dapat menunjukkan apakah Anda ingin Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak saat Anda 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 pada permintaan iklan tersebut.

Pengaturan 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.

  • 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 bagaimana Anda ingin konten Anda diperlakukan sehubungan dengan COPPA dalam permintaan iklan.

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

Jawa

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)

Anda dapat menandai permintaan iklan Anda untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa. Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap Peraturan Perlindungan Data Umum (GDPR) . Perhatikan bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Harap tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda sendiri. Harap diingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak membebaskan penerbit tertentu dari kewajibannya menurut hukum.Pelajari lebih lanjut tentang bagaimana GDPR memengaruhi penayang .

Saat menggunakan fitur ini, parameter Tag For Users under the Age of Consent in Europe (TFUA) akan disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. Ini juga menonaktifkan permintaan ke vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga.

Seperti setelan yang ditujukan untuk 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 bagi pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.

  • 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:

Jawa

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 dan setTagForUnderAgeOfConsent() tidak boleh keduanya secara bersamaan disetel ke true . Jika ya, setelan untuk anak-anak akan diprioritaskan.

Pemfilteran konten iklan

Aplikasi dapat menyetel peringkat konten iklan maksimum untuk permintaan iklannya menggunakan metode setMaxAdContentRating . Iklan AdMob yang ditampilkan saat dikonfigurasi memiliki peringkat konten pada atau di bawah level tersebut. Nilai yang mungkin untuk ekstra 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 dikembalikan harus sesuai dengan penunjukan label konten digital yang tidak lebih tinggi dari G :

Jawa

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)

Permintaan iklan

Objek AdRequest mengumpulkan informasi penargetan untuk dikirim dengan permintaan iklan.

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