Targeting

Pilih platform: Android iOS Unity Flutter

Panduan ini menjelaskan cara memberikan informasi penargetan ke permintaan iklan.

Untuk melihat penargetan iklan dalam tindakan, download aplikasi Demo API iOS 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. Objek ini dapat diakses dengan kode berikut:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Menetapkan perlakuan 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 atau remaja. Saat menggunakan setelan ini, Google Mobile Ads SDK menyertakan parameter tfat dalam permintaan iklan. Konsultasikan dengan penasihat hukum Anda untuk menentukan perlakuan usia yang berlaku bagi pengguna Anda berdasarkan kewajiban hukum dan peraturan Anda.

Anda dapat menetapkan perlakuan usia dengan properti ageRestrictedTreatment di GADRequestConfiguration.

Menetapkan perlakuan usia anak

Contoh berikut menunjukkan bahwa permintaan iklan harus menerima perlakuan usia anak:

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

Menetapkan perlakuan remaja

Contoh berikut menunjukkan bahwa permintaan iklan harus menerima perlakuan remaja:

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

Menetapkan tidak ada perlakuan usia tertentu

Contoh berikut menunjukkan bahwa permintaan iklan tidak boleh menerima perlakuan usia tertentu:

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

Bermigrasi ke perlakuan 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 usia
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Tidak ada nilai yang ditetapkan ke tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Tidak ada ekuivalen	GADAgeRestrictedTreatmentTeen

TFUA

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

Memahami interaksi perlakuan usia dengan TFCD dan TFUA

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

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

Setelan 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. 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 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 akan 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 bagaimana 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:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

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 di bawah usia legal

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

Anda dapat menandai permintaan iklan untuk menerima perlakuan bagi pengguna yang berusia di bawah usia legal di Wilayah Ekonomi Eropa (EEA). Fitur ini adalah 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 tanyakan kepada konsultan hukum Anda. Perlu diingat bahwa 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 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 khusus 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 legal. Tindakan ini juga akan 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 legal.

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

Poin Penting:Parameter ini tidak diteruskan ke adaptor mediasi untuk sumber iklan pihak ketiga.tagForUnderAgeOfConsent 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 legal berdasarkan 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 mendatang selama sesi. Nilai yang mungkin untuk properti ini didasarkan pada klasifikasi label konten digital, dan harus 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.

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

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

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

GAMRequest

Objek GAMRequest mengumpulkan informasi penargetan yang akan dikirim dengan permintaan iklan.

Menambahkan detail tambahan jaringan

Detail tambahan jaringan adalah detail tambahan yang dikirim dengan permintaan iklan yang khusus 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

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

Swift

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

Objective-C

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 valid untuk ditayangkan ke permintaan iklan tersebut. Untuk menargetkan beberapa nilai untuk satu kunci, masukkan nilai sebagai string yang dipisahkan koma.

Swift

let request = AdManagerRequest()
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 tetangga berbeda dengan properti contentURL karena hanya digunakan untuk keamanan merek.

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

Swift

let request = AdManagerRequest()
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. Semua URL 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.

Penetapan PPID dilakukan melalui GAMRequest:

Swift

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

Objective-C

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

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

Swift

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)

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 digunakan saat iklan otomatis diperbarui?

Saat iklan diperbarui, objek GAMRequest yang sebelumnya ditentukan akan digunakan lagi untuk penargetan. 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.