本頁面由 Cloud Translation API 翻譯而成。

賣方平台適用的 Protected Audience (舊稱 FLEDGE) 整合與測試指南

做為 Privacy Sandbox 的一部分，Chrome 提議 Protected Audience API、瀏覽器內 API 協助廣告客戶和廣告技術公司彙整及鎖定興趣群組 (目標對象名單) 不必使用第三方 Cookie，同時保護使用者跨網站追蹤。開發人員指南

賣方平台可以透過多媒體和多媒體廣告聯播網測試 Protected Audience API以便：

反覆疊代並瞭解 Protected Audience API 流程的成效。
向公開團隊提出 API 改善建議並提供意見回饋論壇中的連結，例如 GitHub。
準備透過 Protected Audience 支援個人化廣告不必仰賴第三方 Cookie

以下指南將詳細介紹賣方平台與多媒體和多媒體廣告聯播網的整合詳情 Video 360 和 Google Ads。想要協調測試的賣方平台應獲得接觸對方的螢幕，以及Video 360 合作夥伴代表。

註冊

賣方平台應在將自己使用 Protected Audience API

放送流程摘要

下圖呈現 Chrome、賣方平台、多媒體廣告聯播網與Video 360 和 Google Ads。

顯示 Chrome、賣方平台與
DSP

整合選項

選項 1：直接 / 單一賣家

單一賣家的詳細要求流程
競價

步驟：

賣方平台廣告代碼會將廣告請求傳送給賣方平台伺服器，指出瀏覽器支援 Protected Audience API。
賣方平台伺服器向 DSP 傳送內容相關 OpenRTB 出價要求，瀏覽器支援 Protected Audience API
需求端平台會以 OpenRTB 出價回應回應，其中包含裝置端競價
賣方平台伺服器將包含競價設定的廣告回應傳送至賣方平台廣告代碼。
賣方平台廣告代碼呼叫 runAdAuction()、透過 DSP 的 OpenRTB 出價回應傳入 perBuyerSignals。
Chrome 呼叫鍵/值信任的需求端平台出價伺服器擷取即時出價信號
Chrome 呼叫 generateBid() 每個參與的興趣群組專用的 DSP JavaScript 函式。
Chrome 會呼叫鍵/值信任的賣方平台評分伺服器擷取即時評分信號。
Chrome 呼叫 scoreAd() 每個參與的興趣群組都有賣方平台 JavaScript 函式。
Chrome 呼叫 reportWin() 透過 DSP JavaScript 函式向 DSP 回報得標出價。
Chrome 呼叫 reportResult() 由賣方平台 JavaScript 函式向賣方平台回報得標者。

賣方平台端的基本變更

賣方平台廣告代碼必須更新為
- 偵測瀏覽器是否支援 Protected Audience API
- 將這項資訊當做廣告請求的一部分傳送至賣方平台伺服器 [1]
- 呼叫 runAdAuction() 傳入，即可啟動裝置端競價來自需求端平台 OpenRTB 出價回應 [5] 的信號 (請參閱出價請求和回應結構)。
賣方平台伺服器
- 將 Protected Audience API 支援的相關資訊套用到需求端平台透過 OpenRTB 出價要求中的欄位 [2] (請參閱「出價」一節) 要求和回應結構)。
- 在 OpenRTB 出價回應中，將 DSP 的買方信號套用到賣方平台廣告代碼 (請見下方出價要求 / 出價回應結構一節) [4]
[Optional] 賣方平台必須導入信任的賣方平台伺服器，才能擷取即時資料透過評分信號支援廣告品質檢查、發布商設定違規處置 [8]
賣方平台必須使用 "scoreAd(...)" 和 "reportResult(...)" 導入 JavaScript 函式 [9]、[11]

選項 2：多重賣家

多重賣方競價的詳細要求流程

步驟：

