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

Protected Audience API 總覽

可在不跨網站追蹤的情況下，為再行銷和自訂目標對象放送裝置端廣告競價。

這篇文章的適用對象為何？

本文將介紹 Protected Audience API 的基本概念，並說明一些基礎概念但不會說明太多技術細節

如果您是廣告或廣告技術工作，則會看到總覽 Protected Audience 的運作方式。
如果您是開發人員或軟體工程師， Protected Audience API 開發人員指南提供更多深入探討 API 的技術細節閱讀待處理的 Protected Audience 功能的最新狀態。

請參閱詞彙解釋，瞭解各項詞彙的通用術語 Protected Audience 說明文件。在本文結尾，您會瞭解如何執行以下動作：參與及分享意見回饋。

什麼是 Protected Audience API？

Protected Audience API 是 Privacy Sandbox 技術，提供再行銷和自訂目標對像用途。第三方無法追蹤使用者的跨網站瀏覽行為。

Protected Audience API 可讓瀏覽器啟用裝置端競價，從中選擇相關廣告使用者先前造訪的網站。

Protected Audience API 是第一個在 Chromium 中實作的實驗，位於 TURTLEDOVE 系列提案。 Protected Audience 和 TURTLEDOVE 的主要用途是區分廣告買方和賣方的裝置端角色下列各節將說明 Protected Audience API 的運作方式

一分鐘內 Protected Audience API

如要深入瞭解 Protected Audience API，請參閱 Protected Audience API 開發人員指南：

Protected Audience API 生命週期每個階段的總覽 — Protected Audience API 生命週期。

Protected Audience API 會使用興趣群組，協助網站放送與使用者切身相關的廣告

