Protected Audience API (舊稱 FLEDGE)

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

Chrome 正在執行來源 試用 對於 Protected Audience API 的關注點Authorized Buyers 符合參與資格 在 Ad Manager 發布商廣告空間測試 Protected Audience API。 出價方可以測試 Protected Audience API,達成以下目標:

  • 反覆疊代並瞭解 Protected Audience API 流程的成效。
  • 針對在公開論壇中潛在的 API 改善項目提供意見, 例如 GitHub
  • 在不使用 API 的情況下,準備透過 API 支援個人化廣告 必須仰賴第三方 Cookie

有意進行測試的 Authorized Buyers 請參閱下文的新手上路說明 一節

放送流程摘要

以下摘要說明 Authorized Buyers 的 Protected Audience 廣告放送流程 合作夥伴:

流程圖

  1. 出價方會與廣告主合作,為每個廣告主維護興趣群組 廣告客戶。廣告客戶通常會將出價工具的代碼加入 廣告客戶頁面,將瀏覽器加入興趣群組。
  2. 使用者造訪廣告客戶的網頁。該網頁可能含有 標記之前。
  3. 出價方的代碼會叫用 Protected Audience API joinAdInterestGroup()。 這項呼叫會要求瀏覽器將使用者新增至興趣群組。
  4. 使用者造訪發布商網頁。使用者的瀏覽器要求 Google 發布商廣告代碼
  5. Google 發布商廣告代碼會向 Google 伺服器提出內容相關廣告請求。
  6. Google 會傳送內容相關出價要求給參與的出價方。詳情請參閱 「出價要求變更」一節
  7. 出價方使用 interest_group_bidding 欄位傳回 BidResponse。 如果出價工具未指定 interest_group_bidding,Google 不會 在競價的 interestGroupBuyers 中加入出價方的來源 設定 出價回應也可以包含 interest_group_bidding.per_buyer_signals。 系統會在以下期間將 per_buyer_signals 傳遞至出價方的出價函式 也就是在瀏覽器內競價查看出價回應變更 一節
  8. Google 會執行伺服器端競價,並將出價回應傳回 。伺服器端競價會考量傳統的伺服器端出價。 出價回應可包含內容相關勝出出價的資訊 (假設 不限)。
  9. 出價回應包含瀏覽器內競價設定 競價。包括每個參與買方的比對內容信號 (透過 interest_group_bidding.per_buyer_signals 傳送) 內容相關勝出組合資訊和出價資格設定
  10. Google 發布商代碼叫用 Protected Audience API runAdAuction() 啟動裝置端興趣群組競價Google 只包含 先前傳回 interest_group_bidding 的買方 interestGroupBuyers
  11. Google 會將每個符合資格的出價方的 per_buyer_signals 傳遞至 Protected 目標對象競價設定。
  12. 如果某出價方的興趣群組已指定 trustedBiddingSignalsUrl,瀏覽器會向每個群組的 trustedBiddingSignalsUrl:擷取每個群組的即時信號。詳情請見 Protected Audience API 中的詳細資料 spec
  13. 瀏覽器為每個興趣群組叫用出價方的 generateBid() 且符合參與瀏覽器競價的資格。這個 步驟會計算出價並選取廣告素材generateBid() 可以存取: 出價方和受信任的出價提供的 per_buyer_signals 指定興趣群組的信號
  14. 瀏覽器會叫用賣方 (在本例中為 Google 的) scoreAd(), 為興趣廣告群組廣告競價中的每項出價指定排名。出價排名 根據發布商保護措施、廣告政策和其他條件篩選 限制。
  15. 瀏覽器使用符合資格的興趣群組出價進行競價。 評級最高的內容相關出價會參與瀏覽器內競價。
  16. 在競價結束後,如果有興趣群組勝出者,瀏覽器會叫用 賣方的 reportResult() 和出價方的 reportWin(),分別向對方通知 關於瀏覽器內競價勝出者的派對
  17. 如果興趣群組廣告勝出,Google 發布商廣告代碼會在 iframe。

