測試 Privacy Sandbox 廣告關聯性和評估 API

Privacy Sandbox 包含一項選項 能夠支援廣告用途,而不需要跨網站 追蹤。來源試用可為 評估新的網路技術並提供意見回饋 進行模擬先前的來源試用網站能夠 與個別 API 整合針對 Topics、FLEDGE 和 Attribution Reporting API 我們提供單一來源試用,讓網站可以統一執行 各個 API 的實驗組成端對端廣告的初始版本 生命週期這些 API 可在 Chrome 101 Beta 版中進行測試 以上。Chrome 101 Beta 版也會偵測到 使用者控制項更新 我們將持續疊代設定選項

開發人員可以註冊這項單一來源試用計畫。 可讓您針對 Topics、FLEDGE 和 Attribution Reporting 相互整合本指南會逐步引導您設定 API 的存取步驟, 說明如何驗證設定,並提供 測試 API

來源試用功能有哪些?

這項來源試用的目標是在廣告中進行有意義的測試 應用程式的生命週期為涵蓋這個歷程,來源試用包括:

  • 觀察及存取 Topics 透過 document.browsingTopics() 分享瀏覽器主題
  • FLEDGE 以便管理瀏覽器的 以及根據這些出價和條件選擇的廣告 群組和其他信號
  • Fenced Frame:顯示 FLEDGE 廣告競價勝出者不透明網址
  • 歸因報表: 評估並記錄廣告生命週期的成效。
    • 在歸因報表中,可匯總報表必須是 並經由匯總 服務 來產生摘要報表我們會在日後發布更多工具及 本機和來源試用指南。
    • 如果您參與了先前的歸因分析來源試用 不過請注意,您需要隨即更新 最新的 API 變更請參閱 指南

雖然這項設定可讓您針對這些 API 進行整合測試,但您可以 然後選擇要導入的層面 系統會按照資料類型和業務需求 將資料儲存到不同類型的儲存空間

開發人員如何申請來源試用?

註冊 Privacy Sandbox 關聯性和評估計畫 試用。使用以下 HTML 標記,在您要執行 API 程式碼的每個網頁上提供試用權杖:

  • 頂層頁面的 <head> 部分中的 <meta> 標記: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • 頂層網頁回應中的 HTTP 標頭: Origin-Trial: TOKEN_GOES_HERE

來源試用的部分功能適用於 跨網站情境,例如以第三方服務形式提供服務時 網站上的廣告如果您需要為這些額外 內容,請務必選取 [第三方比對] 選項。 如要啟用第三方 JavaScript 的來源試用,請插入 <meta> 標記 放在頂層頁面 (亦即第一方網頁,而非您自己的內容) 。例如:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

詳情請參閱 Chrome 來源試用指南

開發人員如何在本機測試?

的個別開發人員說明文件 TopicsFLEDGE歸因分析 報表的用途 有關本機開發人員對各 API 的測試的具體指南。API 未啟用 而且必須在 標記 進行測試。

如要啟用 API 進行測試,您必須:

  • 使用 Chrome 101 Beta 版或以上版本
    • FLEDGE 需要電腦版 Chrome。
    • iOS 版本的 Chrome 不支援 API。
  • 使用 chrome://flags/#privacy-sandbox-ads-apis 啟用 API 旗標。
    • 這個標記會強制啟用 API 以便進行測試,以便更輕鬆地進行測試 複製符合資格的來源試用使用者,在其中加入 您還是可以停用 API,則應該啟動 Chrome 使用 CLI 標記: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs
    • 個別 API 可能會有更多額外旗標 請參閱個別指南以瞭解詳情
    • 其他旗標可能會與這個旗標相衝突,因此請只考慮設定 如果遇到問題,我們還會標記這個標記。
  • 在 Chrome 設定中啟用 Privacy Sandbox 試用功能:依序點選「設定」> 安全性與隱私權 >Privacy Sandbox。這也可存取 通知時間:chrome://settings/adPrivacy
  • 在 Chrome 設定中前往 [設定] > [啟用第三方 Cookie] 安全性與隱私權:將「Cookie 和其他網站資料」設為 允許所有 Cookie或「在無痕模式中封鎖第三方 Cookie」這是 也可在 chrome://settings/cookies 存取。
  • 使用標準瀏覽工作階段。不要使用無痕模式。

開發人員如何檢查來源試用的設定是否正確?

Chrome 來源試用疑難排解 提供詳細的檢查清單,協助您驗證來源的設定 試用。

開發人員工具顯示「應用程式」下方的來源試用狀態

開發人員工具會在「應用程式」分頁的「應用程式」分頁中顯示來源試用的狀態 頁框,

雖然來源試用只會在符合資格的情況下顯示 使用者,您也可以使用開發人員 標記,用於測試生產網站。

哪些使用者有資格參加來源試用?

來源試用旨在只在整體環境中的一小部分執行 Chrome 流量,以及 因此即使已啟用來源 試用使用者可能未啟用 API。有效 來源試用中的實驗組一開始使用的使用者比例偏低 且可能會隨著試驗進展逐步提高。請注意 實驗中的 Chrome 使用者可能與已啟用的使用者百分比不符

不過,為了進行跨網站統一測試,也就是一組符合資格的使用者 應該會保持一致舉例來說,如果使用者符合 來源試用 (同樣是 使用者透過參與計畫的廣告主完成轉換時,仍符合資格 網站。

使用者符合下列條件才符合資格:

  • 使用 Chrome 101 Beta 版
    • FLEDGE 需要電腦版 Chrome。
    • iOS 版 Chrome 沒有來源試用。
  • 「有效來源試用期間」執行瀏覽程序。
  • 依序點選「設定」>「啟用 Privacy Sandbox 試用功能」安全性與 隱私權 >Privacy Sandbox,您也可以透過 chrome://settings/adPrivacy
  • 已透過 [設定] > [啟用第三方 Cookie]安全性與隱私權 > Cookie 和其他網站資料集已設為「允許所有 Cookie」或「封鎖」 並可透過無痕模式存取 chrome://settings/cookies
  • 使用標準瀏覽工作階段,但不是無痕模式
  • 該群組位在 Chrome 的有效實驗群組中。

開發人員應如何偵測 API 支援?

如同任何網路平台功能,您應偵測支援這項功能 才能使用。

主題

檢查 document 中是否有 browsingTopics() 函式,並 權限政策](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) 「瀏覽主題」

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

如果您想加入廣告興趣群組,請查看以下項目中是否使用 joinAdInterestGroup 函式: navigator 和「join-ad-interest-group」的權限政策。

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

如果要進行競價,請檢查 navigator 中的 runAdAuction 函式,以及「執行廣告競價」的權限政策。

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

歸因報表

請找出 window 中的 attributionReporting 物件,並 「歸因報表」的權限政策。

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

開發人員可以在哪裡提供意見及獲得支援?

意見回饋總覽頁面詳細說明瞭 針對 Privacy Sandbox 各方面提供意見回饋的方法。 可自訂版面 TopicsFLEDGE歸因分析 報表 以及個別 API 的個別連結

我們也會定期提供最新消息 沙箱系列,提供重要新聞的摘要。