評估服務供應商適用的 Protected Audience (舊稱 FLEDGE) 整合指南

在 Privacy Sandbox 中，Chrome 提議 Protected Audience API：瀏覽器內 API 能讓廣告客戶和廣告技術公司放送興趣群組指定廣告 不必仰賴第三方 Cookie，同時防止使用者跨網站 追蹤。

在 Protected Audience API 中，再行銷廣告贏得競價時，顯示 廣告網址會傳送到 Fenced 頁框 算繪。Fenced Frame 是建議用於嵌入內容的 HTML 元素。 類似於 iframe有別於 iframe，圍欄框架會限制通訊 以便框架存取跨網站資料，而不需要 並透過嵌入內容共用該資源詳情請參閱 Fenced Frame 應用實例 說明

多媒體和Video 360 支援 巨集：用於評估 用於追蹤曝光和點擊的供應商。這些模型只有一小部分 巨集可以在廣告素材算繪中替換，這是因為沒有內容比對的 和競價信號舉例來說，${PUBLISHER_ID} 會在沒有變更的情況下中斷 對應至評估服務供應商代碼

本指南適用對象為會追蹤 將「事件」 使用多媒體和Video 360。

註冊

自 2023 年 8 月起，評估服務供應商可能需要採取這些步驟 在下方註冊以使用 Protected 中的 Fenced Frame Reporting API Audience API。

詳細說明 註冊

整合

評估服務供應商曝光代碼

設定操作說明：

指令碼標記 範例 
<script src='https://tracking.com/a.js'>xxx</script>
敬上 責任：評估服務供應商，更新要使用的指令碼標記 reportEvent用於追蹤曝光次數的 API (參閱指南) )。
圖片標記 範例 
<img src='https://tracking.com/'>
敬上 責任：多媒體和透過影片 360 更新要使用的 img src 標記 reportEvent API，用於追蹤曝光次數。

reportEvent API

這個 API 建議用於 只追蹤轉譯後的情形API 包含兩個部分：registerAdMacro 和 reportEvent。

  • 多媒體和影片 360 擁有 reportWin 中的 registerAdMacro 函式。 函式會在 轉譯呼叫
  • 視代碼類型而定影片 360 或評估服務供應商 將 3PAT 標記變更為使用 reportEvent API。

reportEvent 只接受 1 個輸入「destinationURL」，點進了 至評估服務供應商伺服器且可包含 多媒體和Video 360 說明 中心。例如：

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

當 Chrome 在函式中觸發網址連線偵測 (ping) 時，會查詢 巨集並將其替換為這些值，再將 HTTP GET 要求傳送至 https://adtech.example。

更新指令碼標記的步驟

現有的廣告素材代碼不會有任何變動。多媒體和影片 360 靜態圖片 會在未修改廣告素材的情況下顯示評估服務供應商代碼 酬載。當評估服務供應商收到來自 Protected 保護的曝光連線偵測 (ping) 時 Audience API 結構定義，他們必須按照下列步驟獲得曝光 追蹤：

  1. 準備評估服務供應商曝光網址以接受曝光連線偵測 (ping)。 例如：

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. 回應來自 Protected 的指令碼時，新增 reportEvent JS Audience API。例如：

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. 從先前設定的曝光網址收到連線偵測 (ping) 時，記錄曝光 步驟 1：

評估服務供應商點擊廣告代碼

現有的評估服務供應商點擊代碼會繼續適用於 Protected Audience 曝光。多媒體和 Video 360 會使用 Fenced Frames Ads Reporting API reserved.top_navigation 信標以記錄點擊，並會鏈結全部 將評估服務供應商的點擊追蹤程式視為重新導向。詳情請參閱 Chrome 的圍欄頁框廣告報表說明文件 API。