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

Privacy Sandbox 包含一組提案,可用於啟用廣告用途,而且不需要跨網站追蹤。來源試用可讓開發人員透過實際測試,評估新網路技術並提供意見回饋。在之前的來源試用網站,已能對個別 API 進行測試。針對 Topics,FLEDGE 和 Attribution Reporting API 將提供單一來源試用,讓網站可以在構成端對端廣告生命週期的初始版各個 API 中執行統合實驗。在 Chrome 101 Beta 版和更新版本中均提供測試 API。在我們疊代設定選項的過程中,Chrome 101 Beta 版也會看到使用者控制項更新內容

開發人員將可申請這項單一來源試用,並在 Topics、FLEDGE 和 Attribution Reporting API 中進行測試。本指南會逐步引導您完成 API 存取設定步驟、說明如何驗證設定,並提供更多可用於測試 API 的資源。

來源試用內容

此來源試用的目的是在廣告生命週期中,對多個網站進行有意義的測試。為因應這項歷程,來源試用包含:

  • 主題:透過 document.browsingTopics() 觀察及存取瀏覽器的主題。
  • FLEDGE:管理瀏覽器的興趣群組,以及根據這些群組和其他信號顯示的廣告出價與選擇。
    • 在這項來源試用中,您可以在電腦上使用 FLEDGE,且提供所有提議功能的具體子集。詳情請參閱 FLEDGE 來源試用詳細資料
  • Fenced Frame:顯示 FLEDGE 廣告競價勝出者不透明網址
  • 歸因報表:評估廣告生命週期的成效並製作相關報表。
    • 在 Attribution Reporting 中,匯總服務必須處理及匯總可匯總報表,才能產生摘要報表。我們很快就會發布其他工具和指南,用於本機和來源試用測試。
    • 如果您曾參與歸因報表的來源試用,則必須根據最新的 API 異動配合更新。詳情請參閱遷移指南

這項設定雖可讓這些 API 進行統一測試,但您可以挑選要實作的層面,決定要實作的方面,最小或部分規模。

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

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

  • <meta> 標記 (位於頂層頁面的 <head> 部分): <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。
    • API 不適用於 iOS 版本的 Chrome。
  • 使用 chrome://flags/#privacy-sandbox-ads-apis 旗標啟用 API
    • 這個標記會強制啟用 API,以便簡化測試作業。如果您要複製符合資格的來源試用使用者,且其其他設定仍可停用 API,請使用 CLI 旗標 --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs 啟動 Chrome。
    • 個別 API 可能會有更多其他標記以進行更精細的設定,請參閱個別指南以瞭解詳情。
    • 其他標記可能會與這個檔案發生衝突,因此建議只在遇到問題時設定這個旗標。
  • 在 Chrome 設定中啟用 Privacy Sandbox 試用功能,方法是依序前往「設定」 >「安全性與隱私權」 >「Privacy Sandbox」。也可在 chrome://settings/adPrivacy 存取。
  • 在 Chrome 設定中「設定」 >「安全性與隱私權」,即可啟用第三方 Cookie。將「Cookie 和其他網站資料」設為「允許所有 Cookie」或「在無痕模式中封鎖第三方 Cookie」。也可透過 chrome://settings/cookies 存取。
  • 處於標準瀏覽工作階段。請勿使用無痕模式。

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

排解 Chrome 來源試用問題一文提供詳細的檢查清單,可協助您驗證來源試用的設定。

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

開發人員工具會在「Applications」分頁的「Frames」下方顯示來源試用狀態。

雖然來源試用只會向符合資格的使用者顯示 (如下所述),但您也可以使用開發人員標記,針對自己的正式版網站進行測試。

哪些使用者符合來源試用資格?

在設計上,來源試用只會針對整體 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() 函式,並瞭解「browsing-topics」的權限政策 (https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature)。

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

FLEDGE

若要加入廣告興趣群組,請檢查 navigator 中的 joinAdInterestGroup 函式以及「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
}

Attribution Reporting

請在 window 中檢查 attributionReporting 物件,並參閱「歸因報表」的權限政策。

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

開發人員可在哪裡提供意見回饋和支援?

意見回饋總覽頁面」會詳細說明 Privacy Sandbox 各方面提供意見回饋的各種途徑。TopicsFLEDGE歸因報表有特定的章節,會提供每個 API 的個別連結。

此外,我們也會定期提供 Privacy Sandbox 系列的最新進度摘要,內容為重要新聞摘要。