針對關聯性和評估數據的統合式來源試用

Topics、Fenced Frames 和 Shared Storage。 關鍵字：product:PrivacySandbox、docType:Guide、topicAdSetup、contentTypeSolution、Category:Web、apiGroupAds、audienceAdBuyer、audienceAdSeller、audienceAdMeasurementProvider, Ski:新手

Privacy Sandbox 包含啟用廣告功能的一系列提案 不需要跨網站追蹤起源 試用 並透過實際測試，向新網路技術提供意見。 Privacy Sandbox 關聯性和 Measurement 來源試用 提供的單一試用服務，可讓網站跨多個 Attribution Reporting、Protected Audience API、Topics、Fenced Frames 和 Shared 儲存空間： 開發人員可以註冊這項單一來源試用計畫， 和 Attribution Reporting API 的基本更新這個 本指南會逐步引導您設定 API 的存取步驟 並提供其他測試資源 與 API 的相對應

重要詞彙： 「流量」是指 Chrome 瀏覽器執行個體的百分比 已納入試用範圍，而不是對個別網站提出的要求百分比。

查看來源試用的狀態

2023 年 6 月

穩定版私人匯總資料 7% 逐步提高數量

Private Aggregation API 來自 2023 年 6 月 6 日星期二的 Chrome 穩定版流量為 7%。API 屬於受保護來源試用群組 (5%)、受保護 目標對象排除群組 (1%) 和共用儲存空間獨立群組 (1%)。 Protected Audience 和共用儲存空間的流量分配將維持不變 這是因為系統在現有的獨立實驗中加入「私人匯總」功能

6 月 6 日星期二的流量分配：

API	流量分配	狀態
歸因報表	統一 - 5%	截至 2023 年 3 月 13 日，截至 6% 的穩定流量
	隔離 - 1% - 僅限 ARA
圍欄頁框	統一 - 5%	截至 2023 年 3 月 13 日，目前 7% 的穩定流量
	隔離 - 1% - 共用儲存空間 + 私人匯總 + 僅限圍欄頁框
	隔離 - 1% - Protected Audience + 私密匯總 + 僅限圍欄頁框
Protected Audience	統一 - 5%	截至 2023 年 3 月 13 日，截至 6% 的穩定流量
	隔離 - 1% - Protected Audience + 私密匯總 + 僅限圍欄頁框
私人匯總資料	統一 - 5%	截至 2023 年 6 月 6 日，目前 7% 的穩定流量
	隔離 - 1% - Protected Audience + 私密匯總 + 僅限圍欄頁框
	隔離 - 1% - 共用儲存空間 + 私人匯總 + 僅限圍欄頁框
共用儲存空間	統一 - 5%	截至 2023 年 3 月 13 日，截至 6% 的穩定流量
	隔離 - 1% - 共用儲存空間 + 私人匯總 + 僅限圍欄頁框
主題	統一 - 5%	截至 2023 年 3 月 13 日，截至 6% 的穩定流量
	已隔離 - 1% - 僅限主題

先前的更新內容

查看來源試用的先前更新。

2023 年 4 月

穩定版的私人匯總資料，逐步增加 1%

不公開的 Aggregation API 來源試用費用為 Chrome 穩定版 1% 4 月 17 日 (星期一) 的統合實驗流量。sendHistogramReport() Protected Audience API 中提供了 Private Aggregation 的功能 和共用儲存空間 和 Worklets。

4 月 17 日星期一起，流量分配方式如下：

API	流量分配	狀態
歸因報表	統一 - 5%	2023 年 3 月 13 日起，6% 的穩定流量
	隔離 - 1% - 僅限 ARA
圍欄頁框	統一 - 5%	2023 年 3 月 13 日起，7% 的穩定流量
	隔離 - 1% - 共用儲存空間 (網址選擇) + 僅限圍欄頁框
	隔離 - 1% - 僅限 Protected Audience API + Fenced Frame
