發布商提供的信號

您可以在廣告請求中以發布商提供的信號 (PPS) 的形式傳送目標對象和比對內容資料。透過 PPS，您可以使用使用者資料，透過標準分類方式，向所有交易類型的出價方傳達目標對象特徵，藉此改善程式輔助營利，而無須分享使用者 ID。目標對象特徵可包含行為和興趣相關資料 (IAB 目標對象分類 1.1)，以及比對內容資料 (IAB 內容分類 2.2)。您也可以傳送發布商提供的結構化信號 (由 Google 定義)，以便傳送其他信號。

建構使用者信號 JSON

在頂層建立含有單一鍵/值組合的 JSON 物件。索引鍵應為 PublisherProvidedTaxonomySignals，其值應為物件陣列。陣列中的每個物件都應包含 2 個鍵/值組合：

• taxonomy 鍵，可接受下列對應至下列 IAB 公開規格的值：

  • IAB_AUDIENCE_1_1，適用於目標對象分類 1.1
  • IAB_CONTENT_2_2 (適用於內容分類 2.2)

• values 鍵和字串分類值的對應陣列。

建構結構化信號陣列

針對結構化信號，請新增 PublisherProvidedStructuredSignals 索引鍵，並將物件陣列設為值。根據下列信號鍵/值清單建構物件：

切換結構化信號表格檢視畫面

信號	<code" dir="ltr" translate="no">"類型"值</code">	可能的 "single_value" 值	可能的 "values" 值
音訊動態饋給類型	"audio_feed"	"af_1"：音樂 "af_2"：廣播 "af_3"：Podcast	不適用
內容分級	"content_rating"	"cr_1"：G "cr_2"：PG "cr_3"：三 "cr_4"：麻薩諸塞	不適用
內容上傳	"delivery"	不適用	"cd_1"：串流 "cd_2"：漸進式 "cd_3"：下載
製作品質	"prodq"	"pq_1"：專業製作 "pq_2"：產消合一 "pq_3"：使用者原創內容 (UGC)	不適用

請參閱以下範例，如何使用 IAB_AUDIENCE_1_1 和 IAB_CONTENT_2_2 當做分類信號，並包含結構化信號。

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

設定廣告要求

請按照下列步驟，透過 AdsRequest 傳送 PPS：

• 建立 JSON 物件，內含使用者的興趣、行為或內容比對資料。
• 從上方的 JSON 物件建立 Base64 編碼的 ASCII 字串。
• 使用 &ppsj= 參數，將已編碼的字串附加至廣告代碼網址。

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["1", "284"]
  }]
};

const sampleAdTag = "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s"

const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));

const finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;