供應流程詳細資料

廣告放送前

廣告素材審核

廣告素材必須先通過 Google 審查並獲得核准,才能用來放送 Protected Audience 瀏覽器內競價。你可以將廣告素材送審 透過即時出價 API自動掃描廣告素材。下列項目的廣告: 瀏覽器內 Protected Audience 興趣群組廣告競價必須包含 renderUrls

renderUrls」的規定:

  • 透過 API 提交的 renderUrl 應與使用的 renderUrl 相符 參與興趣群組廣告競價的結果
  • 每個renderUrl只能代表單一廣告客戶或廣告 廣告活動。無法代表以下第三方代為顯示廣告:renderUrl 。每個 renderUrl 都必須對應到單一廣告素材。
  • renderUrl」必須可供 Google 的離線存取及擷取 廣告審核系統,在廣告上次出價後長達 7 天。
Real-time Bidding API

出價方可以使用即時出價 API 來上傳 興趣群組出價

自動掃描廣告素材

出價方可以針對不屬於任何廣告素材的廣告素材,進行自動廣告素材掃描 透過即時出價 API 上傳的廣告空間

如果您設定廣告素材自動掃描功能,Google 就會在 瀏覽器內競價並自動掃描,確保廣告客戶符合競價資格 未來的競價

開啟廣告素材自動掃描功能的方法如下:

  • 將興趣群組廣告素材的所有 renderUrl 來源加到 授權買方帳戶。

  • 在廣告素材的 HTTP 回應中加入下列自訂 HTTP 標頭:

    Authorized-Buyers-Creative-ID

    string

    買方專屬的廣告素材 ID。廣告素材 ID 的長度上限為 128 個位元組。

    Authorized-Buyers-Click-Through-URLs

    string

    指定編碼的廣告素材的宣告到達網頁網址組合 至 RFC2396

範例:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
廣告素材到期

廣告素材已核准 15 天。如果您使用「即時」報表提交廣告素材 Bidding API,您必須在 15 天後重新提交廣告素材。如果您需要依賴 自動掃描廣告素材,掃描程序會自動重新掃描它們。

買方報表 ID

您可以使用維度細分報表指標 (例如曝光次數) (例如廣告活動編號或廣告客戶編號)。如要新增 興趣群組支出的維度,請指定以下項目的buyerAndSellerReportingId: 向使用者放送您的廣告。查看其他 Protected Audience 中的詳細資料 說明文件

以下範例說明如何將 buyerAndSellerReportingId 新增至 興趣群組設定:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

buyer_reporting_id」在「授權」維度中會顯示為新維度 買方報表工具 (即買方報表 ID 維度)。

伺服器端競價

出價要求變更

以下是 支援通訊協定的早期版本, 實驗:

指出興趣群組競價支援

出價要求有一個新欄位:auction_environment

  • Google RTB 通訊協定:BidRequest.adslot.auction_environment
  • OpenRTB:BidRequest.imp.ext.auction_environment

您可利用這個欄位區分曝光機會 支援瀏覽器內 Protected Audience 應用程式內興趣群組競價 僅支援傳統的伺服器端廣告交易平台競價。 auction_environment 列舉可能包含下列值:

  • SERVER_SIDE_AUCTION (OpenRTB JSON:0):傳統伺服器端競價
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON:1):含有 Protected Audience 支援,情境相關競價會在 就會執行最終競價 使用瀏覽器
表示 Protected Audience 廣告版位大小

出價要求包含下列欄位 目標對象廣告版位大小:

  • Google RTB 通訊協定:
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height
  • OpenRTB:
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height

這些欄位代表用於 Protected Audience 競價的廣告版位大小 單位。

這個大小可能與內容相關要求的大小不同 (Adslot.widthAdslot.height,或在 OpenRTB 中: BidRequest.imp.banner.format)。

內容相關要求可能有多種大小。裝置端競價勝出 廣告只能填滿一個固定的版位大小。

指出 Protected Audience 廣告顯示能力

