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 的相對應
查看來源試用的狀態
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 來源入門指南 試用期。
系統會立即授予來源試用權杖,您可以撤銷或重新建立這類權杖 。
對於要使用來源試用的每個網頁,您需要加入 並附上該特定網頁 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中查看來源測試的狀態 >應用程式 面板。
![權杖成功狀態並啟用。](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status.avif?hl=zh-tw)
- 向下捲動至「Frames」窗格。
- 選取要用來設定符記的頁框。例如頂端 頂層網頁的頁框,或為嵌入網頁的特定 iframe。
- 在右側窗格中,向下捲動至「Origin Trials」(來源試用) 部分。
- 您應該會看到
PrivacySandboxAdsAPIs
試用方案的項目。 - 展開這個項目即可查看來源試用的狀態和您的 符記
來源試用僅限部分 Chrome 使用者,你的瀏覽器可能會
未加入群組因此,您可能會看到紅色的 TrialNotAllowed
對 PrivacySandboxAdsAPIs
建立訊息。當您展開項目以檢查
權杖狀態 (如果顯示綠色 Success
訊息,表示來源試用)
設定正確符合資格的使用者會看到訊息已設為「Enabled
」。
![權杖成功狀態且未啟用。](https://developers.google.cn/privacy-sandbox/assets/images/token-success-status-not-enabled.avif?hl=zh-tw)
如果畫面上顯示其他訊息,請參閱排解 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 的結構定義。使用 擴大測試規模,請確保您積極監控 以及控管選擇啟用試用的流量層級
建議您採取以下做法:
- 根據預設,在你想使用的所有情境中,加入來源試用權杖 進行實驗。
- 使用功能偵測功能來檢查使用中的 API。
- 如果 API 為有效狀態 (因此瀏覽器可在此使用) 實驗),然後根據實驗結果選擇是否使用 標準。舉例來說,如果已經有 A/B 測試基礎架構 針對特定百分比的流量、取樣或其他屬性進行實驗 接著,您可以決定要主動使用哪些功能。
你可以完全禁止任何瀏覽器加入來源試用 取得憑證。舉例來說 已達到實驗配額,或需要處理 如果未納入此符記,則不會提供任何實驗性功能 網頁上就會有「可用」或「有效」
依地理區域顯示來源試用控制項
你無法在特定區域選擇來源試用。來源試用為 包含 符記,包含 透過 HTTP 標頭 (伺服器端) 或 HTML 中繼標記 (用戶端) 傳送。
如果您可以確定使用者的位置,就能撰寫要納入的程式碼 產生來源試用權杖舉例來說, 可利用 IP 位址來判斷使用者的位置。IP 位址 可能遭到假冒,因此無法保證一定能解決。
不過,特定地理位置的來源可以設定「權限」
用來控管功能的政策
可用性高例如,us.example.com
和 uk.example.com
是
可控制的地理位置專屬來源。這不代表
區域已選擇退出來源試用。
網站設定權限政策時,會在網頁中加入一小段程式碼 提供了指示給瀏覽器網頁載入時,瀏覽器 閱讀權限政策說明,並允許或封鎖功能 (或 API)。假設網站要限制 API 在特定地區,開發人員可以為要求的所有網頁設定政策
更新權杖
來源試用權杖會在核發日算起六週後到期 (或有效期限為 試用。
請務必續購及部署新的 符記 持續使用來源試用功能。
更新權杖只需幾分鐘的時間,您可以為 同一個試用環境您可以在 現有權杖都會過期,使用者也不會中斷服務。
在本機測試
如需當地開發人員測試的具體指南,請參閱:
根據預設,系統不會啟用 API,您必須透過 標記 進行測試。請務必啟用相同的配置設定 然後:
- 使用支援這些功能的 Chrome 版本和版本。
- 啟用
chrome://settings/adPrivacy
下的所有廣告隱私權 API。
請參閱開發人員指南,瞭解特定 API 和功能的適用情形,並 就能更精細地設定