Halaman ini diterjemahkan oleh Cloud Translation API.

Penargetan

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.

Untuk melihat cara kerja penargetan iklan, download aplikasi iOS API Demo di Swift atau Objective-C.

Prasyarat

Selesaikan panduan Memulai.

Konfigurasi GWSRequest

GADRequestConfiguration adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui instance GADMobileAds bersama. 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 mematuhi 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 Anda sebagai konten yang 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 akan mengambil langkah untuk menonaktifkan PMM dan iklan pemasaran ulang di permintaan iklan tersebut. Opsi setelannya adalah sebagai berikut:

Setel tagForChildDirectedTreatment ke YES untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Tindakan ini akan mencegah transmisi ID Iklan, IDFA.
Setel tagForChildDirectedTreatment ke NO untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA.
Jangan menetapkan tagForChildDirectedTreatment jika Anda tidak ingin menunjukkan cara 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.tag(forChildDirectedTreatment: true)

Objective-C

[GADMobileAds.sharedInstance.requestConfiguration tagForChildDirectedTreatment:YES];

Dengan menyetel tag ini, Anda menyatakan bahwa notifikasi 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 belum berusia 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. Harap diingat bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang tertentu berdasarkan hukum tersebut. Pelajari lebih lanjut cara GDPR memengaruhi penayang.

Saat menggunakan fitur ini, tag untuk Pengguna yang berusia di bawah Usia Dewasa di parameter (TFUA) akan disertakan dalam semua permintaan iklan di masa mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk permintaan iklan tertentu 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 ke YES atau true untuk menunjukkan bahwa Anda ingin permintaan iklan ditangani dengan cara yang sesuai untuk pengguna yang berusia di bawah usia dewasa. Tindakan ini juga akan mencegah transmisi ID Iklan, IDFA.
Jika tagForUnderAgeOfConsent tidak ditetapkan, 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 ditetapkan secara bersamaan ke true. Jika ya, 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 GADRequestConfiguration. Setelan ini berlaku untuk semua permintaan iklan berikutnya selama sisa sesi. Nilai yang memungkinkan untuk properti ini didasarkan pada klasifikasi label konten digital, dan harus merupakan salah satu dari 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;

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 sambil 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, tetapkan penargetan kustom dengan nilai kunci yang diinginkan dalam permintaan iklan. Item baris yang menargetkan nilai kunci tersebut akan memenuhi syarat untuk ditayangkan ke 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 menyediakan daftar singkat URL melalui properti neighboringContentURLs. URL konten di sekitar berbeda dengan properti contentURL karena hanya digunakan untuk keamanan merek.

Misalkan aplikasi Anda menampilkan konten dari empat URL dalam 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 di seluruh perangkat.

Menyetel 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 Demo API iOS:

Swift Objective-C

FAQ

Penargetan apa yang akan digunakan saat iklan diperbarui secara otomatis?: Saat refresh iklan, objek GAMRequest yang ditentukan sebelumnya digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggil loadRequest secara eksplisit pada GAMBannerView dengan objek GAMRequest baru.
Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?: Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.