視目前設定而定,Protected Audience 廣告不一定會顯示 整合階段 (請參閱非轉譯 實驗)。render_interest_group_ads 欄位會指出勝出的 Protected Audience 廣告 轉譯的影格速率

  • Google RTB 通訊協定: BidRequest.adslot.interest_group_auction.render_interest_group_ads
  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
盡量減少仰賴使用者 ID

在 Protected Audience API 測試的情境下,比對內容出價要求可以 仍會繼續提供傳統的 Cookie 型 ID (如有) 瀏覽器,例如 google_user_id (OpenRTB 中的 BidRequest.user.id) 和 hosted_match_data (OpenRTB 中的 BidRequest.user.buyerid) 欄位。存在 出價要求中的這類 ID 仍將使用現有的任何 隱私權政策。建議您不要將 Cookie 型 ID 用於 在測試期間指定目標及出價,以便更有效地做好準備,進而提升效率 並在第三方 Cookie 無法使用時購買廣告空間。

Google 可能還會進行小規模實驗,以 Cookie 做為 ID 在 Protected Audience API 測試的範圍中,遮蓋其中的出價要求。這個 目的是評估第三方 Cookie 淘汰的潛在影響。

第三方 Cookie 停用 (3PCD) Chrome 於 2024 年推出 由 Chrome 協助執行的測試

網站和供應商可執行由 Chrome 技術支援的測試,測試自家系統 3PCD。在測試中,系統會將 Chrome 瀏覽器指派給 3PCD 實驗群組 在模式 A 或模式 B為每個瀏覽器指派一致的標籤 與 3PCD 實驗群組相應 透過瀏覽器內 Chrome API

Google 會將未修改的標籤從 Chrome API 傳送到即時出價 請求。由於個別標籤的流量規模較小,Google 在限制隱私權的環境中,不一定總是加上該標籤。

以下是查看標籤的欄位:

  • Google RTB 通訊協定: BidRequest.device.cookie_deprecation_label
  • OpenRTB: BidRequest.device.ext.cdep

出價回應變更

指出參與興趣群組競價

您有責任明確指出您是否要 傳回 InterestGroupBidding 物件 內容相關出價回應:

  • Google RTB 通訊協定:BidResponse.interest_group_bidding
  • OpenRTB:BidResponse.ext.igbid

您必須提供內容相關出價回應。您不需要做出任何回應 參考內容相關出價InterestGroupBidding 物件應包含 興趣群組擁有者的 origin,必須與其中一個來源相符 是由出價工具代為在帳戶中設定的系統會將origin加入競價 Google 發布商廣告代碼呼叫時的 interestGroupBuyers runAdAuction()

傳播買方比對內容信號 (perBuyerSignals)

您可將買方信號加入內容相關出價回應,也就是 Google 會以 JSON 物件的形式,透過 perBuyerSignals 引數。這個註解可包含在含有 [ 下列欄位會因通訊協定而異:

  • Google RTB:BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB:BidResponse.ext.igbid.igbuyer.buyerdata
套用買方比對內容顯示信號

依下列條件,興趣群組廣告素材顯示時可能會使用有限的比對內容信號: 透過內容比對出價回應傳送這些信號 。例如算繪 信號可用於自訂廣告素材的外觀和風格,以改善 針對特定廣告版位或發布商網頁所獲得的成效。

您可以在 內容相關出價回應,Google 會取代得標者 建構網址群組 ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} 巨集

出價回應可指定下列屬性 欄位,會因通訊協定而異:

  • Google RTB:BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals
  • OpenRTB:BidResponse.ext.igbid.igbuyer.rsig

可加入最多 3 組不同巨集後置字串的顯示信號 以區別不同的信號例如 可用於比對僅適用於廣告素材的一組特定信號 與網址中的對應巨集通訊,進而減少資料移轉量 大小

興趣群組買方會遭到拒絕 目標對象競價:如果信號不符合網址安全、巨集尾碼重複, 至少提供 3 組信號。

指定瀏覽器內最高出價

