Penargetan

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.

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

Mendownload Demo API

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:

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Untuk memastikan bahwa semua permintaan iklan menerapkan perubahan konfigurasi permintaan, tetapkan konfigurasi permintaan sebelum Anda Melakukan inisialisasi Mobile Ads SDK.

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 Google memperlakukan konten Anda 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, Google akan mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang pada permintaan iklan tersebut. Opsi setelan adalah sebagai berikut:

• Tetapkan tagForChildDirectedTreatment ke true untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Hal ini mencegah transmisi ID Iklan, IDFA.
• Tetapkan tagForChildDirectedTreatment ke false 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 Anda ingin konten diperlakukan sehubungan dengan COPPA.

Contoh berikut menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai konten untuk anak-anak untuk tujuan COPPA:

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

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 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 diketahui bahwa Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. 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, parameter Tag untuk Pengguna yang Berusia di bawah Usia Legal 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 ke true 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:

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Tag untuk mengaktifkan setelan ditujukan untuk anak-anak dan tagForUnderAgeOfConsent tidak boleh ditetapkan secara bersamaan ke true. Jika demikian, setelan yang 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.

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

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 akan menonaktifkan personalisasi iklan untuk semua permintaan iklan:

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

Objek GADRequest 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:

let request = GADRequest()
request.contentURL = "https://www.example.com"

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

FAQ

Penargetan apa yang digunakan saat iklan dimuat ulang secara otomatis?

Saat iklan dimuat ulang, objek GADRequest yang ditentukan sebelumnya akan digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggil loadRequest secara eksplisit di GADBannerView dengan objek GADRequest baru.

Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?

Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.