Protected Audience API	統一 - 5%	2023 年 3 月 13 日起，6% 的穩定流量
	隔離 - 1% - 僅限 Protected Audience API + Fenced Frame
私人匯總資料	統一 - 1%	2023 年 4 月 17 日以來的 1% 穩定流量
共用儲存空間 (選擇網址)	統一 - 5%	2023 年 3 月 13 日起，6% 的穩定流量
	隔離 - 1% - 共用儲存空間 (網址選擇) + 僅限圍欄頁框
主題	統一 - 5%	2023 年 3 月 13 日起，6% 的穩定流量
	已隔離 - 1% - 僅限主題

2023 年 3 月

時間軸更新

我們一開始曾通知您，我們會在星期一進行獨立實驗 2023 年 3 月 13 日，新實驗將於 3 月 16 日星期四 設定實驗所需的時間為 2023 年。1% 此外，星期四也會將 Protected Audience API 適應期從 4% 恢復至 5%。 2023 年 3 月 16 日。

Protected Audience API 1% 適應期

上個月，為了進行測試，我們暫時將 Protected Audience API 來源試用流量從 5% 降低至 4%。初步測試已完成，我們預計在 2023 年 3 月 16 日星期四，針對這項統合實驗，讓 Protected Audience API 的使用率從 4% 提高至 5%。

增加曝光數的使用者會是受減少使用的使用者群組。但是，他們先前的興趣群組已過了 30 天以上，但這段時間已縮短。

隔離實驗

為改善測試程序並持續觀察來源試用 API 的指標，除了現有的統一實驗外，我們還會為每個 API 建立獨立的實驗。系統將針對 Attribution Reporting、Topics 建立新的實驗，並結合 Protected Audience API 和 Fenced Frames，並結合共用儲存空間的網址選取作業和 Fenced Frame。在每個單獨的實驗中，只有獲派的 API 能提供給該群組的使用者。

API	隔離實驗 流量分配
歸因報表	1%
Protected Audience API + Fenced Frames	1%
共用儲存空間 (網址選擇) + Fenced Frame	1%
主題	1%

自 3 月 16 日星期四起， 上述 API 的 Chrome 穩定流量 (在您擁有的 5% 流量之上) 接收來自現有統一實驗的流量將分配新使用者 每個實驗不同

流量分配

截至 2 月 28 日星期二為止，目前統一來源試用的流量分配情況如下：

API	目前統一實驗 流量分配
歸因報表	5%
圍欄頁框	5%
Protected Audience API	4%
共用儲存空間 (選擇網址)	5%
主題	5%

自 3 月 16 日星期四起，Protected Audience API 恢復運作，並開始新的獨立實驗，流量分配會如下所示：

API	新的流量分配	狀態
歸因報表	統一 - 5%	2023 年 3 月 16 日起，6% 的穩定流量
	隔離 - 1% - 僅限 ARA
圍欄頁框	統一 - 5%	2023 年 3 月 16 日以來的 7% 穩定流量
	隔離 - 1% - 共用儲存空間 (網址選擇) + 僅限圍欄頁框
	隔離 - 1% - 僅限 Protected Audience API + Fenced Frame
Protected Audience API	統一 - 5% (目前分配的 4% + 1% 適應期)	2023 年 3 月 16 日起，6% 的穩定流量
	隔離 - 1% - 僅限 Protected Audience API + Fenced Frame
共用儲存空間 (選取網址)	統一 - 5%	2023 年 3 月 16 日起，6% 的穩定流量
	隔離 - 1% - 共用儲存空間 (網址選擇) + 僅限圍欄頁框
主題	統一 - 5%	2023 年 3 月 16 日起，6% 的穩定流量
	已隔離 - 1% - 僅限主題

這些變更不會影響您現有的來源試用權杖設定，您也不需要續約或產生新的來源試用權杖。

2023 年 1 月

在 Chrome 迴歸調查中，自 2023 年 1 月 26 日起，我們將暫時將 Protected Audience API 來源試用流量從 Chrome 穩定版的 5% 降低至 4%。我們預估調查需要一個月左右的時間，並在流量恢復時通知您。

這項異動會自動生效，不會影響現有的來源試用權杖。對於 1% 流量即將減少的使用者，興趣群組會保留在瀏覽器中。相同的使用者將獲得存取權，並且可以重複使用他們的興趣群組。然而，興趣群組會在 30 天後失效，且迴歸調查可能需要較長時間才能完成。

此外，自 2023 年 1 月 26 日起，Shared Storage 的 URL Selection API 來源試用將增加為 5% 的 Chrome 穩定版流量。

API	附註
歸因報表	目前提供穩定版，自 2022 年 10 月 26 日起增加至 5%。
主題	目前提供穩定版，自 2022 年 10 月 26 日起增加至 5%。
Protected Audience API	推出穩定版，自 2023 年 1 月 26 日起暫時調降至 4%。
圍欄頁框	可使用穩定版，自 2022 年 11 月 9 日起增加至 5%。
共用儲存空間	這項功能提供穩定版，較 2023 年 1 月 26 日增加了 5%。

2022 年 11 月

自 11 月 9 日起，共用儲存空間的「selectURL」API 將加入來源試用，佔 Chrome 穩定版流量的 1%。

如先前在「將 Privacy Sandbox 關聯性和評估來源試用計畫提高至 5%」網誌文章所述，自 11 月 9 日起，歸因報表和 Topics 現在已佔 5%。

API	附註
歸因報表	目前提供穩定版，自 10 月 26 日起增加至 5%。
主題	目前提供穩定版，自 10 月 26 日起增加至 5%。
Protected Audience API	這項功能提供穩定版，自 11 月 9 日起將增加至 5%。
圍欄頁框	這項功能提供穩定版，自 11 月 9 日起將增加至 5%。
共用儲存空間	自 11 月 9 日起，1% 起將提供穩定版。

2022 年 10 月：增加 5%

Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 目前皆適用於 Chrome 穩定版，我們會計入流量增加的一部分。

自本週起，我們將開始提高 Attribution Reporting 和 Topics 的流量，自 11 月 9 日起將逐漸增加 Protected Audience API 和 Fenced Frames。

詳情請參閱「將 Privacy Sandbox 關聯性和評估來源試用計畫提高至 5%」網誌文章。

API	附註
歸因報表	穩定版提供穩定版，10 月 26 日後將調漲至 5%。
主題	穩定版提供穩定版，10 月 26 日後將調漲至 5%。
Protected Audience API	這項功能提供穩定版，自 11 月 9 日起將增加至 5%。
圍欄頁框	這項功能提供穩定版，自 11 月 9 日起將增加至 5%。
共用儲存空間	目前僅適用於 M105+ Canary、開發人員版和 Beta 版。

2022 年 10 月

• 來源試用已適用於 Chrome 110。
• 開始使用 Chrome 的來源試用說明如何續訂來源試用註冊。這包括向參與的來源提供新權杖 (與加入其他來源試用期限的流程相同)。

這項擴充功能獲得採用，讓生態系統能夠 持續測試及驗證 API 改善項目，並提供意見回饋 與現有的公開時程一致

Privacy Sandbox 整體時程維持不變。

試用期內的 API：

API	附註
歸因分析 報表	開發人員 來源試用指南。
Protected Audience API	開發人員 來源試用指南。
主題	開發人員 來源試用指南。
圍欄 影格	如要瞭解來源試用的使用方法，請參閱 Protected Audience API 指南。
分享 儲存空間	目前僅適用於 M105+ Canary、開發人員版和 Beta 版。

2022 年 8 月

• 來自 Chrome 穩定版的電腦使用者多達 1% 的來源試用功能
• 我們會在供應情形納入行動使用者後，據此更新資料。
• 預先發布版本 (初期測試版本、Beta 版) 的使用者仍佔 50% 的使用者。
• iOS Chrome 不支援 API。

2022 年 5 月

Chrome 102 Beta 版的使用者在來源試用期間高達 50% 的可用性。

試用期內的 API：

API	附註
歸因分析 報表	開發人員 來源試用指南。
Protected Audience API	開發人員 來源試用指南。
主題	開發人員指南 來源試用。主題在來源試用期間短暫停用， 影響到瀏覽器的穩定性
圍欄 影格	Fenced Frames 已新增至來源試用。查看 Protected Audience API 指南 進行實驗。

2022 年 4 月

來源試用在 Chrome 102 Beta 版中只有一定比例的使用者開始試用。

試用期內的 API：

API	附註
歸因分析 報表	個別意願 進行實驗 (I2E)。你也可以使用歸因報表 以及個別來源試用方案
Protected Audience API	個別意願 進行實驗 (I2E)。Protected Audience API 僅適用於電腦， 功能子集
主題	個別意願 進行實驗 (I2E)。

註冊並設定來源試用

如要在網站上啟用來源試用，請註冊並嵌入 指派的來源試用權杖 (以時間為準的字串，專門用於存取 來源試用)。詳情請參閱 Chrome 來源入門指南 試用期。

注意： 註冊 Privacy Sandbox 關聯性和評估計畫 試用。

系統會立即授予來源試用權杖，您可以撤銷或重新建立這類權杖 。

對於要使用來源試用的每個網頁，您需要加入 並附上該特定網頁 HTML 或回應的試用權杖。

在網頁的 <head> 區段中使用 <meta> 標記：

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

您也可以在網頁回應中加入下列 HTTP 標頭：

Origin-Trial: TOKEN_GOES_HERE

使用 iframe 進行設定

如果在 iframe 中使用來源試用功能 (例如 Protected Audience API 的 joinAdInterestGroup())，則您必須在 iframe 內提供符記 且符合 iframe 的來源

使用 JavaScript 設定跨網站

透過跨網站 JavaScript 使用來源試用功能，就像 頂層頁面內含的第三方 JavaScript 供應商。 接著，您必須執行以下作業：

• 在註冊來源時選取「第三方比對」選項 試用。
• 「網路來源」欄位應該是指令碼的來源。
• 在頂層頁面 (也就是第一方) 中插入 <meta> 標記 而非您自己的內容)例如：

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

對來源試用偵錯

您可以在「開發人員工具」DevTools中查看來源測試的狀態 >應用程式 面板。

權杖成功狀態並啟用。

1. 向下捲動至「Frames」窗格。
2. 選取要用來設定符記的頁框。例如頂端 頂層網頁的頁框，或為嵌入網頁的特定 iframe。
3. 在右側窗格中，向下捲動至「Origin Trials」(來源試用) 部分。
4. 您應該會看到 PrivacySandboxAdsAPIs 試用方案的項目。
5. 展開這個項目即可查看來源試用的狀態和您的 符記

來源試用僅限部分 Chrome 使用者，你的瀏覽器可能會 未加入群組因此，您可能會看到紅色的 TrialNotAllowed 對 PrivacySandboxAdsAPIs 建立訊息。當您展開項目以檢查 權杖狀態 (如果顯示綠色 Success 訊息，表示來源試用) 設定正確符合資格的使用者會看到訊息已設為「Enabled」。

權杖成功狀態，未啟用。

如果畫面上顯示其他訊息，請參閱排解 Chrome 來源問題 試用 提供詳盡的檢查清單，驗證來源試用的設定。

偵測功能

和所有網路功能一樣，請務必檢查這些功能都位於 然後才使用方法是查看 相關 API 是否存在：

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

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

判斷使用者資格

正在對少數 Chrome 使用者進行來源試用。也必須有 廣告客戶設定中已啟用相關功能 試用期：

瀏覽器設定

使用者必須具備下列條件，才符合試用資格：

• 使用來源試用的 Chrome 版本和版本 備用資源

  • 如要瞭解目前設定，請參閱來源試用狀態。

• 進入 Chrome 的有效實驗群組。

使用者設定

使用者也必須符合下列條件，才能享有試用資格：

• 依序點選「設定」>「啟用 Privacy Sandbox 試用功能」安全性與 隱私權 >Privacy Sandbox，您也可以透過 chrome://settings/adPrivacy。
• 已透過 [設定] > [啟用第三方 Cookie]安全性與隱私權 > Cookie 和其他網站資料集已設為「允許所有 Cookie」或「封鎖」 並可透過無痕模式存取 chrome://settings/cookies。
• 使用標準瀏覽工作階段，但不是無痕模式。

只有符合資格的使用者才會看到來源試用資格，但您也可以 使用開發人員標記測試自己的正式版 網站。

控管來源試用的參與情形

來源試用的機制維持不變：取得來源試用 為要測試 API 的結構定義。使用 擴大測試規模，請確保您積極監控 以及控管選擇啟用試用的流量層級

注意： Chrome 穩定版的 5% 流量不會直接對應至您擁有的 5% 流量 網站和服務實際獲得的流量比例取決於 訪客組成。

建議您採取以下做法：

1. 根據預設，在你想使用的所有情境中，加入來源試用權杖 進行實驗。
2. 使用功能偵測功能來檢查使用中的 API。
3. 如果 API 為有效狀態 (因此瀏覽器可在此使用) 實驗)，然後根據實驗結果選擇是否使用 標準。舉例來說，如果已經有 A/B 測試基礎架構 針對特定百分比的流量、取樣或其他屬性進行實驗 接著，您可以決定要主動使用哪些功能。

你可以完全禁止任何瀏覽器加入來源試用 取得憑證。舉例來說 已達到實驗配額，或需要處理 如果未納入此符記，則不會提供任何實驗性功能 網頁上就會有「可用」或「有效」

依地理區域顯示來源試用控制項

你無法在特定區域選擇來源試用。來源試用為 包含 符記，包含 透過 HTTP 標頭 (伺服器端) 或 HTML 中繼標記 (用戶端) 傳送。

如果您可以確定使用者的位置，就能撰寫要納入的程式碼 產生來源試用權杖舉例來說， 可利用 IP 位址來判斷使用者的位置。IP 位址 可能遭到假冒，因此無法保證一定能解決。

不過，特定地理位置的來源可以設定「權限」 用來控管功能的政策 可用性高例如，us.example.com 和 uk.example.com 是 可控制的地理位置專屬來源。這不代表 區域已選擇退出來源試用。

網站設定權限政策時，會在網頁中加入一小段程式碼 提供了指示給瀏覽器網頁載入時，瀏覽器 閱讀權限政策說明，並允許或封鎖功能 (或 API)。假設網站要限制 API 在特定地區，開發人員可以為要求的所有網頁設定政策

警告： 使用者可能會選擇從不同區域造訪來源 以及他們的位置也就是說，位於美國的使用者 可以造訪 uk.example.com。這些使用者會看到 。

更新權杖

來源試用權杖會在核發日算起六週後到期 (或有效期限為 試用。

請務必續購及部署新的 符記 持續使用來源試用功能。

更新權杖只需幾分鐘的時間，您可以為 同一個試用環境您可以在 現有權杖都會過期，使用者也不會中斷服務。

注意： 在 10 月底更新權杖，您必須等到 12 月初才更新。 如果您的代碼在年底到期，建議您 確保您仍可部署更新後的權杖，或計畫暫停參與 這段期間內。

在本機測試

如需當地開發人員測試的具體指南，請參閱：

• 主題
• Protected Audience API
• 歸因報表

根據預設，系統不會啟用 API，您必須透過 標記 進行測試。請務必啟用相同的配置設定 然後：

• 使用支援這些功能的 Chrome 版本和版本。
• 啟用 chrome://settings/adPrivacy 下的所有廣告隱私權 API。

請參閱開發人員指南，瞭解特定 API 和功能的適用情形，並 就能更精細地設定