在「Protected Audience」 出價計算方法 且最終競價預計會在裝置端執行這可能會造成 可能的濫用媒介可能會影響最終競價的完整性 例如得標出價

做為 Google 測試 Protected Audience API 測試期間支援的緩解措施 對於即時出價合作夥伴,您可以為每個參數指定預期的最高出價值 內容相關出價回應「預估最高出價」是指 出價函式的預期值如果回報的勝出出價來源 瀏覽器內競價超過此金額,系統就不會計算勝出出價 視為可計費事件這個方法隨時可能改變。

在出價回應中,您可以透過 以下欄位:

  • Google RTB 通訊協定: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (以微千次曝光出價表示)
  • OpenRTB:BidResponse.igbid.igbuyer.maxbid(以千次曝光出價貨幣單位表示)
將曝光歸因於多個帳戶

出價方必須選取帳單 ID,才能歸因興趣 使用以下欄位進行分組出價的曝光次數:

  • Google RTB 通訊協定: BidResponse.interest_group_bidding.interest_group_buyers.billing_id
  • OpenRTB:BidResponse.igbid.igbuyer.billing_id

選取的帳單 ID 必須是出價要求中符合資格的帳單 ID:

  • Google RTB 通訊協定: BidRequest.adslot.matching_ad_data.billing_id
  • OpenRTB:BidRequest.imp.ext.billing_id

如果不是用來歸因興趣群組出價曝光的帳單 ID 買方將不會參與 Protected Audience 競價。

子帳戶最多能有兩個帳單 ID。這時買方可以使用 內容相關支出的帳單 ID,以及興趣群組支出的帳單 ID。 如要設定兩個帳單 ID,請與您的客戶經理聯絡 。

您可為每個帳單 ID 設定每日預算。請與 為子帳戶的帳單 ID 設定每日預算。

凡是有權出價的子帳戶,其帳單 ID 曝光是否出現在出價要求中。交流 聯絡客戶經理,以便修改興趣群組帳單 ID 的預算。

瀏覽器內競價期間

產生瀏覽器內出價

使用 generateBid() 產生瀏覽器內出價。

Google 提供下列參數:

  • auctionSignals:空白
  • perBuyerSignals:這個 JavaScript 物件與 比對內容回應中的出價工具

系統會傳回下列參數:

  • ad:Google 會忽略這個欄位。
  • bid:參與競價的數字出價。必須採用千次曝光出價單元 (而非微分)。
  • render:在出價勝出時,顯示廣告素材的網址 競價。這個網址必須經過 Google 審查並核准,否則就會被篩除
  • allowComponentAuction:必須為 true。Google 目前支援測試功能 多重賣方競價

範例如下:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

查看 Protected Audience 規格:裝置端 出價 一節,瞭解 generateBid() 函式的說明。

出價貨幣

瀏覽器內競價出價會採用所選出價貨幣的千次曝光出價。

出價貨幣必須同時在內容相關出價回應和 generateBid 的傳回值,且必須是有效的 ISO 4217 Alpha 代碼,例如 ,例如「USD」、「EUR」或「JPY」。

在 OpenRTB 中,於以下位置的 InterestGroupBuyer 物件中使用新的 cur 欄位: Google 的出價回應額外資訊。

範例如下:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

在 Google RTB 通訊協定中,使用currency 出價回應中的 InterestGroupBuyer 訊息。

範例如下:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

出價方generateBid 函式傳回的出價必須採用與 內容相關出價回應中會指出的位置。填入新的 bidCurrency 屬性 generateBid 的傳回值:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

如果內容比對出價回應的貨幣與實際貨幣不同 generateBid 所傳回的網址,或者兩者傳回無效的貨幣, 出價就會在競價前篩除

廣告品質檢查

廣告素材政策和發布商控制項的違規處置較嚴格 對即時出價進行 Protected Audience API 測試期間,瀏覽器內興趣群組出價 合作夥伴。

《數位服務法》支援服務

