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.

Download Demo API

Prasyarat

Selesaikan panduan Memulai.

GADRequestConfiguration

GADRequestConfiguration adalah objek yang mengumpulkan informasi penargetan untuk diterapkan secara global melalui instance bersama GADMobileAds. 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), terdapat setelan yang disebut tagForChildDirectedTreatment.

Sebagai developer aplikasi, Anda dapat menunjukkan apakah Anda ingin agar Google memperlakukan konten 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 di permintaan iklan tersebut. Opsi setelannya adalah sebagai berikut:

• Setel tagForChildDirectedTreatment ke true untuk menunjukkan bahwa Anda ingin konten diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA. Hal ini mencegah pengiriman ID Iklan, IDFA.
• Setel tagForChildDirectedTreatment ke false untuk menunjukkan bahwa Anda tidak ingin konten Anda diperlakukan sebagai ditujukan untuk anak-anak sesuai tujuan COPPA.
• Jangan setel tagForChildDirectedTreatment jika Anda tidak ingin menunjukkan bagaimana Anda ingin konten Anda diperlakukan sehubungan dengan COPPA.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Dengan menyetel 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 di Wilayah Ekonomi Eropa (EEA) yang berada di bawah usia dewasa. 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. Perlu diperhatikan bahwa alat Google dirancang untuk memfasilitasi kepatuhan dan tidak menghilangkan kewajiban penayang tertentu berdasarkan hukum tersebut. Pelajari lebih lanjut pengaruh GDPR terhadap penayang.

Saat menggunakan fitur ini, Tag Untuk Pengguna yang berusia di bawah parameter Usia Dewasa 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 di bawah usia dewasa.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

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 memungkinkan 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 tidak lebih tinggi dari GADMaxAdContentRatingGeneral.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

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

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

Swift

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

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Catatan: Untuk permintaan iklan dengan beberapa sinyal privasi pengguna, sinyal yang paling ketat akan diutamakan. Lihat dokumentasi Publisher Privacy Treatment API untuk mengetahui contoh spesifik.

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 untuk mencocokkan iklan dengan 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:

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, setel penargetan kustom dengan nilai kunci dalam permintaan iklan. Item baris yang menargetkan nilai kunci tersebut akan memenuhi syarat untuk ditayangkan untuk 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 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 satu 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"];

Poin Penting: Hanya empat URL pertama yang digunakan oleh SDK. Yang lainnya akan diabaikan.

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.

Catatan: Fitur ini tidak tersedia untuk semua penayang. Lihat Tentang ID yang diberikan penayang untuk mengetahui detailnya.

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

Swift

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)

Objective-C

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 pemuatan ulang 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.