例如，當使用者造訪想要宣傳產品的網站時興趣群組擁有者 (例如需求端平台 (DSP) 可要求使用者的瀏覽器為興趣群組新增成員資格。如果要求成功，瀏覽器會記錄下列資訊：

興趣群組的名稱，例如「custom-bikes」。
興趣群組的擁有者：例如「https://dsp.example」。
允許瀏覽器存取的興趣群組設定資訊 出價程式碼、廣告程式碼和即時資料 (如果群組擁有者受邀加入) 參與廣告競價的出價

，瞭解如何調查及移除這項存取權。

之後，當使用者造訪有可用廣告空間的網站時，廣告空間賣方 (賣方供應商 (SSP) 或網站) 則能利用 Protected Audience 進行廣告競價，從中選擇最合適的廣告要向使用者顯示的內容賣方呼叫 navigator.runAdAuction() 函式，提供受邀參加出價的興趣群組擁有者名單。

出價功能只能由瀏覽器成員，且其擁有者受邀參與出價的興趣群組提供。

出價程式碼是從興趣群組此外還會從 0 自動調整資源配置您完全不必調整資源調度設定這段程式碼提供興趣群組相關資料這些資訊，以及網頁和瀏覽器。

每個提供出價的興趣群組，就稱為買方。

當瀏覽器呼叫函式以執行廣告競價時，每個買方的程式碼系統利用廣告客戶提供的即時資料產生出價 Protected Audience 鍵/值服務：接著，賣家會收到這些出價，以及賣家自有的即時資料和各自的分數出價。得分最高的出價將贏得競價。

勝出的廣告會顯示在圍欄頁框。已在出價中指定廣告素材的網址，且來源必須與以下項目的根據興趣群組設定提供的名單

賣方可以回報競價結果 (reportResult())，買方也可以回報自身勝出 (reportWin())。

瞭解 Protected Audience 競價報表。

為什麼需要使用 Protected Audience API？

瞭解使用者興趣有助於放送更多相關廣告根據網站內容或利用資訊顯示的廣告 (指定相關內容) 由使用者提供至廣告的網站 (第一方資料指定)。

傳統上，廣告平台會追蹤跨網站的行為瀏覽器需要能使廣告平台選擇以便內容發布商在不需跨網站的情況下賺取廣告收益追蹤。

Protected Audience API 旨在讓網路平台更接近裝置上的瀏覽器，而非廣告客戶或廣告技術平台以便進一步瞭解該使用者感興趣的事物

如何試用 Protected Audience API？

Protected Audience API 開發人員指南說明如何使用 API 以及如何在本機測試。
protected-audience-demo.web.app 提供逐步完成廣告客戶和發布商 Protected Audience 基本部署作業的逐步操作說明。Protected Audience 示範影片會說明此程式碼的運作方式及預覽如何使用 Chrome 開發人員工具進行偵錯。

可以使用哪些瀏覽器設定？

使用者可以透過下列方式調整自己參與 Chrome 的 Privacy Sandbox 試用計畫：啟用或停用頂層設定： chrome://settings/adPrivacy。在初始測試期間，使用者可以使用 Privacy Sandbox 設定。

Chrome 計劃讓使用者查看及管理興趣群組清單。如同隱私權我們根據使用者的意見回饋，不斷改進沙箱技術、使用者設定或監管機關等

隨著 Protected Audience API 的進展，我們會更新 Chrome 的可用設定。根據測試結果和意見回饋日後，我們將提供更精細的設定，協助您管理 Protected Audience，以及關聯資料

當使用者以無痕模式瀏覽網頁時，API 呼叫端無法存取群組成員。和使用者清除網站資料後，成員資格就會遭到移除。

我可以選擇停用 Protected Audience API 嗎？

瞭解如何封鎖 Protected Audience API 存取權。能夠以網站擁有者或個人使用者的身分

核心概念

想進一步瞭解 Protected Audience 相關術語嗎？詳情請參閱 Privacy Sandbox 詞彙。

什麼是興趣群組？

Protected Audience API 興趣群組代表具有共同興趣的一群使用者。對應至再行銷名單。

每個 Protected Audience API 興趣群組都有一個擁有者。不同類型的擁有者不同類型的興趣群組

擁有者要求使用者的瀏覽器透過以下方式新增興趣群組的成員資格：呼叫 JavaScript 函式 navigator.joinAdInterestGroup()，以提供例如興趣群組相關廣告的資料以及網址。興趣群組資料 (例如廣告) 可以是的更新，而興趣群組最多可啟用 30 天。

興趣群組類型

下表列舉不同類型的 Protected Audience API 興趣群組和擁有者。

擁有者	範例	興趣	範例	用途
廣告主	自行車製造商	產品	曾查看特定單車類別產品網頁的使用者。	對使用者再行銷向品牌互動過的使用者
發布商	新聞網站	內容	閱讀單車相關知識的人。	發布商可以使用第一方資料購買與自家網站讀者相關的廣告A 罩杯由發布商擁有的興趣群組藉此控管這些使用者發布商或許可以可在使用者的特定區隔中顯示廣告目標對象
廣告技術	DSP	產品類別	對自行車裝備感興趣的使用者。	廣告技術公司可能會建立及管理興趣群組他們認為有意購買某類商品的人。這個興趣群組然後在銷售該類商品的網站提供廣告服務

在 Chrome 中，每位擁有者最多可擁有 1000 個興趣群組，以及 1000 個興趣群組擁有者。這些限制的用意在於保護欄，不得在一般運作過程中發揮作用。

什麼是買方？

在 Protected Audience API 中，買方是指擁有興趣群組，並在廣告競價中出價的一方。

例如：

廣告客戶：自行執行各項操作。
需求端平台：為廣告客戶負責。
興趣群組擁有者：適合多個廣告客戶。

買方有三項工作：

選擇是否要參與競價。
選擇廣告並計算出價。
回報競價結果。

這些工作是透過買方執行的程式碼，以程式化的方式完成也會在 Protected Audience API 廣告競價期間採取這種做法

買方的瀏覽器要求使用者的瀏覽器將興趣群組加入所屬群組 (方法是呼叫 JavaScript 函式 navigator.joinAdInterestGroup())，買方會為瀏覽器提供：

出價程式碼的網址，在賣方執行廣告競價時要使用的網址。
可能是興趣群組的廣告素材網址。(可能會加入廣告網址。)
包含要查詢的資料鍵清單，以及買方鍵/值服務的網址，，讓出價程式碼在競價期間取得即時資料。

買方的程式碼也可以加入 reportWin() 函式來回報競價結果。

誰會進行廣告競價？

許多方可能會進行競價來銷售廣告空間。

例如：

內容發布商：自行在網站上代管廣告素材。
供應端平台 (SSP)：與發布商合作並提供其他服務。
第三方指令碼：供發布商參與廣告競價。

使用 Protected Audience API 時，廣告空間賣方可執行三項工作：

執行發布商規則：指明符合資格的買方和出價。
執行競價邏輯：JavaScript 執行 worklet 來計算每次出價的理想成效分數
回報競價結果。

這些工作會透過程式 (由賣方啟動廣告時提供的程式碼) 完成透過呼叫 JavaScript 函式 navigator.runAdAuction() 來競價。

Protected Audience API 廣告競價的運作方式為何？

下圖概述 Protected Audience API 廣告競價的各個階段：

Protected Audience API 廣告競價的六個階段 — Protected Audience 廣告競價階段。

在 Protected Audience API 中，廣告競價是一組小型 JavaScript 程式，用途是瀏覽器在使用者的選擇廣告的裝置為保護隱私權，賣方和買方的所有廣告競價程式碼都會執行互無法與外部世界通訊的獨立 JavaScript 工作負載。

賣方 (發布商或供應端平台) 在銷售廣告空間 (例如新聞) 的網站上啟動 Protected Audience 廣告競價網站)。賣方選擇買方參與競價指出要銷售的空間，並提供廣告的額外條件。每個買方興趣群組的擁有者