根據《數位服務法》第 26 條規定,發布商可能會要求買方提供 廣告內資訊公開揭露聲明。系統顯示「要求買方只放送包含動態搜尋廣告的廣告時」 有關歐洲經濟區境內網站或應用程式的資訊公開資訊控制項 興趣群組買方可以自行決定 必須留意 已收到的出價要求: 「BidRequest.dsa.dsa_support」和「BidRequest.dsa.publisher_rendering_support」 Google Authorized Buyers 通訊協定和 BidRequest.regs.dsa.requiredBidRequest.dsa.pubrender 的 OpenRTB 通訊協定。

想要參與 Protected Audience API 競價的出價者時 收到出價要求中必須顯示《數位服務法》資訊公開的信號 應該評估透過 Protected Audience API 放送的廣告 即可正確顯示所需資訊 BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render 適用於 Google Authorized Buyers 通訊協定 BidResponse.ext.igbid.igbuyer.dsaadrender。否則 買方將不會納入 Protected Audience API 競價。

如要進一步瞭解《數位服務法》廣告資訊公開,請參閱 說明中心文章:《數位服務法》支援

出價篩選

Google 會強制規定發布商 控制項廣告 政策 於裝置端競價中勝出

瀏覽器內競價後

向買方回報競價結果:reportWin()

Google 不會填入下列引數:

  • auctionSignals
  • sellerSignals

使用「reportWin()」向買方回報競價結果。

請參閱轉譯和廣告買方報表 活動 一節。

巨集

參照 Protected Audience API 廣告素材的 renderUrl 可包括 一個或多個預留位置,稱為「巨集」。興趣群組競價結束後 但在顯示前,巨集會由對應的 輕鬆分配獎金用於裝置端競價的 renderUrl 可能包含下列內容: 巨集:

${GDPR} 如果不適用 GDPR,則會展開為 0;如果適用 GDPR,則會展開 1。請參閱說明文件
${GDPR_CONSENT_XXXX} 拓展至透明度 和與請求相關聯的同意聲明 (TC) 字串。如果資訊公開與 同意聲明 (TC) 字串空白或無效,這個巨集不會展開。

使用此巨集將資訊公開和同意聲明 (TC) 字串,透過網址傳送給已註冊 IAB GVL 的供應商。 將 XXXX 替換為註冊 IAB GVL 的 IAB GVL ID 供應商。如果 TC 字串空白或無效,這個巨集將不會展開。

包含「${GDPR_CONSENT_XXXX}」巨集的廣告素材可能會變成 封鎖與您 IAB GVL ID 相關聯的 IAB GVL 註冊供應商 未取得使用者同意。

${GDPR_CONSENT_XXXX} 巨集只會在 renderUrl
${ADDL_CONSENT} 這會展開成其他 與請求相關聯的同意聲明 (AC) 字串。
${AD_WIDTH}, ${AD_HEIGHT) 這些巨集會插入廣告版位的寬度和高度。
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

包含轉譯時間買方信號的巨集 出價回應中指定的任何狀態資訊

buyer.origin.example 預留位置替換成起點 興趣群組買方的廣告空間,也就是 interest_group_buyers.origin。您可以 加入 _OPTIONAL_SUFFIX,最多可以提供三種 轉譯信號值

曝光次數計算

在與即時出價合作夥伴進行 Protected Audience API 測試期間,Google 會計入 當瀏覽器呼叫 reportResult() 函式並 隨後就會在呼叫 sendReportTo() 時擷取 Google 報表網址。

因為 Google 使用事件來計算 Protected Audience 的曝光次數 瀏覽器內競價可能與用於計算的事件不同 但曝光次數可能會有所不同。

測試 Protected Audience API 的 Google 目標之一是 減少這些差異

可計費曝光歸因

Protected Audience 瀏覽器內競價時,出價方的所有支出為 根據來自興趣的對應關係,歸因於單一出價方帳戶 為出價方設定的群組擁有者來源。將支出歸給不同的 不支援出價方的子買方帳戶。

每日預算上限

