Penargetan nilai kunci

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 tahun akan memenuhi syarat untuk ditayangkan, dengan asumsi semua kriteria lainnya cocok.

Tetapkan 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 Anda.

Penargetan tingkat slot memungkinkan Anda mengonfigurasi penargetan per slot. Ini berguna jika slot individual di halaman yang sama memerlukan penargetan yang berbeda, tetapi bisa menjadi tidak efisien dalam situasi ketika nilai kunci yang sama diterapkan ke semua slot. Gunakan Slot.setTargeting() untuk memanfaatkan penargetan tingkat slot, seperti dalam contoh berikut.

Tingkat halaman

Memungkinkan Anda menetapkan nilai kunci di seluruh 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 memanfaatkan penargetan tingkat halaman, seperti dalam contoh berikut.

<head>
  <script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
  <script>
    window.googletag = window.googletag || {cmd: []};

    // GPT slots
    var adSlots = [];

    googletag.cmd.push(function() {
      // 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 digabungkan dan hanya iklan yang memenuhi semua kriteria yang memenuhi syarat untuk ditayangkan ke slot tertentu. Dalam contoh ini, taget 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

Pada contoh sebelumnya, kombinasi penargetan tingkat slot dan halaman digunakan untuk menentukan beberapa kunci penargetan untuk satu slot iklan. Berikut ini 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 aktif slot iklan. Namun, dalam beberapa situasi, penargetan dapat 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.

// 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 tingkat slot atau halaman), hanya kunci tersebut yang akan dihapus. Jika tidak ada kunci yang ditentukan, semua penargetan pada tingkat tersebut akan dihapus.

Pada contoh sebelumnya, penargetan efektif untuk slot iklan setelah setiap langkah adalah:

Langkah Penargetan efektif
0 color=red AND position=atf AND interests=basketball
1 position=atf AND interests=basketball
2 position=atf