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

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

Privacy Sandbox 包含多項提案，可讓您在不需跨網站追蹤的情況下，進行廣告用途。原始碼試用可讓開發人員透過實際測試，評估及回報新網路技術的成效。Privacy Sandbox 關聯性和成效評估來源試用提供單一試用，讓網站能針對 Attribution Reporting、Protected Audience API、Topics、Fenced Frames 和 Shared Storage 執行統一實驗。開發人員可以註冊這項單一來源試用，以便測試 Topics、Protected Audience API 和 Attribution Reporting API。本指南將逐步說明如何設定存取 API，以及如何驗證設定，並提供更多資源，方便您測試 API。

查看原始碼試用計畫的狀態

2023 年 6 月

穩定版私密匯總功能推出 7% 的升級

Private Aggregation API 將於 2023 年 6 月 6 日星期二推出，適用於 7% 的 Chrome 穩定版流量。這項 API 將在主要統一來源試用群組 (5%)、Protected Audience 隔離群組 (1%) 和 Shared Storage 隔離群組 (1%) 中提供。由於 Private Aggregation 是新增至現有的獨立實驗，因此 Protected Audience 和 Shared Storage 的流量分配不會變更。

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

API	流量分配	狀態
歸因報表	統合式 - 5%	截至 2023 年 3 月 13 日，穩定版流量的 6%
	已隔離 - 1% - 僅限 ARA
Fenced Frames	統合式 - 5%	截至 2023 年 3 月 13 日，穩定版流量的 7%
	隔離 - 1% - 僅限 Shared Storage + Private Aggregation + Fenced Frames
	隔離 - 1% - 僅限 Protected Audience + Private Aggregation + Fenced Frames
Protected Audience	統合式 - 5%	截至 2023 年 3 月 13 日，穩定版流量的 6%
	隔離 - 1% - 僅限 Protected Audience + Private Aggregation + Fenced Frames
Private Aggregation	統合式 - 5%	截至 2023 年 6 月 6 日，穩定版流量的 7%
	已隔離 - 1% - 僅限 Protected Audience + Private Aggregation + Fenced Frames
	隔離 - 1% - 僅限 Shared Storage + Private Aggregation + Fenced Frames
共用儲存空間	統合式 - 5%	截至 2023 年 3 月 13 日，穩定版流量的 6%
	隔離 - 1% - 僅限 Shared Storage + Private Aggregation + Fenced Frames
主題	統合式 - 5%	截至 2023 年 3 月 13 日，穩定版流量的 6%
	已隔離 - 1% - 僅限主題

先前的更新內容

查看先前有關原始試用的更新。

2023 年 4 月

在穩定版中，私密匯總功能會逐步開放給 1% 的使用者

Private Aggregation API 來源試用將於 4 月 17 日星期一開始，開放 1% 的 Chrome 穩定版統一實驗流量使用。您可以在 Protected Audience API 和 Shared Storage 的工作集使用私密匯總的 sendHistogramReport() 函式。

自 4 月 17 日星期一起，流量分配比例如下：

API	流量分配	狀態
歸因報表	統合式 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 僅限 ARA
Fenced Frames	統合式 - 5%	2023 年 3 月 13 日起，穩定版流量的 7%
	Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
	隔離 - 1% - 僅限 Protected Audience API + 設有圍欄的影格
Protected Audience API	統合式 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	隔離 - 1% - 僅限 Protected Audience API + 設有圍欄的影格
私密匯總	統合式 - 1%	自 2023 年 4 月 17 日起，穩定版流量的 1%
共用儲存空間 (網址選取)	統合式 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
主題	統合式 - 5%	自 2023 年 3 月 13 日起，穩定版流量的 6%
	已隔離 - 1% - 僅限主題

2023 年 3 月

時間軸更新

我們原先表示會於 2023 年 3 月 13 日 (星期一) 開始進行獨立實驗，但由於需要更多時間設定實驗，因此新實驗將於 2023 年 3 月 16 日 (星期四) 啟動。3 月 16 日 (星期四) 也會將 Protected Audience API 的 1% 流量從 4% 調回 5%。

Protected Audience API 恢復 1% 的流量