賣方會提供瀏覽器評分程式碼，其中包含每次出價的值，廣告素材網址，以及每個買方傳回的其他資料。在競價期間出價以及賣方提供的出價評分程式碼鍵/值服務：系統選出廣告後顯示於圍欄框架中，以便保留隱私權)，賣方和得標買方就能回報競價結果。

使用者造訪顯示廣告的網站。
賣方的程式碼啟動競價。賣方會指定以及出價者，以及這些出價的計算方法。
受邀買方的程式碼執行，以產生出價和相關廣告的網址廣告素材等資料出價指令碼可以查詢即時資料例如剩餘廣告活動預算，都可以來自買方的鍵/值服務。
賣方的代碼會為每次出價評分，並選出勝出者。此邏輯會使用出價和其他資料以傳回出價的合適度，並拒絕就無法超越內容相關廣告的得標者賣方可以使用自己的即時資料的鍵/值服務。之前競價開始時，賣方找出最適合且廣告版位。
競價設定中設定 resolveToConfig 旗標時，系統會以 Fenced frame 設定物件的形式傳回勝出的廣告。該設定可用來在 Fenced Frame 中導覽至廣告素材，且賣方和發布商均無法查看廣告素材網址。如果 resolveToConfig 旗標設為 false 或未傳入，得標的廣告會以不透明的 URN 的形式傳回，可在 iframe 中顯示廣告。Fenced Frame 設定物件自 M114 起開始提供。
系統會向賣方和得標買方回報競價內容。
注意：賣方的 reportResult() 和買方 reportWin() 可包含對 sendReportTo() 的呼叫。目前您可以暫時使用這類功能，直到以私密匯總功能提供匯總報表為止。

落敗買方的檢舉機制正在討論中。

什麼是 Protected Audience API 鍵/值服務？

Protected Audience API 鍵/值服務可讓廣告技術在買方出價時查詢即時資料，並讓賣方在保護隱私權的情況下評分廣告。您可以參閱 Protected Audience API 服務，瞭解 Protected Audience API 金鑰/值服務和其他項目。

「鍵/值」服務會部署至廣告技術本身的雲端基礎架構，而服務會在受信任的執行環境中執行。向鍵/值服務發出的要求無法觸發事件層級記錄，也無法產生其他副作用。鍵/值服務也將支援使用者定義函式 (UDF)，可讓廣告技術在鍵/值服務內執行自己的自訂邏輯。

