Targeting

Pilih platform: Android iOS Unity Flutter Android (Lama)

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.

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

Download Demo API

Prasyarat

Sebelum Anda melanjutkan, siapkan Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui instance bersama GADMobileAds. Kunci ini dapat diakses dengan kode berikut:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Menetapkan perlakuan berdasarkan usia

Untuk membantu Anda mengelola kepatuhan terhadap peraturan privasi yang berlaku terkait anak-anak dan remaja, Google Mobile Ads SDK menyediakan setelan perlakuan usia. Setelan perlakuan usia memungkinkan Anda menunjukkan apakah Google Mobile Ads SDK harus menerapkan perlindungan penayangan iklan tertentu untuk anak-anak, remaja, atau usia yang tidak ditentukan.

Anda dapat menetapkan perlakuan berdasarkan usia dengan properti ageRestrictedTreatment di GADRequestConfiguration.

Contoh berikut menunjukkan bahwa panggilan iklan akan menerima perlakuan usia anak:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

Untuk menunjukkan perlakuan usia remaja atau tidak ditentukan, ganti setelan .child dengan setelan berikut:

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Untuk menunjukkan perlakuan usia remaja atau tidak ditentukan, ganti setelan GADAgeRestrictedTreatmentChild dengan yang berikut:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

Saat menggunakan setelan ini, Google Mobile Ads SDK menyertakan parameter tfat dalam panggilan iklan. Berkonsultasilah dengan penasihat hukum Anda untuk menentukan perlakuan usia yang berlaku bagi pengguna berdasarkan kewajiban hukum dan peraturan Anda. Untuk mengetahui informasi selengkapnya, lihat Memberi tag pada panggilan iklan dari aplikasi untuk perlakuan pembatasan usia.

Bermigrasi ke perlakuan berdasarkan usia dari TFCD dan TFUA

Setelan perlakuan usia menggantikan properti tagForChildDirectedTreatment (TFCD) dan tagForUnderAgeOfConsent (TFUA) yang tidak digunakan lagi.

Tabel berikut menunjukkan setelan tagForChildDirectedTreatment dan tagForUnderAgeOfConsent serta perlakuan usia yang setara:

TFCD

tagForChildDirectedTreatment	Perlakuan berdasarkan usia
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Tidak ada nilai yang ditetapkan ke tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Tidak ada ekuivalen	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Perlakuan berdasarkan usia
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Tidak ada nilai yang ditetapkan ke tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
Tidak ada ekuivalen	GADAgeRestrictedTreatmentTeen

Memahami interaksi perlakuan berdasarkan usia dengan TFCD dan TFUA

Jika Anda menetapkan setelan perlakuan usia dan setelan TFCD atau TFUA, Google akan menerapkan perlakuan yang paling ketat.

Catatan: Pengguna yang login ke Akun Google yang dikelola dengan Family Link akan otomatis mendapatkan semua konten yang diperlakukan sebagai ditujukan untuk anak-anak untuk semua panggilan iklan.

Meneruskan perlakuan berdasarkan usia dengan Mediasi AdMob

Jika Anda menetapkan perlakuan berdasarkan usia menggunakan Google Mobile Ads SDK, adaptor mediasi meneruskan sinyal perlakuan berdasarkan usia ke SDK pihak ketiga yang dimediasi.

Tabel berikut mencantumkan versi adaptor mediasi yang mendukung penerusan sinyal perlakuan terbatas usia ke SDK pihak ketiga yang dimediasi:

Nama adaptor mediasi	Versi minimum yang didukung
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

Setelan yang ditujukan untuk anak-anak

Peringatan: Properti tagForChildDirectedTreatment tidak digunakan lagi. Sebagai gantinya, tetapkan properti ageRestrictedTreatment.

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 Anda sebagai ditujukan untuk anak-anak atau tidak saat membuat panggilan iklan. Saat 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 setelannya adalah sebagai berikut:

• Tetapkan tagForChildDirectedTreatment ke true untuk menunjukkan bahwa Anda ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak untuk tujuan COPPA. Tindakan ini mencegah pengiriman 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 Anda diperlakukan sehubungan dengan COPPA.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Dengan menetapkan tag ini, Anda menyatakan bahwa pemberitahuan ini akurat dan Anda berwenang untuk bertindak atas nama pemilik aplikasi. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian Akun Google Anda.

