Nilai kunci dapat digunakan untuk menargetkan iklan secara lebih terperinci daripada unit iklan. Pelajari nilai kunci lebih lanjut.
Untuk setiap permintaan iklan, Anda dapat meneruskan satu atau beberapa kunci, masing-masing dengan satu atau beberapa
nilai terkait. Nilai kunci ini akan dievaluasi berdasarkan opsi penargetan
yang dikonfigurasi di tingkat item baris di Ad Manager. Misalnya, jika
Anda meneruskan nilai kunci kustom age=18-34, item baris yang ditargetkan ke rentang usia
18-34 akan memenuhi syarat untuk ditayangkan, dengan mengasumsikan semua kriteria lainnya cocok.
Menetapkan penargetan
Anda dapat menentukan nilai kunci untuk mengonfigurasi penargetan di tingkat slot dan halaman berdasarkan kebutuhan jaringan Anda.
- Tingkat slot
Memungkinkan Anda menetapkan nilai kunci untuk setiap slot iklan di halaman.
Penargetan tingkat slot memungkinkan Anda mengonfigurasi penargetan berdasarkan per slot. Hal ini berguna jika setiap slot di halaman yang sama memerlukan penargetan yang berbeda, tetapi dapat menjadi tidak efisien jika nilai kunci yang sama diterapkan ke semua slot. Gunakan Slot.setTargeting() untuk menggunakan penargetan tingkat slot, seperti dalam contoh berikut.
- Tingkat halaman
Memungkinkan Anda menetapkan nilai kunci di semua slot iklan di halaman.
Penargetan tingkat halaman memastikan bahwa semua slot iklan memiliki kumpulan nilai kunci yang sama. Dalam beberapa kasus, hal ini dapat mengurangi jumlah total kode yang diperlukan untuk mengonfigurasi penargetan. Gunakan googletag.pubads().setTargeting() untuk menggunakan penargetan tingkat halaman, seperti dalam contoh berikut.
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta
name="description"
content="Use key-value targeting to control the ads eligible to serve to specific ad slots."
/>
<title>Key-value targeting</title>
<script
async
src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
crossorigin="anonymous"
></script>
<script>
window.googletag = window.googletag || { cmd: [] };
// GPT slots
let adSlots = [];
googletag.cmd.push(() => {
// Configure slot-level targeting.
adSlots[0] = googletag
.defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-1")
.addService(googletag.pubads())
.setTargeting("color", "red")
.setTargeting("position", "atf");
adSlots[1] = googletag
.defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-2")
.addService(googletag.pubads())
.setTargeting("position", "btf");
// Configure page-level targeting.
googletag.pubads().setTargeting("interests", "basketball");
// Enable SRA and services.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
</script>
</head>
Dalam contoh ini, dua slot iklan ditentukan yang menentukan unit iklan
/6355419/Travel/Asia dan ukuran iklan 728x90. Kemudian, penargetan nilai kunci
diterapkan untuk lebih membatasi dan membedakan iklan yang dapat ditayangkan di setiap
slot.
Saat penargetan tingkat slot dan halaman digunakan, nilai kunci akan digabungkan dan hanya iklan yang memenuhi semua kriteria yang akan memenuhi syarat untuk ditayangkan ke slot tertentu. Dalam contoh ini, penargetan efektif untuk setiap slot adalah:
| Slot iklan | Penargetan yang efektif |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Menargetkan beberapa kunci atau nilai
Pada contoh sebelumnya, kombinasi penargetan tingkat slot dan halaman digunakan untuk menentukan beberapa kunci penargetan untuk satu slot iklan. Berikut beberapa pendekatan alternatif untuk mencapai penargetan yang efektif dan sama:
Khusus penargetan tingkat slot
Dalam contoh ini, nilai kunci bersama diulang untuk setiap slot iklan.
// Slot-level targeting with multiple keys.
adSlots[0] = googletag
.defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
.addService(googletag.pubads())
.setTargeting('color', 'red')
.setTargeting('position', 'atf')
.setTargeting('interests', 'basketball');
adSlots[1] = googletag
.defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
.addService(googletag.pubads())
.setTargeting('position', 'btf')
.setTargeting('interests', 'basketball');
Penargetan default tingkat halaman
Dalam contoh ini, penargetan default ditetapkan di tingkat halaman dan diganti di tingkat slot sesuai kebutuhan.
// Page-level default targeting.
googletag.pubads().setTargeting('interests', 'basketball')
.setTargeting('position', 'btf');
// Slot-level targeting overrides.
adSlots[0] = googletag
.defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
.addService(googletag.pubads())
.setTargeting('color', 'red')
.setTargeting('position', 'atf');
adSlots[1] = googletag
.defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
.addService(googletag.pubads());
Anda juga dapat menargetkan beberapa nilai untuk satu kunci dengan menyediakan
array nilai saat memanggil setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Penargetan yang jelas
Setelah penargetan ditetapkan, nilai kunci yang dikonfigurasi akan dikirim dengan setiap permintaan iklan selama masa aktif slot iklan. Namun, dalam beberapa situasi, sebaiknya
penargetan berubah dari waktu ke waktu. Meskipun setTargeting() dapat
digunakan untuk menambahkan dan menimpa nilai kunci, Anda tidak dapat menghapusnya dengan cara ini.
Untuk melakukannya, Slot.clearTargeting() atau
googletag.pubads().clearTargeting() harus
digunakan sebagai gantinya.
// Step 0, define slot- and page-level targeting.
adSlots[0] = googletag
.defineSlot("/6355419/Travel/Asia", [728, 90], "banner-ad-1")
.addService(googletag.pubads())
.setTargeting("color", "red")
.setTargeting("position", "atf");
googletag.pubads().setTargeting("interests", "basketball");
// Step 1, clear slot-level color targeting.
adSlots[0].clearTargeting("color");
// Step 2, clear all page-level targeting.
googletag.pubads().clearTargeting();
Saat clearTargeting() dipanggil dengan kunci tertentu (baik di
level slot maupun halaman), hanya kunci tersebut yang akan dihapus. Jika tidak ada kunci yang ditentukan, semua penargetan di tingkat tersebut akan dihapus.
Dalam contoh sebelumnya, penargetan efektif untuk slot iklan setelah setiap langkah adalah:
| Langkah | Penargetan yang efektif |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |