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 廣告競價勝出者的不透明網址。
- 歸因報表:評估廣告生命週期的成效並製作相關報表。
這項設定雖可讓這些 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 來源試用指南。
開發人員如何在本機測試?
Topics、FLEDGE 和歸因報表的個別開發人員說明文件,針對各個 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 可能會有更多其他標記以進行更精細的設定,請參閱個別指南以瞭解詳情。
- 其他標記可能會與這個檔案發生衝突,因此建議只在遇到問題時設定這個旗標。
- 這個標記會強制啟用 API,以便簡化測試作業。如果您要複製符合資格的來源試用使用者,且其其他設定仍可停用 API,請使用 CLI 旗標
- 在 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 各方面提供意見回饋的各種途徑。Topics、FLEDGE 和歸因報表有特定的章節,會提供每個 API 的個別連結。
此外,我們也會定期提供 Privacy Sandbox 系列的最新進度摘要,內容為重要新聞摘要。