Targeting

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

Prasyarat

Sebelum melanjutkan, siapkan GMA Next-Gen SDK.

RequestConfiguration

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

Buat objek RequestConfiguration dengan tag penargetan yang Anda butuhkan menggunakan pembangunnya, lalu tetapkan konfigurasi dengan memanggil MobileAds.setRequestConfiguration().

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Untuk menerapkan tag penargetan dari panggilan iklan pertama, berikan konfigurasi permintaan selama inisialisasi SDK:

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

Menetapkan perlakuan berdasarkan usia

Untuk membantu Anda mengelola kepatuhan terhadap peraturan privasi yang berlaku terkait anak-anak dan remaja, GMA Next-Gen SDK menyediakan setelan perlakuan menurut usia. Setelan perlakuan usia memungkinkan Anda menunjukkan apakah GMA Next-Gen SDK harus menerapkan perlindungan penayangan iklan tertentu untuk anak-anak, remaja, atau usia yang tidak ditentukan.

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

Contoh berikut menunjukkan bahwa permintaan iklan harus menerima perlakuan usia anak:

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

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

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

• TEEN
• UNSPECIFIED

Saat menggunakan setelan, GMA Next-Gen SDK 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 artikel Memberi tag perlakuan berdasarkan usia pada panggilan iklan.

Bermigrasi ke perlakuan 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 perlakuan berdasarkan usia yang setara:

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.

Meneruskan perlakuan berdasarkan usia dengan mediasi

Jika Anda menetapkan perlakuan berdasarkan usia menggunakan GMA Next-Gen SDK, adaptor mediasi meneruskan sinyal perlakuan berdasarkan usia ke SDK pihak ketiga yang dimediasi.

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

Setelan yang ditujukan untuk anak-anak

Untuk tujuan Children's Online Privacy Protection Act (COPPA), ada setelan yang disebut "beri tag untuk 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 mengakibatkan 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 IBA dan iklan pemasaran ulang pada panggilan 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 untuk tujuan COPPA.

• Panggil setTagForChildDirectedTreatment dengan TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED jika Anda tidak ingin menunjukkan cara Anda ingin konten 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 = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Pengguna yang berada 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). Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan tanyakan kepada 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) 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 menyetel 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 berada di bawah usia dewasa. Hal ini juga mencegah pengiriman 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 berada 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 berada di bawah usia dewasa.

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

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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 demikian, setelan yang ditujukan untuk anak-anak akan diprioritaskan.

Pemfilteran konten iklan

Untuk mematuhi Kebijakan Iklan Tidak Pantas Google Play yang mencakup penawaran terkait dalam iklan, semua iklan dan penawaran terkait yang ditampilkan dalam aplikasi Anda harus sesuai untuk rating konten aplikasi Anda, meskipun konten itu sendiri mematuhi 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. Kemungkinan nilai untuk ekstra 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 penunjukan label konten digital yang tidak lebih tinggi dari G:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Pelajari lebih lanjut cara menetapkan rating konten maksimum untuk setiap permintaan iklan.

Perlakuan Privasi Penayang (Beta)

API Publisher Privacy Treatment (PPT) 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 = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Permintaan iklan

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

Menambahkan detail tambahan untuk jaringan

Ekstra jaringan adalah detail tambahan yang dikirim dengan permintaan iklan yang khusus untuk satu sumber iklan.

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

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);

Penargetan kustom

Anda dapat meneruskan pasangan nilai kunci kustom untuk menargetkan kampanye Google Ad Manager (item baris). Contoh berikut meneruskan pasangan nilai kunci kustom dalam permintaan iklan:

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

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

.putCustomTargeting("age", listOf("24", "25", "26"))

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

Pengecualian kategori

Anda dapat menambahkan tingkat pengecualian kategori tingkat slot ke permintaan menggunakan metode addCategoryExclusion():

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

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

Lihat contoh Pengecualian Kategori Ad Manager untuk penerapan 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 lainnya di seluruh perangkat.

Berikut contoh cara menyetel PPID:

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

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

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

Sinyal yang diberikan penayang

Anda dapat mengirim data audiens dan kontekstual sebagai sinyal yang diberikan penayang (PPS) dalam permintaan iklan. Dengan PPS, Anda dapat menggunakan data pengguna untuk meningkatkan monetisasi terprogram dengan menyampaikan karakteristik audiens kepada bidder di semua jenis transaksi, menggunakan taksonomi standar, tanpa perlu membagikan ID pengguna. Karakteristik audiens Anda dapat mencakup data berbasis perilaku dan minat (Taksonomi Audiens IAB 1.1) serta data kontekstual (Taksonomi Konten IAB 2.2).

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

URL Konten

Untuk memberikan URL konten bagi iklan yang menargetkan konten dan keamanan merek, tambahkan kode berikut:

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

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

Keamanan merek (Beta)

Aplikasi yang menampilkan konten dinamis yang ditujukan untuk berbagai audiens dapat memberikan daftar singkat URL:

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

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");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

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