在 Protected Audience API 測試期間,每個帳戶都有一個帳戶層級 Protected Audience 支出每日預算上限。每日預算上限會限制風險 能夠設定廣告素材一旦達到每日預算上限, 帳戶不會再收到符合 Protected Audience 資格的出價要求。

之後帳戶可繼續參與伺服器端內容競價 達到 Protected Audience 上限例如,出價工具帳戶 即使出價要求符合條件,則 Protected Audience 上限可能會收到包含 auction_environment = SERVER_SIDE_AUCTION (OpenRTB:0) 的出價要求 Protected Audience 競價。

即時意見回饋和最低出價,以便贏得競價

選擇接收的出價方 即時意見回饋 將收到請求加入加入 裝置端 Protected Audience 競價。出價工具的每個興趣群組買方 指定的出價回應後,無論如何 興趣群組買方在 Protected Audience 競價中決定的出價上限。 興趣群組買家意見回饋將提供以下資訊 物件:

  • 意見回饋物件 INTEREST_GROUP_BUYER_FEEDBACK
  • 興趣群組買家的來源。
  • 興趣群組買方得標所需的最低出價 。
  • 興趣群組買方為了擊敗興趣群組並贏得競價所需的最低出價 從整體競價伺服器端元件取得的評級最高出價。
  • 興趣群組買家的狀態碼。可能的狀態碼 interest-group-buyer-status-codes.txt.

請參閱 Authorized Buyers 即時出價 以及 OpenRTB 擴充功能 代表特定欄位名稱的預測值

出價意見回饋通知

Chrome 提供暫時偵錯功能 API 適用於 Ad Manager 即時傳送 伺服器對伺服器偵錯通知,內含對 Protected 保護的意見回饋 目標對像出價。這則通知將包括出價的可能原因 瀏覽器內 Protected Audience 競價時篩除的 出價相關資訊。

出價方可以與客戶經理聯絡,設定要在 ,用來提供 Protected Audience 偵錯出價意見回饋通知。這個 系統會從 Google 伺服器擷取靜態網址,並替換所選巨集 也會結束 Protected Audience 競價。以下是 支援:

  • %%GOOGLE_QUERY_ID%%:這個巨集已由 Google 查詢 ID 取代 (Authorized Buyer 通訊協定中的 BidRequest.google_query_id,以及 OpenRTB 通訊協定中的 BidRequest.ext.google_query_id), 已啟用 Protected Audience 的內容相關出價要求。
  • %%INTEREST_GROUP_OWNER%%:興趣群組擁有者的來源。
  • %%BID_CPM%%:買方在 generateBid() 函式。
  • %%RENDER_URL%%:廣告素材的顯示網址。
  • %%STATUS%%:如果出價在 scoreAd()內遭拒,就會出現狀態碼。 值為廣告素材狀態 代碼

以下是出價方可能提供給客戶經理的靜態網址範例:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

出價意見回饋通知是一項暫時性功能,需要使用 Chrome 的 臨時 ForDebuggingOnly API。

產品層級 TURTLEDOVE

以多種商品組合的廣告產品層級 TURTLEDOVE 在 Protected Audience API 期間,Google RTB 合作夥伴支援 (PLTD) 進行測試。如果您打算測試,請在整合期間告知客戶經理 PLTD,因為需要額外的資源和設定。

新手上路

測試 Protected Audience API 的方法如下:

步驟

  1. 填寫要求表單 加入 Protected Audience API 實驗。
  2. 提交申請表單後,請與您的客戶經理聯絡或檔案 使用 Authorized Buyers 說明 中心
  3. 帳戶設定完成後,Google 和合作夥伴就能驗證 進行整合。

廣告素材審核

使用產品層級廣告 (由多個項目組成的廣告) 出價 參與 Protected Audience API 競價時,請遵守下列規定:

  • renderUrl&pltd=True 查詢參數加入 元件廣告的容器 (也稱為頂層 renderUrl) 在廣告素材審核過程中區分頂層 renderUrls
  • 當元件廣告的容器位於 Google 擷取的廣告編號。為了瞭解 代表廣告顯示代表性廣告,您可以參照 Google 廣告素材審核系統設定的 validation=True 查詢參數。

