Panduan ini menjelaskan cara menyediakan informasi penargetan untuk permintaan iklan.
Untuk melihat penargetan iklan beraksi, download aplikasi iOS API Demo di Swift atau Objective-C.
Prasyarat
Selesaikan panduan Memulai.
GADRequestConfiguration
GADRequestConfiguration
adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui
instance bersama
GADMobileAds
. Kode 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 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 konten yang ditujukan untuk anak-anak, Google akan mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut. Opsi setelan adalah sebagai berikut:
- Setel
tagForChildDirectedTreatment
ketrue
untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA. Hal ini mencegah transmisi ID Iklan, IDFA. - Tetapkan
tagForChildDirectedTreatment
kefalse
untuk menunjukkan bahwa Anda tidak ingin konten diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. - Jangan tetapkan
tagForChildDirectedTreatment
jika Anda tidak ingin menunjukkan cara Anda ingin konten diperlakukan sehubungan dengan COPPA.
Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai konten yang 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 diotorisasi untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian Akun Google Anda.
Pengguna yang berusia 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. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda sendiri. Perhatikan bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak membebaskan penayang tertentu dari kewajibannya berdasarkan hukum. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.
Saat menggunakan fitur ini, Tag Untuk Pengguna yang berusia di bawah parameter Usia Dewasa di Eropa (TFUA) akan disertakan dalam semua permintaan iklan 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 menetapkan properti tagForUnderAgeOfConsent
pada objek GADMobileAds.requestConfiguration
dan meneruskan true
.
- Tetapkan
tagForUnderAgeOfConsent
ketrue
untuk menunjukkan bahwa Anda ingin permintaan iklan ditangani dengan cara yang sesuai untuk pengguna yang berusia di bawah usia dewasa. Tindakan ini juga mencegah transmisi ID Iklan, IDFA. - Tidak menetapkan
tagForUnderAgeOfConsent
menunjukkan bahwa Anda tidak ingin permintaan iklan ditangani dengan cara yang sesuai untuk pengguna yang berusia di bawah usia dewasa.
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 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 mendatang selama sisa sesi. Kemungkinan nilai
untuk properti ini didasarkan pada klasifikasi label
konten digital, dan harus berupa 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;
Perlakuan Privasi Penayang (Beta)
Publisher Privacy Treatment
(PPT) API adalah alat opsional yang memungkinkan aplikasi menunjukkan apakah akan menonaktifkan personalisasi
iklan untuk semua permintaan iklan menggunakan properti
publisherPrivacyPersonalizationState
GADRequestConfiguration
. Saat menggunakan fitur ini, parameter perlakuan privasi penayang (PPT) disertakan dalam semua permintaan iklan mendatang untuk
sisa sesi.
Secara default, permintaan iklan ke Google menayangkan iklan yang dipersonalisasi. Kode berikut menonaktifkan personalisasi iklan untuk semua permintaan iklan:
Swift
GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GAMRequest
Objek GAMRequest
mengumpulkan informasi penargetan untuk dikirim bersama permintaan iklan.
URL Konten
Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci agar sesuai dengan iklan beserta 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 = GAMRequest()
request.contentURL = "https://www.example.com"
Objective-C
GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";
Penargetan kustom
Setelah mengonfigurasi key-value pair di UI Ad Manager, setel penargetan kustom dengan nilai kunci dalam permintaan iklan. Item baris yang menargetkan nilai kunci tersebut akan memenuhi syarat untuk ditayangkan untuk permintaan iklan tersebut. Untuk menargetkan beberapa nilai untuk satu kunci, masukkan nilai sebagai string yang dipisahkan koma.
Swift
let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];
Objective-C
GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};
Keamanan merek (Beta)
Aplikasi yang menampilkan konten dinamis yang ditujukan untuk berbagai audiens dapat memberikan
daftar singkat URL melalui properti neighboringContentURLs
. URL konten
tetangga berbeda dengan properti contentURL
karena hanya digunakan
untuk keamanan merek.
Misalkan aplikasi Anda menampilkan konten dari empat URL dalam satu feed yang juga berisi iklan. Anda dapat meminta iklan yang memiliki rating konten serupa dengan URL tersebut dengan meneruskannya seperti berikut:
Swift
let request = GAMRequest()
request.neighboringContentURLs =
["https://www.example1.com", "https://www.example2.com",
"https://www.example3.com", "https://www.example4.com"]
Objective-C
GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
@[@"https://www.example1.com", @"https://www.example2.com",
@"https://www.example3.com", @"https://www.example4.com"];
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.
Penetapan PPID dilakukan melalui GAMRequest
:
Swift
let request = GAMRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
Lihat contoh PPID Ad Manager untuk implementasi ID yang diberikan penayang (PPID) di aplikasi iOS API Demo:
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) dan data kontekstual ( Taksonomi Konten IAB 2.2).
Swift
let extras = GADExtras()
extras.additionalParameters = [
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
"IAB_AUDIENCE_1_1": [6, 284],
// Set the content to sedan, station wagon and SUV automotive values.
"IAB_CONTENT_2_2": [4, 5, 6]
]
let request = GAMRequest()
request.register(extras)
Objective-C
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
@"IAB_AUDIENCE_1_1":@[@6, @284],
// Set the content to sedan, station wagon and SUV automotive values.
@"IAB_CONTENT_2_2":@[@4,@5,@6]
};
GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];
FAQ
- Penargetan apa yang akan digunakan saat iklan dimuat ulang secara otomatis?
- Pada saat iklan dimuat ulang, objek
GAMRequest
yang sebelumnya ditentukan akan digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggilloadRequest
secara eksplisit diGAMBannerView
dengan objekGAMRequest
baru. - Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?
- Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.