指定鍵/值

鍵/值可用於指定比廣告單元更精細的廣告。瞭解詳情關於鍵/值。

您可針對每個廣告請求傳送一或多個鍵，每個鍵搭配一或多個相關聯的值。系統會根據指定目標選項評估這些鍵/值是在 Ad Manager 委刊項層級設定的舉例來說您傳遞的自訂鍵/值 age=18-34，也就是指定該年齡層的委刊項年齡介於 18-34 歲之間 (假設所有其他條件都相符) 即符合放送廣告的資格。

設定指定目標

您可以指定鍵/值，在版位- 根據聯播網需求調整頁面層級

版位層級

可讓您為網頁上的個別廣告版位設定鍵/值。

使用版位層級指定目標功能，即可按版位設定指定目標。如果同一個網頁上的個別版位需要但可能會發生效率不彰的情況鍵/值會套用到所有版位，使用 Slot.setTargeting()，以便使用版位層級指定目標，如以下範例所示

頁面層級

允許設定網頁上所有廣告版位的鍵/值。

網頁層級指定可確保所有廣告版位都擁有同一組鍵值在某些情況下，這可能會減少設定指定目標使用 googletag.pubads().setTargeting()，以便使用網頁層級指定目標，如以下範例所示

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

在這個範例中，定義了兩個廣告版位，其中指定廣告單元 /6355419/Travel/Asia，以及 728x90 的廣告大小。接著，指定鍵/值來進一步限制及區別哪些廣告。

如果同時使用版位和網頁層級指定，系統將合併鍵/值而且只有符合所有條件的廣告才能在特定版位中放送。在這個範例中，每個版位都能使用以下有效標記：

廣告版位	有效指定目標
1	`color=red AND position=atf AND interests=basketball`
2	`position=btf AND interests=basketball`

指定多個鍵或值

在上述範例中，版位與網頁層級指定目標的組合為用來為單一廣告版位定義多個指定鍵。以下是一些還有幾種方法可達到相同的有效指定目標：

僅版位層級指定目標

在這個範例中，每個廣告版位都重複了共用鍵/值。

// 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');

網頁層級預設指定目標

在本例中，預設指定目標是在網頁層級設定，且已覆寫視需要在版位層級放送

// 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());

您也可以為單一鍵指定多個值，方法是提供呼叫 setTargeting() 時的值陣列：

// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);

清除指定目標

設定指定目標後，設定的鍵/值會與每個請求整個廣告版位但在某些情況下來變更指定目標雖然 setTargeting() 可以是新增及覆寫鍵/值後，就無法以這種方式移除。為了達到這個目的，Slot.clearTargeting() 或 googletag.pubads().clearTargeting() 必須

// 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();

使用特定鍵 (clearTargeting() 版位或網頁層級)，則只會移除該鍵。如果沒有指定鍵，在該層級的指定目標中移除

在上述範例中，每個廣告版位完成後：

步驟	有效指定目標
0	`color=red AND position=atf AND interests=basketball`
1	`position=atf AND interests=basketball`
2	`position=atf`