上個月，我們暫時將 Protected Audience API 來源試用流量從 5% 降至 4% 的 Chrome 穩定版，以進行測試。初步測試已結束，我們預計在 2023 年 3 月 16 日 (星期四)，將統一實驗的 Protected Audience API 流量從 4% 調回 5%。

系統會將使用者人數調回先前的規模。不過，由於距離停用時間已超過 30 天，因此先前的興趣群組已失效。

獨立實驗

為改善測試程序並持續觀察原始碼試用 API 的指標，我們將為每個 API 建立獨立實驗，並保留現有的統一實驗。系統會為 Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 的組合，以及 Shared Storage 的網址選取作業和 Fenced Frames 的組合，建立新的實驗。在每個獨立實驗中，該群組的使用者只能使用指派的 API。

API	隔離實驗流量分配
歸因報表	1%
Protected Audience API + Fenced Frame	1%
共用儲存空間 (網址選取) + 設有圍欄的影格	1%
主題	1%

自 3 月 16 日星期四起，您將開始收到上述 API 的額外 1% Chrome 穩定版流量，加上現有整合式實驗的 5% 流量，總共是 6% 的流量。系統會將新使用者分配給各項實驗。

流量分配

截至 2 月 28 日星期二，目前統一原始碼試用流量分配如下：

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

Protected Audience API 重新啟用後，流量分配情形如下 (3 月 16 日星期四開始)，新的獨立實驗也將隨之展開：

API	新的流量分配	狀態
歸因報表	統合式 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
歸因報表	隔離 - 1% - 僅限 ARA	自 2023 年 3 月 16 日起，穩定版流量的 6%
Fenced Frames	統合式 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 7%
	Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only
	隔離 - 1% - 僅限 Protected Audience API + 設有圍欄的影格
Protected Audience API	統一 - 5% (目前分配的 4% + 1% 恢復)	自 2023 年 3 月 16 日起，穩定版流量的 6%
Protected Audience API	隔離 - 1% - 僅限 Protected Audience API + 設有圍欄的影格	自 2023 年 3 月 16 日起，穩定版流量的 6%
共用儲存空間 (網址選取)	統合式 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
共用儲存空間 (網址選取)	Isolated - 1% - Shared Storage (URL Selection) + Fenced Frames only	自 2023 年 3 月 16 日起，穩定版流量的 6%
主題	統合式 - 5%	自 2023 年 3 月 16 日起，穩定版流量的 6%
主題	已隔離 - 1% - 僅限主題	自 2023 年 3 月 16 日起，穩定版流量的 6%

這些變更不會影響現有的原始碼試用權杖設定，您也不必續約或產生新的原始碼試用權杖。

2023 年 1 月

為調查 Chrome 迴歸問題，自 2023 年 1 月 26 日起，我們會暫時將 Protected Audience API 來源試用流量從 Chrome 穩定版的 5% 降至 4%。我們預估調查時間約為一個月，待流量恢復後會通知您。

這項異動會自動生效，不會影響現有的原始碼試用權杖。對於流量會減少的 1% 使用者，興趣群組仍會保留在瀏覽器中。這些使用者會再次成為升級對象，且興趣群組可重複使用。不過，興趣群組會在 30 天後過期，而迴歸調查可能需要更長的時間。

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

API	附註
歸因報表	穩定版適用，2022 年 10 月 26 日起調高至 5%。
主題	穩定版適用，2022 年 10 月 26 日起調高至 5%。
Protected Audience API	適用於穩定版，2023 年 1 月 26 日起暫時調降至 4%。
Fenced Frames API	穩定版將於 2022 年 11 月 9 日起調漲至 5%。
共用儲存空間	穩定版將於 2023 年 1 月 26 日起調漲 5%。

2022 年 11 月

從 11 月 9 日起，Shared Storage 的 `selectURL` API 將加入來源試用，並適用於 1% 的 Chrome 穩定版流量。

如先前在「將 Privacy Sandbox 相關性和成效評估來源試用擴大至 5%」網誌文章中所述，Attribution Reporting 和 Topics 的試用比例現已提高至 5%，Protected Audience API 和 Fenced Frames 也將於 11 月 9 日跟進。

