Targeting

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

let requestConfiguration = MobileAds.shared.requestConfiguration

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:

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

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

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 perlakuan berdasarkan usia pada panggilan iklan.

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:

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.

Meneruskan perlakuan berdasarkan usia dengan mediasi

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

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

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 Anda sebagai ditujukan untuk anak-anak atau tidak saat membuat panggilan iklan. Jika Anda menunjukkan bahwa Anda ingin Google memperlakukan konten Anda sebagai ditujukan untuk anak-anak, Google akan mengambil langkah-langkah untuk menonaktifkan iklan 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 sesuai dengan 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:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

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

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 sendiri. 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 panggilan iklan mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk permintaan iklan tersebut. 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:

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

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.

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.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

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, panggilan iklan ke Google menayangkan iklan yang dipersonalisasi. Kode berikut menonaktifkan personalisasi iklan untuk semua permintaan iklan:

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

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

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:

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

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

Penargetan kustom

Setelah mengonfigurasi pasangan nilai kunci di UI Ad Manager, tetapkan penargetan kustom dengan nilai kunci dalam permintaan iklan. Item baris yang menargetkan nilai kunci tersebut kemudian akan memenuhi syarat untuk ditayangkan ke panggilan iklan tersebut. Untuk menargetkan beberapa nilai untuk satu kunci, masukkan nilai sebagai string yang dipisahkan koma.

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

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 yang berdekatan 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 ini:

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

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.

PPID ditetapkan melalui GAMRequest:

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Lihat contoh PPID Ad Manager untuk penerapan ID yang diberikan penayang (PPID) di aplikasi Demo iOS API:

Swift Objective-C

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) serta data kontekstual (Taksonomi Konten IAB 2.2).

let extras = Extras()
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 = AdManagerRequest()
request.register(extras)

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 digunakan saat iklan dimuat ulang secara otomatis?

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

Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?

Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.