買方或賣方提供「鍵」清單指定他們需要從 Protected Audience API 鍵/值服務取得的資料。「鍵/值」服務會傳回每個鍵的值。

Privacy Sandbox GitHub 存放區現已提供 Protected Audience API 金鑰/值服務程式碼。Chrome 和 Android 開發人員可使用這項服務。

進一步瞭解 Protected Audience API 鍵/值服務： API 說明和信任模型說明

Google 如何將即時資料納入競價？

廣告競價中的買方或賣方可能需要存取即時資料。舉例來說，買方可能會想計算廣告活動的剩餘預算，或可能必須賣方根據發布商政策檢查廣告素材。

為符合 Protected Audience API 的隱私權規定，鍵/值服務會提供廣告競價期間所需的即時資料。每個買方呼叫 navigator.joinAdInterestGroup() 時，都會指定鍵/值服務網址，並指定在競價期間向服務查詢的鍵。同樣地，如果賣方呼叫 navigator.runAdAuction() 以執行廣告競價，賣方會提供鍵/值服務的網址。系統會透過廣告素材的顯示網址查詢賣方的鍵/值服務。

初始測試會使用「自備伺服器」模式。長期來看，廣告技術人員將需要使用開放原始碼 Protected Audience API 鍵/值服務，在受信任的執行環境中運作，才能擷取即時資料。

為了確保生態系統有充裕的時間來測試，我們預計在第三方 Cookie 淘汰後一段時間，才要求使用開放原始碼鍵/值服務或受信任的執行環境。我們會在轉換開始之前，提供重大通知，讓開發人員開始測試和採用。

在目標對象受保護競價中，第一方資料會如何使用？

第一方資料是指網站在使用者擁有的資料。舉例來說，如果使用者在廣告客戶或發布商網站上指定最喜歡的顏色，系統就會採用第一方資料。

在 Protected Audience 競價中，廣告客戶可以使用第一方資料決定廣告興趣群組成員資格，並將資料做為 userBiddingSignals 傳送至興趣群組。在出價產生步驟中，廣告主的第一方資料僅供買方使用，賣方無法使用。

舉例來說，如果廣告客戶知道使用者最喜歡的顏色，當使用者加進興趣群組時，您可以在興趣群組設定中將該值設為 userBiddingSignals：

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

此外，發布商也可以在啟動競價時設定競價設定中的信號，藉此傳入第一方資料，並控管哪些對象會收到第一方資料。發布商以 auctionSignals 的形式傳遞第一方資料時，買方和賣方都可使用該資料。當資料以 sellerSignals 的形式傳入時，只有賣方可以使用，而以 perBuyerSignals 的形式傳入時，則只有指定買方可以使用該資料。發布商也可以將第一方資料傳入元件競價。發布商和競價參與者應先達成共識，決定要分享哪些第一方資料，以及資料的格式。

以下範例說明發布商如何將第一方資料傳遞給各種競價參與者：

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

瞭解詳情

如要深入瞭解 Protected Audience API，請參閱 Protected Audience API 開發人員指南：

開發人員

如果您已經準備好開始使用 Protected Audience API，請參閱實驗及參與。

我們已撰寫 API 開發人員指南並製作 Protected Audience API 示範，其中包含基本 Protected Audience API 部署的逐步操作說明。Protected Audience API 示範影片說明範例程式碼的運作方式，以及如何使用 Chrome 開發人員工具進行 Protected Audience API 偵錯。

互動及分享意見回饋

GitHub：閱讀說明，提出問題並追蹤討論。
公告：加入 Protected Audience API 郵寄清單，或查看過往公告。
W3C：在「改善網路廣告業務」中討論業界的應用實例群組。
開發人員支援：提出導入作業和最佳做法的相關問題，或參與 Privacy Sandbox 開發人員支援存放區。
目前實作方式：如果對 Chrome 實作 Protected Audience 的方式有任何疑問，請回報 Chromium 錯誤。