Pengguna di bawah usia dewasa

Peringatan: Properti tagForUnderAgeOfConsent tidak digunakan lagi. Sebagai gantinya, tetapkan properti ageRestrictedTreatment.

Anda dapat menandai permintaan iklan Anda untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang belum berusia dewasa. Fitur ini dirancang untuk membantu memfasilitasi kepatuhan terhadap General Data Protection Regulation (GDPR). Anda mungkin memiliki kewajiban hukum lainnya berdasarkan GDPR. Tinjau panduan Uni Eropa dan konsultasikan dengan penasihat hukum Anda. 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, parameter Tag untuk Pengguna di Bawah Usia Dewasa di Eropa (TFUA) akan disertakan dalam semua permintaan iklan mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk panggilan iklan yang bersangkutan. Permintaan ke 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 panggilan iklan ditangani dengan cara yang sesuai untuk pengguna di bawah usia dewasa. Tindakan ini juga mencegah transmisi ID Iklan, IDFA.
• Jika tidak menetapkan tagForUnderAgeOfConsent, berarti Anda tidak ingin permintaan iklan ditangani dengan cara yang sesuai untuk pengguna di bawah usia dewasa.

Contoh berikut menunjukkan bahwa Anda ingin TFUA disertakan dalam permintaan iklan Anda:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

Tag untuk mengaktifkan setelan untuk anak-anak dan tagForUnderAgeOfConsent tidak boleh ditetapkan secara bersamaan ke true. Jika demikian, setelan yang ditujukan untuk anak-anak akan diprioritaskan.

Poin Penting: Parameter tagForUnderAgeOfConsent ini tidak diteruskan ke adaptor mediasi untuk sumber iklan pihak ketiga. Anda bertanggung jawab untuk memastikan bahwa setiap jaringan iklan pihak ketiga di aplikasi Anda menayangkan iklan yang sesuai untuk pengguna yang berusia di bawah usia dewasa berdasarkan GDPR.

Pemfilteran konten iklan

Aplikasi dapat menetapkan rating konten iklan maksimum untuk semua panggilan iklan menggunakan properti maxAdContentRating dari GADRequestConfiguration. Setelan ini berlaku untuk semua permintaan iklan mendatang selama sisa sesi. Nilai yang mungkin untuk properti ini didasarkan pada klasifikasi label konten digital, dan harus berupa salah satu konstanta berikut:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Kode berikut mengonfigurasi semua panggilan iklan untuk menentukan bahwa konten iklan yang ditampilkan harus sesuai dengan penetapan Label Konten Digital yang tidak lebih tinggi dari GADMaxAdContentRatingGeneral.

Poin Penting: Setelan filter rating konten yang ditentukan melalui SDK akan menggantikan setelan apa pun yang dikonfigurasi menggunakan UI AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

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 panggilan iklan menggunakan properti publisherPrivacyPersonalizationState dari GADRequestConfiguration. Saat menggunakan fitur ini, parameter perlakuan privasi penayang (PPT) disertakan dalam semua permintaan iklan mendatang selama sisa sesi.

Secara default, permintaan iklan ke Google ditayangkan iklan yang dipersonalisasi. Kode berikut akan menonaktifkan personalisasi iklan untuk semua permintaan iklan:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Catatan: Untuk panggilan iklan dengan sinyal privasi multi-pengguna, sinyal yang paling ketat akan diprioritaskan. Lihat dokumentasi Publisher Privacy Treatment API untuk mengetahui contoh spesifik.

GADRequest

Objek GADRequest mengumpulkan informasi penargetan yang akan dikirim bersama permintaan iklan.

Menambahkan detail tambahan untuk jaringan

Detail tambahan untuk jaringan adalah detail tambahan yang dikirim dengan permintaan iklan yang spesifik untuk satu sumber iklan.

Cuplikan kode berikut menetapkan kunci parameter tambahan collapsible dengan nilai bottom ke Google:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

URL Konten

Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci agar sesuai dengan iklan beserta kontennya.

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 = Request()
request.contentURL = "https://www.example.com"

Objective-C

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

FAQ

Penargetan apa yang digunakan saat iklan dimuat ulang secara otomatis?

Saat penyegaran iklan, objek GADRequest yang ditentukan sebelumnya 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.