賣方平台轉接程式會傳送廣告請求給賣方平台伺服器，指出瀏覽器支援 Protected Audience API。
賣方平台伺服器向 DSP 傳送內容相關 OpenRTB 出價要求，瀏覽器支援 Protected Audience API
需求端平台伺服器以 OpenRTB 出價回應回應，其中包含裝置端競價
賣方平台伺服器將包含競價設定的廣告回應傳送至賣方平台廣告代碼。
賣方平台 Prebid 轉接程式為發布商廣告伺服器提供元件競價設定標記之前。
發布商廣告伺服器廣告代碼會將廣告請求傳送至發布商廣告伺服器伺服器。
發布商廣告伺服器廣告代碼呼叫 runAdAuction(...)敬上也能使用 Google Cloud CLI 或 Compute Engine API
Chrome 呼叫鍵/值信任的需求端平台出價伺服器擷取即時出價信號
Chrome 呼叫 generateBid() 每個參與的興趣群組專用的 DSP JavaScript 函式。
Chrome 會呼叫鍵/值信任的賣方平台評分伺服器擷取即時評分信號。
Chrome 呼叫 scoreAd() 每個參與的興趣群組都有賣方平台 JavaScript 函式。
Chrome 呼叫 reportWin() 透過 DSP JavaScript 函式向 DSP 回報得標出價。
Chrome 呼叫 reportResult() 由賣方平台 JavaScript 函式向賣方平台回報得標者。

賣方平台端的基本變更

SSP 轉接程式必須更新為
- 偵測瀏覽器是否支援 Protected Audience
- 將這項資訊當做廣告請求的一部分傳送至賣方平台伺服器 [1]
- 為發布商廣告伺服器廣告代碼 [5] 提供元件競價設定。
- 如果 Google Ad Manager 是發布商廣告伺服器，賣方平台可以 * 使用預先出價 Protected Audience 模組 * 呼叫 Google Ad Manager 廣告代碼setConfig() API 有多個賣家
賣方平台伺服器
- 透過以下方式將 Protected Audience 支援的資訊傳播至 DSP 就是 OpenRTB 出價要求中的欄位 [2] (請參閱「出價」一節) 要求和回應結構)。
- 在 OpenRTB 出價回應中，將 DSP 的買方信號套用到賣方平台廣告代碼 (請見下方出價要求 / 出價回應結構一節) [4]
[Optional] 賣方平台必須導入信任的賣方平台伺服器，才能擷取即時資料透過評分信號支援廣告品質檢查、發布商設定違規處置 [10]
賣方平台必須使用 scoreAd() 和 reportResult() 公開 JavaScript 函式 [11]、[14]。

出價和競價服務

我們正持續評估「出價」與競價服務 (B&A) proposal。

顯示時機Video 360 現在可以使用 B&A 測試 Protected Audience API，我們會再與你聯絡並詳細說明。

OpenRTB 通訊協定

出價要求

區分支援 Protected 功能的曝光商機僅支援標準的 Audience API 裝置端競價伺服器端廣告交易平台競價，名為 ae 的新列舉欄位可用於「競價」環境」應新增為 OpenRTB 中 Imp 物件的擴充功能出價要求，用於指定指定支援哪個競價環境。ae 列舉可能包含下列值：

0：標準伺服器端競價
1：要求受 Protected Audience API 支援的要求，以及競價會在廣告交易平台伺服器上執行，興趣群組出價最後的競價是在瀏覽器中

