Nilai kunci dapat digunakan untuk menargetkan iklan secara lebih terperinci daripada unit iklan. Pelajari lebih lanjut tentang nilai kunci.
Untuk setiap permintaan iklan, Anda dapat meneruskan satu atau beberapa kunci, masing-masing dengan satu atau beberapa kunci
nilai-nilai yang terkait. Nilai kunci ini akan dievaluasi berdasarkan opsi penargetan
dikonfigurasi pada tingkat item baris di Ad Manager. Misalnya, jika
Anda meneruskan nilai kunci kustom sebesar age=18-34, item baris yang ditargetkan ke rentang usia
Pengguna berusia 18-34 tahun akan memenuhi syarat untuk menayangkan iklan, dengan asumsi semua kriteria lainnya cocok.
Tetapkan penargetan
Anda dapat menetapkan nilai kunci untuk mengonfigurasi penargetan di slot- dan pada tingkat halaman dengan kebutuhan jaringan Anda.
- Tingkat slot
Memungkinkan Anda menetapkan nilai kunci untuk setiap slot iklan di halaman Anda.
Penargetan tingkat slot memungkinkan Anda mengonfigurasi penargetan per slot. Hal ini berguna jika slot terpisah di halaman yang sama memerlukan dengan penargetan yang berbeda, tetapi mungkin tidak efisien dalam situasi saat nilai kunci diterapkan ke semua slot. Gunakan Slot.setTargeting() untuk memanfaatkan level slot yang berbeda, seperti dalam contoh berikut.
- Tingkat halaman
Memungkinkan Anda menetapkan nilai kunci di semua slot iklan di halaman Anda.
Penargetan tingkat halaman memastikan bahwa semua slot iklan memiliki serangkaian nilai kunci. Dalam beberapa kasus, hal ini dapat mengurangi jumlah total kode yang diperlukan untuk mengonfigurasi penargetan. Gunakan googletag.pubads().setTargeting() yang akan digunakan 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 didefinisikan yang menetapkan unit iklan
/6355419/Travel/Asia dan ukuran iklan 728x90. Penargetan nilai kunci adalah
untuk lebih membatasi dan membedakan iklan yang mungkin ditayangkan di setiap
slot waktu.
Jika penargetan tingkat halaman dan slot digunakan, nilai kunci akan digabungkan dan hanya iklan yang memenuhi semua kriteria yang akan memenuhi syarat untuk ditayangkan pada slot tertentu. Dalam contoh ini, pemberian tag yang efektif untuk setiap slot adalah:
| Slot iklan | Penargetan efektif |
|---|---|
| 1 | color=red AND position=atf AND interests=basketball |
| 2 | position=btf AND interests=basketball |
Menargetkan beberapa kunci atau nilai
Dalam contoh sebelumnya, kombinasi penargetan tingkat slot dan tingkat halaman digunakan untuk menetapkan beberapa kunci penargetan untuk satu slot iklan. Berikut beberapa pendekatan alternatif untuk mencapai penargetan efektif yang sama:
Hanya 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 memberikan
array nilai saat memanggil setTargeting():
// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);
Hapus penargetan
Setelah penargetan ditetapkan, nilai kunci yang dikonfigurasi akan dikirim dengan setiap
permintaan iklan selama masa berlaku slot iklan. Namun, dalam beberapa situasi,
diinginkan agar penargetan berubah seiring waktu. Meskipun setTargeting() dapat menjadi
digunakan untuk menambah dan menimpa nilai kunci, maka tidak mungkin 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 pada
slot- atau halaman-level), hanya kunci tersebut yang dihapus. Jika tidak ada kunci yang ditentukan, semua
penargetan di tingkat tersebut akan dihapus.
Dalam contoh sebelumnya, penargetan efektif untuk slot iklan setelah setiap langkahnya adalah:
| Langkah | Penargetan efektif |
|---|---|
| 0 | color=red AND position=atf AND interests=basketball |
| 1 | position=atf AND interests=basketball |
| 2 | position=atf |