API	附註
歸因報表	適用於穩定版，自 10 月 26 日起調高至 5%。
主題	適用於穩定版，自 10 月 26 日起調高至 5%。
Protected Audience API	穩定版適用，11 月 9 日起將增加至 5%。
Fenced Frames API	穩定版適用，11 月 9 日起將增加至 5%。
共用儲存空間	將於 11 月 9 日起在穩定版推出，初期比例為 1%。

2022 年 10 月：增加 5%

Attribution Reporting、Topics、Protected Audience API 和 Fenced Frames 目前都已在 Chrome 穩定版中推出，並會納入增加的流量。

本週起，我們會開始增加 Attribution Reporting 和 Topics 的流量；Protected Audience API 和 Fenced Frames 的流量則會自 11 月 9 日起增加。

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

API	附註
歸因報表	穩定版將於 10 月 26 日後提高至 5%。
主題	穩定版將於 10 月 26 日後提高至 5%。
Protected Audience API	穩定版適用，11 月 9 日起將增加至 5%。
Fenced Frames API	穩定版適用，11 月 9 日起將增加至 5%。
共用儲存空間	目前僅適用於 M105 以上的 Canary、開發人員和 Beta 版。

2022 年 10 月

來源試用已延長至 Chrome 110。
請參閱「開始使用 Chrome 來源試用計畫」，瞭解如何續訂來源試用計畫。包括為參與的來源提供新權杖，這與其他來源試用期延期遵循的程序相同。

我們延長了期限，讓生態系統有時間在穩定版管道中繼續測試及驗證 API 改進項目，同時根據現有的公開時間表提供意見回饋。

整體 Privacy Sandbox 時程維持不變。

試用版包含的 API：

API	附註
歸因報表	原始碼試用計畫的開發人員指南。
Protected Audience API	原始碼試用計畫的開發人員指南。
主題	原始碼試用計畫的開發人員指南。
Fenced Frames API	請參閱 Protected Audience API 來源試用使用指南。
共用儲存空間	目前僅適用於 M105 以上的 Canary、開發人員和 Beta 版。

2022 年 8 月

從 Chrome 穩定版 104 開始，原始碼試用計畫的適用對象會逐步擴大，最終涵蓋 1% 的電腦使用者。
如果行動版也適用，我們會在日後發布更新。
穩定前版本 (Canary 版、Beta 版) 的使用者比例仍為 50%。
iOS 版 Chrome 不支援 API。

2022 年 5 月

Chrome 102 Beta 版推出後，來源試用計畫的適用對象將擴大至 50% 的使用者。

試用版包含的 API：

API	附註
歸因報表	原始碼試用計畫的開發人員指南。
Protected Audience API	原始碼試用計畫的開發人員指南。
主題	原始碼試用計畫的開發人員指南。由於影響瀏覽器穩定性的錯誤，我們在原始試用期間短暫停用了 Topics。
Fenced Frames API	Fenced Frames 已加入來源試用。如要瞭解如何使用實驗，請參閱 Protected Audience API 指南。

2022 年 4 月

原始碼試用活動會先開放 Chrome 102 Beta 版的一小部分使用者。

試用版包含的 API：

API	附註
歸因報表	個別意圖到實驗 (I2E)貼文。歸因報表也可做為個別來源試用。
Protected Audience API	個別意圖到實驗 (I2E)貼文。Protected Audience API 僅適用於桌機，且功能有限。
主題	個人意圖到實驗 (I2E) 貼文。

申請並設定來源試用

如要在網站上啟用來源試用功能，您必須註冊並嵌入獲派的來源試用權杖 (這是根據時間產生的字串，可讓您存取來源試用功能)。詳情請參閱「開始使用 Chrome 的來源試用計畫」。

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

如要在任何網頁上使用原始碼試用功能，您都必須在該網頁的 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);

偵錯來源試用

您可以在「開發人員工具」 >「應用程式」面板中，查看原始碼試用狀態。

向下捲動至「Frames」窗格。
選取預期要設定權杖的影格。例如，頂層網頁的頂端框架，或是嵌入網頁的特定 iframe。
在右側窗格中，向下捲動至「Origin Trials」部分。
您應該會看到 PrivacySandboxAdsAPIs 試用方案的項目。
展開這個項目，即可查看原始碼試用狀態和特定權杖。