{
  "id": …
  "imp": [{
    "id": "1"
    "video": {...}
    "ext": {
      "ae": 1
    }]
}

出價回應

除了內容相關出價之外，出價回應也會用來與多媒體和Video 360 和 Google Ads 參與了 Protected Audience API 興趣群組競價。出價回應已更新為支援興趣群組競價，如下所示：

{
  "seatbid": [{
    "bid": [{
      … // Traditional contextual bids
    }]
  }],

  "ext": {
    // InterestGroupBidding object which holds information for running an
    // in-browser interest group auction.
    "igbid": [{
      // ID of the Imp object of the impression to which
      // these interest group bidding signals apply to.
      "impid": "1",

      // InterestGroupBuyer object which holds DSP information for the in-browser
      // auction.
      "igbuyer": [{
        // Origin of Display & Video 360 and Google Ads to participate in the
        // interest group auction. For more info regarding the origin see:
        // https://developer.mozilla.org/en-US/docs/Glossary/Origin
        "origin": "https://td.doubleclick.net",

        // Buyer-specific signals to use in auctionConfig as perBuyerSignals.
        // Used by the buyer's interest group bidding function. Can be left empty
        "buyerdata": ...,

        // Buyer experiment group id to support coordinated experiments with
        // buyers' trusted servers. This experiment id should be added to the
        // `perBuyerExperimentGroupIds` map in auctionConfig.
        "buyer_experiment_group_id": 12345
      }]
    }]
  }
}

下列是支援的情況。

情境 1：多媒體和Video 360 和 Google Ads 只想參加和內容競價在這種情況下，系統不會顯示 igbid 欄位。
情境 2：多媒體和Video 360 和 Google Ads 只想參加和興趣群組競價在這個情境中，多媒體和Video 360 和 Google Ads 會在出價回應中捨棄 seatbid 欄位，傳回 igbid 資訊。換句話說，若出現 igbid 欄位，多媒體廣告和Video 360 和 Google Ads 希望放送興趣群組參與裝置端競價
情境 3：多媒體和Video 360 和 Google Ads 想要內容比對和興趣群組競價在這個情境中，多媒體和 Video 360 和 Google Ads 會在出價回應中傳回兩個 seatbid 欄位和 igbid 資訊

包含廣告出價的中繼資料

Protected Audience API 允許：passing arbitrary metadata generateBid() 函式的廣告相關資訊。

多媒體和未來 360 度影片將仰賴下列項目 specification敬上：Protected Audience API 和 OpenRTB。

具體的顯示設定Video 360 在廣告中傳回下列欄位物件：

PA 屬性	類型	OpenRTB 說明
ad.seat	String;必選	代表此出價的買方席位 (例如廣告客戶、代理商) 編號。
ad.adomain	String[]	封鎖清單檢查的廣告客戶網域 (例如「ford.com」)。若是輪播廣告素材，這個值可以是的陣列。廣告交易平台可規定系統只允許使用一個網域。
ad.cid	字串	協助檢查廣告品質的廣告活動 ID。
ad.crid	字串	用於檢查廣告品質的廣告素材 ID。
ad.language	字串	使用 ISO-639-1-alpha-2 格式的廣告素材語言。非標準代碼「xx」。只能提供其中一種語言或語言。
ad.w	整數	以裝置獨立像素 (DIPS) 表示的廣告素材寬度。
ad.h	整數	廣告素材在裝置獨立像素 (DIPS) 中的高度。

範例

{
  "seat": "123"
  "adomain": ["example.com"]
  "cid": "12345"
  "crid": "12345"
  "language": "en"
  "w": 300
  "h": 250
}

事件報表

Protected Audience API 提供事件層級報表 API，如下所述 GitHub 文章：Fenced Frame Ads Reporting。雖然名稱顯示 Fenced Frame Ads Reporting API 圍欄框架和 iframe (詳情請參閱 here)。

賣方平台可以在 reportResult 函式中，呼叫 registerAdBeacon() 也能使用 Google Cloud CLI 或 Compute Engine API

多媒體和Video 360 會呼叫 reportEvent() 將目的地設為「component-seller」的 API要製作相關報表曝光和點擊事件。讓系統將指標傳送到。

請注意，多媒體和Video 360 會呼叫 reportEvent() API 來取得曝光，含空白貼文資料的點擊次數。

範例

registerAdBeacon({
 'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
 'click': 'https://ssp.example/click?ssp_event_id=abc',
});

Cookie 淘汰測試標籤

多媒體和Video 360 將參與第 Chrome-facilitated testing 場第三方 Cookie 淘汰我們要求合作夥伴進行下列測試：請根據以下程式碼，在 OpenRTB 出價要求中傳遞 Chrome 標籤 specification:

物件：Device.ext

屬性	類型	說明
CDN	字串	Chrome 或上游合作夥伴提供的標籤

賣方平台適用的 Protected Audience (舊稱 FLEDGE) 整合與測試指南 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

註冊

放送流程摘要

整合選項

選項 1：直接 / 單一賣家

賣方平台端的基本變更

選項 2：多重賣家

賣方平台端的基本變更

出價和競價服務

OpenRTB 通訊協定

出價要求

出價回應

包含廣告出價的中繼資料

事件報表

Cookie 淘汰測試標籤

相關文件

賣方平台適用的 Protected Audience (舊稱 FLEDGE) 整合與測試指南