Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan. Untuk contoh kerja, download aplikasi Android API Demo.
Prasyarat
- Selesaikan panduan Memulai.
RequestConfiguration
RequestConfiguration
adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui
sebuah MobileAds
metode statis.
Untuk memperbarui konfigurasi permintaan, dapatkan builder dari platform yang ada konfigurasi, lakukan pembaruan apa pun yang diinginkan, dan setel 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 tujuan 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 dari Akun Google Anda.
Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin Google memperlakukan konten sebagai ditujukan untuk anak-anak saat Anda membuat permintaan iklan. Jika Anda menyatakan bahwa Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak, kami mengambil langkah menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut.
Setelan ini dapat digunakan dengan semua versi SDK layanan Google Play
sampai RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
:
Telepon
setTagForChildDirectedTreatment
denganTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Hal ini mencegah transmisi ID iklan Android (AAID).Telepon
setTagForChildDirectedTreatment
denganTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
untuk menunjukkan bahwa Anda tidak ingin konten diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA.Telepon
setTagForChildDirectedTreatment
denganTAG_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:
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)
Pengguna yang berusia di bawah usia dewasa
Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa. Fitur ini yang dirancang untuk membantu memfasilitasi kepatuhan terhadap Peraturan Perlindungan Data (GDPR). Perhatikan bahwa Anda mungkin memiliki hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda sendiri. Perhatikan bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang mana pun berdasarkan hukum. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.
Saat menggunakan fitur ini, Tag Untuk Pengguna yang berusia di bawah Usia Dewasa di Eropa (TFUA) disertakan dalam permintaan iklan. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk semua permintaan iklan. Anda juga menonaktifkan permintaan untuk vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga.
Seperti setelan yang ditujukan untuk anak-anak, ada metode di
RequestConfiguration.Builder
untuk menyetel parameter TFUA:
setTagForUnderAgeOfConsent()
dengan opsi berikut.
Telepon
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
untuk menunjukkan bahwa Anda ingin permintaan iklan menerima perlakuan untuk pengguna di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa. Hal ini juga mencegah transmisi ID iklan Android (AAID).Telepon
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
untuk menunjukkan bahwa Anda ingin permintaan iklan tidak menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa.Telepon
setTagForUnderAgeOfConsent()
denganTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
untuk menunjukkan bahwa Anda belum menentukan apakah permintaan iklan harus menerima perlakuan untuk pengguna dalam Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa.
Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan:
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 Ditujukan untuk anak-anak
dan setTagForUnderAgeOfConsent()
tidak boleh keduanya ditetapkan secara bersamaan ke true
.
Jika ya, setelan ditujukan untuk anak-anak akan diprioritaskan.
Pemfilteran konten iklan
Untuk mematuhi Kebijakan Iklan yang Tidak Pantas Google Play yang menyertakan penawaran terkait dalam iklan, semua iklan, dan yang terkait penawaran yang ditampilkan dalam aplikasi Anda harus sesuai dengan konten rating dari aplikasi Anda, meskipun konten itu sendiri sudah mematuhi kebijakan Google kebijakan Play.
Alat seperti rating konten iklan maksimum dapat membantu Anda memiliki kontrol lebih besar atas konten iklan yang ditampilkan kepada pengguna. Anda dapat menetapkan rating konten maksimum ke membantu Anda mematuhi kebijakan platform.
Aplikasi dapat menetapkan rating konten iklan maksimum untuk permintaan iklan mereka menggunakan
setMaxAdContentRating
. Iklan AdMob yang ditampilkan bila dikonfigurasi memiliki rating konten pada atau
di bawah tingkat tersebut. Nilai yang mungkin untuk tambahan jaringan ini didasarkan pada
klasifikasi label konten digital, dan harus merupakan salah satu dari yang berikut
string:
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 penetapan label konten digital
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)
Pelajari lebih lanjut:
Menetapkan rating konten maksimum untuk setiap iklan meminta
Menetapkan rating konten iklan maksimum untuk sebuah aplikasi atau akun Anda
Perlakuan Privasi Penayang (Beta)
Tujuan
Perlakuan Privasi Penayang
(PPT) API adalah alat opsional yang memungkinkan aplikasi menunjukkan apakah akan menonaktifkan iklan atau tidak
personalisasi untuk semua permintaan iklan yang menggunakan
setPublisherPrivacyPersonalizationState()
.
Saat menggunakan fitur ini, parameter perlakuan privasi penayang (PPT)
disertakan dalam semua permintaan iklan berikutnya selama sisa sesi tersebut.
Secara default, permintaan iklan ke Google menayangkan iklan yang dipersonalisasi. Hal berikut kode menonaktifkan personalisasi iklan untuk semua permintaan iklan:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Permintaan iklan
Objek AdManagerAdRequest
mengumpulkan penargetan
informasi untuk dikirim bersama permintaan iklan.
Penargetan kustom
Anda dapat meneruskan pasangan nilai kunci kustom untuk menargetkan kampanye Google Ad Manager (baris
item) melalui AdManagerAdRequest.Builder.addCustomTargeting()
:
Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
Kotlin
// 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, untuk menargetkan individu yang berusia pertengahan dua puluhan, bukan hanya di usia 25 tahun.
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
Lihat Contoh Penargetan Kustom Ad Manager untuk implementasi penargetan kustom di aplikasi Android API Demo.
Pengecualian kategori
Anda dapat menambahkan tingkat pengecualian kategori tingkat slot ke permintaan dengan menggunakan
addCategoryExclusion()
disediakan oleh AdManagerAdRequest.Builder
:
Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
Kotlin
// 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 Android API Demo.
ID yang diberikan penayang
Anda dapat menetapkan ID yang diberikan penayang (PPID) untuk digunakan dalam pembatasan frekuensi. penargetan dan segmentasi audiens, rotasi iklan berurutan, dan kontrol penayangan iklan berbasis audiens di berbagai perangkat.
Berikut adalah contoh setelan PPID:
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
Kotlin
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
Lihat Contoh PPID Ad Manager untuk penerapan ID yang diberikan penayang (PPID) di Android Aplikasi Demo API.
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 mengomunikasikan karakteristik audiens Anda kepada bidder di semua jenis transaksi, menggunakan taksonomi standar, tanpa perlu membagikan ID pengguna. Audiens Anda karakteristik dapat mencakup data berbasis perilaku dan minat (Audiens IAB Taksonomi 1.1) dan kontekstual data (Taksonomi Konten IAB 2.2).
Java
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));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
Kotlin
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()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
URL Konten
Untuk menyediakan URL konten untuk iklan bertarget konten dan keamanan merek, Anda dapat memanggil
setContentUrl()
saat membuat AdManagerAdRequest
:
Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
Kotlin
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 memberikan daftar singkat URL menggunakan
setNeighboringContentUrls()
saat membuat AdManagerAdRequest
:
Java
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();
Kotlin
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
yang digunakan untuk keamanan merek.