原始碼試用活動僅限一小部分 Chrome 使用者參加，您的瀏覽器可能不在實驗群組中。因此，您可能會看到 PrivacySandboxAdsAPIs 旁邊出現紅色 TrialNotAllowed 訊息。展開項目以檢查權杖狀態時，如果顯示綠色 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 和其他網站資料」設為「允許所有 Cookie」或「在無痕模式下封鎖第三方 Cookie」，您也可以透過 chrome://settings/cookies 存取這些設定。
處於標準瀏覽工作階段，且未開啟無痕模式。

雖然只有符合資格的使用者會看到來源試用功能處於啟用狀態，但您也可以使用開發人員旗標，在自己的正式版網站上進行測試。

控管您參與來源試用的情況

原始碼試用機制的運作方式不變：您要先取得原始碼試用權杖，才能在想實驗 API 的環境中使用。測試對象擴大後，請務必主動監控並控管您選擇啟用試用的流量層級。

建議做法如下：

根據預設，在所有要進行實驗的環境中，都應加入原始試用權杖。
使用功能偵測檢查是否有作用中的 API。
如果 API 處於啟用狀態 (因此瀏覽器符合這項實驗的資格)，請根據自己的實驗條件選擇是否使用。舉例來說，如果您已有 A/B 測試基礎架構，可針對流量百分比、取樣或其他屬性進行實驗，此時即可決定要主動使用哪些功能。

如要完全禁止任何瀏覽器執行個體參與原始碼試用，請勿在回應中加入權杖。舉例來說，如果您已達到實驗配額，或需要在試用期間解決問題，則不加入權杖可確保網頁不會提供或啟用任何實驗功能。

依地理區域控管來源試用

您無法針對特定區域停用原始碼試用功能。如果網頁包含權杖 (透過 HTTP 標頭 (伺服器端) 或 HTML 中繼標記 (用戶端) 加入)，來源試用就會在該網頁上啟用。

如果您可以判斷使用者的位置，則可以編寫程式碼，根據該位置資訊加入原始試用權杖。舉例來說，您可能會嘗試使用 IP 位址判斷使用者的位置。IP 位址可能會遭到偽造，因此這並非萬無一失的解決方案。

不過，特定地理位置的來源可以設定權限政策，控管可使用的功能。舉例來說，us.example.com 和 uk.example.com 是可控管的特定地理位置來源。這不代表該區域已選擇不參與來源試用。

網站會透過權限政策，在網頁中加入一小段程式碼，向瀏覽器提供指示。網頁載入時，瀏覽器會讀取權限政策指令，並根據權限政策允許或封鎖功能 (或 API)。如果網站想限制特定區域的 API，開發人員可以為該區域要求的所有網頁設定政策。

續訂權杖

原始碼試用權杖會在核發日期後六週失效 (或在試用期結束時失效，以較早者為準)。

請務必在該時間範圍內更新及部署新權杖，確保來源試用功能不會中斷。

更新權杖只需要幾分鐘，您可以在同一個頁面中，為同一個試用期部署多個權杖。您可以在現有權杖到期前部署更新的權杖，確保使用者服務不中斷。

在本機測試

如需本機開發人員測試的具體指引，請參閱：

這些 API 預設為關閉，必須使用標記啟用才能進行測試。請確認您已啟用上述相同的設定，然後：

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

請參閱開發人員指南，瞭解特定 API 和功能的適用情形，以及用於更精細設定的其他標記。

針對關聯性和評估數據的統合式來源試用 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

查看原始碼試用計畫的狀態

2023 年 6 月

穩定版私密匯總功能推出 7% 的升級

先前的更新內容

2023 年 4 月

在穩定版中，私密匯總功能會逐步開放給 1% 的使用者

2023 年 3 月

時間軸更新

Protected Audience API 恢復 1% 的流量

獨立實驗

流量分配

2023 年 1 月

2022 年 11 月

2022 年 10 月：增加 5%

2022 年 10 月

2022 年 8 月

2022 年 5 月

2022 年 4 月

申請並設定來源試用

使用 iframe 設定

使用 JavaScript 設定跨網站追蹤

偵錯來源試用

偵測特徵

判斷使用者是否符合資格

瀏覽器設定

使用者設定

控管您參與來源試用的情況

依地理區域控管來源試用

續訂權杖

在本機測試

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