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 {i>Objective<i}-C.

Download Demo API

Prasyarat

Selesaikan panduan Memulai.

GADRequestConfiguration

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

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Setelan yang ditujukan untuk anak-anak

Untuk tujuan Children's Online Privacy Protection Act (COPPA), ada pengaturan yang disebut tagForChildDirectedTreatment

Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin Google memperlakukan konten sebagai ditujukan untuk anak-anak saat Anda membuat permintaan iklan. Ketika Anda menyatakan bahwa Anda ingin agar Google memperlakukan konten sebagai ditujukan untuk anak-anak, Google akan mengambil langkah-langkah untuk menonaktifkan IBA dan iklan pemasaran ulang di permintaan iklan tersebut. Opsi setelannya adalah sebagai berikut:

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

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

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

Pengguna yang berusia di bawah usia dewasa

Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa. Fitur ini yang dirancang untuk membantu memfasilitasi kepatuhan terhadap Peraturan Perlindungan Data (GDPR). Perhatikan bahwa Anda mungkin memiliki 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 menghilangkan kewajiban penayang mana pun berdasarkan hukum. Pelajari lebih lanjut pengaruh GDPR penayang.

Saat menggunakan fitur ini, Tag Untuk Pengguna yang berusia di bawah Usia Dewasa di Parameter Eropa (TFUA) akan disertakan dalam semua permintaan iklan mendatang. Parameter ini menonaktifkan iklan yang dipersonalisasi, termasuk pemasaran ulang, untuk permintaan iklan spesifik tersebut. Permintaan untuk vendor iklan pihak ketiga juga dinonaktifkan, seperti piksel pengukuran iklan dan server iklan pihak ketiga.

Setelan ini dapat digunakan dengan semua versi Google Mobile Ads SDK dengan menyetel tagForUnderAgeOfConsent di Objek GADMobileAds.requestConfiguration dan meneruskan true.

• Tetapkan tagForUnderAgeOfConsent ke true untuk menunjukkan bahwa Anda menginginkan iklan permintaan ditangani dengan cara yang sesuai untuk pengguna di bawah usia persetujuan. Hal ini juga mencegah transmisi Iklan ID, IDFA.
• Tidak menetapkan tagForUnderAgeOfConsent menunjukkan bahwa Anda tidak menginginkan iklan permintaan ditangani dengan cara yang sesuai untuk pengguna di bawah usia persetujuan.

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 yang 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 berikutnya selama sisa sesi tersebut. Nilai yang mungkin untuk properti ini didasarkan pada label konten digital klasifikasi, dan harus berupa salah satu dari konstanta berikut ini:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Kode berikut mengonfigurasi semua permintaan iklan untuk menetapkan konten iklan tersebut dikembalikan harus sesuai dengan penetapan Label Konten Digital tidak lebih dari GADMaxAdContentRatingGeneral.

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Perlakuan Privasi Penayang (Beta)

Tujuan Perlakuan Privasi Penayang (PPT) API adalah alat opsional yang memungkinkan aplikasi menunjukkan apakah akan menonaktifkan iklan atau tidak personalisasi untuk semua permintaan iklan yang menggunakan publisherPrivacyPersonalizationState properti GADRequestConfiguration. Saat menggunakan fitur ini, penayang parameter perlakuan privasi (PPT) disertakan dalam semua permintaan iklan mendatang untuk sisa sesi ini.

Secara default, permintaan iklan ke Google menayangkan iklan yang dipersonalisasi. Hal berikut kode menonaktifkan personalisasi iklan untuk semua permintaan iklan:

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

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

Objek GAMRequest mengumpulkan penargetan informasi untuk dikirim bersama permintaan iklan.

URL Konten

Saat meminta iklan, aplikasi dapat meneruskan URL konten yang ditampilkan. Hal ini memungkinkan penargetan kata kunci untuk mencocokkan iklan dengan 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:

let request = GAMRequest()
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, setel penargetan dengan nilai kunci dalam permintaan iklan. Item baris yang menargetkan kunci tersebut selanjutnya valid untuk ditayangkan ke permintaan iklan tersebut. Untuk menargetkan beberapa nilai untuk satu kunci, masukkan nilai sebagai string yang dipisahkan koma.

let request = GAMRequest()
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. Tetangga URL konten berbeda dari 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:

let request = GAMRequest()
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, dan kontrol penayangan iklan berbasis audiens di berbagai perangkat.

Penyetelan PPID dilakukan melalui GAMRequest:

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

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

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

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 mengomunikasikan karakteristik audiens Anda kepada bidder di semua jenis transaksi, menggunakan taksonomi standar, tanpa perlu membagikan ID pengguna. Audiens Anda karakteristik dapat mencakup data perilaku dan berbasis minat ( Taksonomi Audiens IAB 1.1) dan data kontekstual ( Taksonomi Konten IAB 2.2).

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)

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?

Saat pembaruan iklan, atribut yang ditentukan sebelumnya Objek GAMRequest digunakan untuk penargetan lagi. Untuk menetapkan penargetan baru, panggil loadRequest secara eksplisit di GAMBannerView dengan GAMRequest.

Bagaimana cara meneruskan parameter penargetan tambahan ke jaringan mediasi?

Lihat Mediasi untuk mengetahui cara mengirim penargetan ke jaringan mediasi.