Panduan ini menjelaskan cara menyediakan informasi penargetan untuk permintaan iklan.
Untuk melihat cara kerja penargetan iklan, download aplikasi iOS API Demo di Swift atau {i>Objective<i}-C.
Prasyarat
Selesaikan panduan Memulai.
GADRequestConfiguration
GADRequestConfiguration
adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui
tindakan
GADMobileAds
instance bersama. Ini dapat diakses dengan kode berikut:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Setelan yang ditujukan untuk anak-anak
Untuk tujuan Children's Online Privacy Protection Act
(COPPA),
ada pengaturan yang disebut
tagForChildDirectedTreatment
Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin Google memperlakukan konten sebagai ditujukan untuk anak-anak saat Anda membuat permintaan iklan. Ketika Anda menyatakan bahwa Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak, Google akan mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut. Opsi setelannya adalah sebagai berikut:
- Setel
tagForChildDirectedTreatment
ketrue
untuk menunjukkan bahwa Anda menginginkan konten diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Hal ini mencegah ID Iklan, IDFA. - Setel
tagForChildDirectedTreatment
kefalse
untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. - Jangan tetapkan
tagForChildDirectedTreatment
jika Anda tidak ingin menunjukkan caranya Anda ingin konten Anda diperlakukan sehubungan dengan COPPA.
Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
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.
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 tertentu berdasarkan hukum. Pelajari lebih lanjut pengaruh GDPR penayang.
Saat menggunakan fitur ini, Tag Untuk Pengguna yang berusia di bawah Usia Dewasa di Parameter Eropa (TFUA) akan disertakan dalam semua permintaan iklan mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk permintaan iklan spesifik tersebut. Permintaan untuk vendor iklan pihak ketiga juga dinonaktifkan, seperti piksel pengukuran iklan dan server iklan pihak ketiga.
Setelan ini dapat digunakan dengan semua versi Google Mobile Ads SDK dengan
menyetel
tagForUnderAgeOfConsent
di
Objek GADMobileAds.requestConfiguration
dan meneruskan true
.
- Tetapkan
tagForUnderAgeOfConsent
ketrue
untuk menunjukkan bahwa Anda menginginkan iklan permintaan ditangani dengan cara yang sesuai untuk pengguna di bawah usia persetujuan. Hal ini juga mencegah transmisi Iklan ID, IDFA. - Tidak menetapkan
tagForUnderAgeOfConsent
menunjukkan bahwa Anda tidak menginginkan iklan permintaan ditangani dengan cara yang sesuai untuk pengguna di bawah usia persetujuan.
Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
Tag untuk mengaktifkan setelan yang ditujukan untuk anak-anak
dan tagForUnderAgeOfConsent
tidak boleh ditetapkan secara bersamaan ke true
.
Jika ya, setelan ditujukan untuk anak-anak akan diprioritaskan.
Pemfilteran konten iklan
Aplikasi dapat menetapkan rating konten iklan maksimum untuk semua permintaan iklan menggunakan
Properti maxAdContentRating
dari GADRequestConfiguration
. Setelan ini berlaku
untuk semua permintaan iklan berikutnya selama sisa sesi tersebut. Nilai yang mungkin
untuk properti ini didasarkan pada label konten digital
klasifikasi, dan harus merupakan salah satu
dari konstanta berikut ini:
GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience
Kode berikut mengonfigurasi semua permintaan iklan untuk menetapkan konten iklan tersebut
dikembalikan harus sesuai dengan penetapan Label Konten Digital tidak lebih dari
GADMaxAdContentRatingGeneral
.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
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
publisherPrivacyPersonalizationState
properti GADRequestConfiguration
. Saat menggunakan fitur ini, penayang
parameter perlakuan privasi (PPT) disertakan dalam semua permintaan iklan mendatang untuk
sisa sesi ini.
Secara default, permintaan iklan ke Google menayangkan iklan yang dipersonalisasi. Hal berikut kode menonaktifkan personalisasi iklan untuk semua permintaan iklan:
Swift
GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GADRequest
Objek GADRequest
mengumpulkan penargetan
informasi untuk dikirim bersama permintaan iklan.
URL Konten
Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci untuk mencocokkan iklan dengan konten.
Misalnya, jika aplikasi Anda meminta iklan sambil menampilkan konten dari
https://www.example.com
, Anda dapat meneruskan URL ini untuk menargetkan kata kunci yang relevan:
Swift
let request = GADRequest()
request.contentURL = "https://www.example.com"
Objective-C
GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";
FAQ
- Penargetan apa yang akan digunakan saat iklan dimuat ulang secara otomatis?
- Saat pembaruan iklan, atribut yang ditentukan sebelumnya
Objek
GADRequest
digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggilloadRequest
secara eksplisit diGADBannerView
denganGADRequest
. - Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?
- Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.