Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.
Untuk melihat cara kerja penargetan iklan, download aplikasi Demo API iOS di Objective-C atau Swift.
Prasyarat
Selesaikan panduan Memulai.
GADRequestConfiguration
GADRequestConfiguration
adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui
instance
GADMobileAds
yang dibagikan.
Ini dapat diakses melalui 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 setelan yang disebut tagForChildDirectedTreatment
.
Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin agar Google memperlakukan konten sebagai 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 mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut. Opsi setelan adalah sebagai berikut:
- Setel
tagForChildDirectedTreatment
keYES
untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Tindakan ini akan mencegah pengiriman ID Iklan, IDFA. - Setel
tagForChildDirectedTreatment
keNO
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 cara konten Anda diperlakukan sehubungan dengan COPPA.
Swift
GADMobileAds.sharedInstance().requestConfiguration.tag(forChildDirectedTreatment: true)
Objective-C
[GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment:YES];
Dengan menetapkan tag ini, Anda menyatakan bahwa notifikasi ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat mengakibatkan penghentian Akun Google Anda.
Pengguna 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). Perlu diperhatikan bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Harap tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. Perlu diingat bahwa 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, tag Untuk Pengguna yang berusia di bawah Usia Dewasa di TFUA (parameter usia di Eropa) akan disertakan dalam semua permintaan iklan di masa mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk permintaan iklan tersebut. Permintaan untuk vendor iklan pihak ketiga, seperti piksel pengukuran iklan dan server iklan pihak ketiga, juga dinonaktifkan.
Setelan ini dapat digunakan dengan semua versi Google Mobile Ads SDK dengan
memanggil metode tagForUnderAgeOfConsent
pada objek
GADMobileAds.requestConfiguration
dan meneruskan YES
.
- Tetapkan
tagForUnderAgeOfConsent
keYES
atautrue
untuk menunjukkan bahwa Anda ingin permintaan iklan ditangani dengan cara yang sesuai bagi pengguna di bawah usia dewasa. Hal ini juga akan mencegah transmisi ID Iklan, IDFA. - Tidak menyetel
tagForUnderAgeOfConsent
menunjukkan bahwa Anda tidak ingin permintaan iklan ditangani dengan cara yang sesuai bagi pengguna yang berusia di bawah usia dewasa.
Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan Anda:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent(true);
Objective-C
[GADMobileAds.sharedInstance.requestConfiguration tagForUnderAgeOfConsent:YES];
Tag untuk mengaktifkan setelan ditujukan untuk anak-anak
dan tagForUnderAgeOfConsent
tidak boleh disetel secara bersamaan ke true
.
Jika demikian, setelan yang ditujukan untuk anak-anak akan diutamakan.
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. Kemungkinan nilai untuk properti ini didasarkan pada klasifikasi label konten digital, dan harus merupakan salah satu konstanta berikut:
GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience
Kode berikut mengonfigurasi semua permintaan iklan untuk menentukan bahwa konten iklan yang ditampilkan harus sesuai dengan penetapan Label Konten Digital yang tidak lebih tinggi dari GADMaxAdContentRatingGeneral
.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
GADRequest
Objek GADRequest
mengumpulkan informasi penargetan untuk dikirim bersama permintaan
iklan.
URL Konten
Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditayangkan. Hal ini memungkinkan penargetan kata kunci dicocokkan dengan iklan dengan konten.
Misalnya, jika aplikasi Anda meminta iklan saat 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 diperbarui secara otomatis?
- Saat iklan dimuat ulang, objek
GADRequest
yang ditentukan sebelumnya digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggilloadRequest
padaGADBannerView
dengan objekGADRequest
baru secara eksplisit. - Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?
- Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.