整合作業檢查清單

  • 設定出價要求端點,為 Protected Audience API 填入資料 內容相關出價回應的相關欄位,例如 interest_group_bidding
  • 在廣告客戶的網頁中導入代碼,將使用者的瀏覽器加入 興趣群組
  • 實作 generateBid()reportWin()
  • 選取興趣群組擁有者來源並加入 Authorized Buyers 讓他們使用服務帳戶
    • 興趣群組擁有者來源應與 代管 generateBid() 函式。
    • 請與您的客戶經理聯絡,或使用已授權的 買方說明中心 請完成這個步驟。
  • 針對與 Protected Audience API 相關的廣告空間設定預先指定 進行測試。
  • 透過 [廣告素材] 頁面,將廣告素材送交審核及核准。 API
  • (選用) 設定受信任的出價信號端點。
  • (選用) 設定測試廣告客戶網頁,讓 Google 工程師在該頁面加入測試 將瀏覽器修改為興趣群組 (買方的興趣群組) 來源。這樣一來,我們就能手動觸發目標對象受保護競價。
  • (選用) 啟用帳戶的即時意見回饋功能,取得以下項目的意見回饋: 要求將興趣群組買方加入 Protected Audience 競價。
  • (選用) 請與您的客戶經理聯絡,設定將靜態網址設為 接收提供 Protected Audience 出價的伺服器對伺服器通知 裝置端 Protected Audience 出價狀態的意見回饋 競價以解決非預期的問題查看出價相關意見回饋 通知

測試階段

第 1 階段:手動測試

以下說明如何手動觸發目標對象受保護競價,確保廣告 並記錄曝光次數:

  1. 使用 Chrome 101 以上版本。
  2. 使用以下方式啟用 Privacy Sandbox API 和 Fenced Frame 「chrome://flags/#privacy-sandbox-ads-apis」和 chrome://flags/#enable-fenced-frames。詳情請參閱測試隱私權 沙箱
  3. 使用即時出價功能將廣告素材送審 API
  4. 使用出價方提供的廣告主頁面,將瀏覽器加入出價方自有 興趣群組
  5. 請使用下列 Google 提供的測試發布商頁面,觸發受保護功能 目標對象競價:

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    瀏覽器內興趣群組的出價必須夠高才能贏得競價,因為 可能會與傳統的伺服器端出價競爭Google 也提供 每位合作夥伴的專屬測試發布商網頁,只有指定合作夥伴 才能參與競價較容易取得可靠的結果 網站上的瀏覽器內競價。

  6. 驗證以下內容:

    1. 顯示預期勝出的廣告。
    2. 競價結果會在伺服器端傳送,代表得標者 收到來自 reportWin() 的連線偵測 (ping)。
    3. 測試發布商網頁控制台會記錄每次出價 以下資訊:
      • renderUrl:出價的顯示網址。
      • interestGroupOwner:出價的興趣群組擁有者。
      • accepted:如果接受出價,則這個欄位為 truefalse 表示出價遭到 scoreAd() 拒絕。
      • externalBidStatus:如果出價在 scoreAd()。值為廣告素材狀態 代碼

階段 2:(選用) 非轉譯實驗

待 Google 與合作夥伴手動驗證合作夥伴可 參加 Protected Audience 競價時,Google 讓合作夥伴 在下一階段進行測試

Google 會分配少量直播流量,以便執行 Protected Audience 競價。如此一來,Google 和合作夥伴就不再需要手動觸發 Protected Audience 競價。並未採用 Protected Audience 競價的結果 轉譯完成的部分。方便我們大規模測試整合作業。

請與您的客戶經理聯絡,或透過 Authorized Buyer 提交支援單 準備就緒後,說明中心。 Google 將在這個階段啟用帳戶。

第 3 階段:轉譯實驗

