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 mengupdate konfigurasi permintaan, dapatkan builder dari konfigurasi yang ada, lakukan update yang diinginkan, dan tetapkan sebagai berikut:

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

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 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 menyebabkan penghentian akun Google Anda.

Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin agar Google memperlakukan konten Anda sebagai konten yang 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 akan mengambil 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 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 sesuai tujuan COPPA.

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

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

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

var 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 belum berusia 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. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda sendiri. Harap diingat 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, 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 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) di bawah usia dewasa. Tindakan 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 bagi 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 diperlakukan untuk pengguna di Wilayah Ekonomi Eropa (EEA) di bawah usia dewasa.

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

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

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 akan diutamakan.

Pemfilteran konten iklan

Untuk mematuhi Kebijakan Iklan Tidak Pantas Google Play yang menyertakan penawaran terkait dalam iklan, semua iklan dan penawaran terkaitnya yang ditampilkan dalam aplikasi Anda harus sesuai untuk rating konten aplikasi, meskipun konten itu 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 menggunakan metode setMaxAdContentRating. Iklan AdMob yang ditampilkan saat dikonfigurasi memiliki rating konten yang sesuai dengan atau berada di bawah tingkat tersebut. Nilai yang memungkinkan untuk 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:

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

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

Permintaan iklan

Objek AdManagerAdRequest mengumpulkan informasi penargetan untuk dikirim bersama permintaan iklan.

Penargetan kustom

Anda dapat meneruskan key-value pair kustom untuk menargetkan kampanye Google Ad Manager (item baris) melalui AdManagerAdRequest.Builder.addCustomTargeting():

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Anda dapat meneruskan beberapa nilai untuk kunci sebagai daftar string. Misalnya, menargetkan orang berusia pertengahan dua puluhan, bukan hanya usia 25 tahun.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Lihat contoh Penargetan Kustom Ad Manager untuk implementasi penargetan kustom di aplikasi Demo Android API.

Pengecualian kategori

Anda dapat menambahkan tingkat pengecualian kategori tingkat slot ke permintaan menggunakan metode addCategoryExclusion() yang disediakan oleh AdManagerAdRequest.Builder:

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Lihat contoh Pengecualian Kategori Ad Manager untuk implementasi pengecualian kategori di aplikasi Demo Android API.

ID yang diberikan penayang

Anda dapat menetapkan ID yang diberikan penayang (PPID) untuk digunakan dalam pembatasan frekuensi, penargetan dan segmentasi audiens, rotasi iklan berurutan, serta kontrol penayangan iklan berbasis audiens di seluruh perangkat.

Berikut adalah contoh setelan PPID:

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Lihat contoh PPID Ad Manager untuk implementasi ID yang diberikan penayang (PPID) di aplikasi Demo API Android.

URL Konten

Untuk memberikan URL konten bagi iklan bertarget konten dan keamanan merek, Anda dapat memanggil AdManagerAdRequest.Builder.setContentUrl() saat membuat AdManagerAdRequest:

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Keamanan merek (Beta)

Aplikasi yang menampilkan konten dinamis yang ditujukan untuk berbagai audiens dapat menyediakan daftar URL singkat menggunakan metode AdManagerAdRequest.Builder.setNeighboringContentUrls saat membuat AdManagerAdRequest:

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

.setNeighboringContentUrls() berbeda dengan .setContentUrl() karena hanya digunakan untuk keamanan merek.