Google 和合作夥伴大規模驗證 Protected Audience 競價後 Google 就能讓合作夥伴 目標對象勝出的廣告。但 Google 只會收到少量流量 目標對象競價可以放送,而勝出的興趣群組廣告 轉譯完成的部分。參與的出價者瀏覽器內出價會與傳統 出價。

請與您的客戶經理聯絡,或透過 Authorized Buyer 提交支援單 準備就緒後,說明中心。 Google 將在這個階段啟用帳戶。

其他功能

以下功能為核心通訊協定的擴充功能。

平行處理

平行處理是一項最佳化功能,能將端對端競價延遲時間縮短 初始化內容相關廣告請求與對 買方信任的伺服器 (在 trustedBiddingSignalsUrl 中指定的)。

平行處理可以縮短延遲時間,但會影響興趣群組 買方資格和支援 協調實驗。 平行處理功能適用於所有參與競價的出價方 參與裝置端興趣群組競價出價方不需要採取行動 參與競價,但應該熟悉 平行處理如何影響裝置端競價的資格。 尚不支援對照實驗的實驗群組 ID 彼此競爭

放送流程摘要

以下摘要說明平行競價流程: 流程圖

裝置端興趣群組買家資格條件

如果是平行競價,navigator.runAdAuction 的呼叫會在之前 內容相關廣告回應。為了發起買方信任 伺服器呼叫,navigator.runAdAuction 要求 interestGroupBuyers 參數必須 作為值傳遞,而其餘競價參數則接受 JavaScript 承諾在內容相關廣告回應後可解決的承諾。開始時間 interestGroupBuyers 會在內容相關廣告回應之前傳遞。 內容相關廣告回應 (包括出價回應) 無法用於選擇參與平行競價的買方 狀態值。Google 發布商廣告代碼快取 使用者瀏覽器中,來自前一個參數的 interestGroupBuyers 參數 navigator.runAdAuction 會在相同網域上執行。

平行處理有多個重要考量:

  1. 買方信任伺服器請求不需要的競價信號 即時出價回應中可以繼續指定 (例如 perBuyerSignals) 與非平行競價相同 這些信號的 Promise 解決後, 裝置端競價的流程與非平行處理 競價流程

  2. 平行處理仰賴快取興趣群組買家清單 Google 不一定會執行平行競價,因為平行處理快取 可能空白或已過期。如果快取空白或已過期,Google 會執行 標準非平行 Protected Audience API 競價,並透過買方意圖來 參與非平行競價,建構興趣群組買家快取。

  3. 系統為目前的發布商快取至少一個任何出價方的買方 則 Google 會同時在 這將如出價要求中所示

    • Google RTB 通訊協定:BidRequest.adslot.interest_group_auction.parallelized
    • OpenRTB:BidRequest.imp.ext.interest_group_auction.parallelized
  4. 每個已註冊的特定出價方興趣群組買家來源, 參與競價的競爭對手都會獲得相應的 ParallelAuctionBuyer 個項目:

    • Google RTB 通訊協定:BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • OpenRTB:BidRequest.imp.ext.interest_group_auction.pbuyer
  5. 如果平行競價進行了,但特定買方來源並未 快取,就無法將給定的買方新增到目前裝置端 競價。這表示如果請求的 parallelized=True 缺少 指定興趣群組買家來源的 ParallelAuctionBuyer 個項目。 然而,出價方可透過包含有效且符合資格的方式表達興趣的出價工具 InterestGroupBuyer(其出價回應) 會包含對應的興趣群組買方 納入快取的來源,這些來源就可以取得 來自相同瀏覽器和網域的未來平行處理要求。 有意參與興趣群組競價 表示在下列欄位中:

    • Google RTB 通訊協定:BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • OpenRTB:BidResponse.ext.igbid.igbuyer
  6. 快取買方來源 (包含在平行競價的 interestGroupBuyers 參數) 可用在出價方未指出意圖的情況下 參與出價回應時,可能會收到買方信任的伺服器呼叫 但無法參與平行競價