Topics、Fenced Frames、Shared Storage です。 keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
プライバシー サンドボックスには、クロスサイト トラッキングを必要とせずに広告のユースケースを実現するための一連の提案が含まれています。オリジン トライアルは、デベロッパーが新しいウェブ技術を評価し、実際のテストを通じてフィードバックを提供する機会を提供します。プライバシー サンドボックスの関連性と測定のオリジン トライアルでは、1 つのトライアルで Attribution Reporting、Protected Audience API、Topics、Fenced Frames、Shared Storage にまたがる統合テストを実行できます。デベロッパーは、Topics API、Protected Audience API、Attribution Reporting API を横断してテストできる、この単一のオリジン トライアルに登録できます。このガイドでは、API にアクセスするための構成手順、構成を検証する方法、API に対するテストに関するその他のリソースについて説明します。
送信元のトライアルのステータスを確認する
2023 年 6 月
Stable での Private Aggregation の 7% の段階的な導入
Private Aggregation API は、2023 年 6 月 6 日（火）より Chrome Stable トラフィックの 7% で利用可能になります。この API は、メインの統合オリジン トライアル グループ（5%）、Protected Audience 分離グループ（1%）、Shared Storage 分離グループ（1%）で利用できます。Protected Audience と Shared Storage のトラフィック割り当ては変更されません。これは、Private Aggregation が既存の分離されたテストに追加されるためです。
6 月 6 日（火）時点のトラフィック割り当て:
| API | トラフィックの割り当て | ステータス |
| アトリビューション レポート | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
| 分離 - 1% - ARA のみ | ||
| フェンス付きフレーム | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 7% |
| 分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンスド フレームのみ | ||
| 分離 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ | ||
| Protected Audience | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
| 分離 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ | ||
| Private Aggregation | 統合 - 5% | 2023 年 6 月 6 日時点での安定したトラフィックの 7% |
| 分離 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ | ||
| 分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンスド フレームのみ | ||
| 共有ストレージ | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
| 分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンスド フレームのみ | ||
| トピック | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
| 分離 - 1% - トピックのみ |
以前の更新情報
オリジン トライアルに関するこれまでの最新情報をご確認ください。
2023 年 4 月
Stable での Private Aggregation の 1% の段階的な導入
Private Aggregation API オリジン トライアルは、4 月 17 日（月）より、Chrome Stable 統合試験運用トラフィックの 1% で利用可能になります。Private Aggregation の sendHistogramReport() 関数は、Protected Audience API と Shared Storage ワークレットで使用できます。
4 月 17 日（月）より、トラフィックの割り当ては次のようになります。
| API | トラフィックの割り当て | ステータス |
| アトリビューション レポート | 統合 - 5% | 2023 年 3 月 13 日以降、Stable トラフィックの 6% |
| 分離 - 1% - ARA のみ | ||
| フェンス付きフレーム | 統合 - 5% | 2023 年 3 月 13 日より、Stable トラフィックの 7% |
| 分離 - 1% - 共有ストレージ（URL 選択）+ フェンスド フレームのみ | ||
| 分離 - 1% - Protected Audience API + フェンスド フレームのみ | ||
| Protected Audience API | 統合 - 5% | 2023 年 3 月 13 日以降、Stable トラフィックの 6% |
| 分離 - 1% - Protected Audience API + フェンスド フレームのみ | ||
| Private Aggregation | 統合 - 1% | 2023 年 4 月 17 日より、安定したトラフィックの 1% |
| 共有ストレージ（URL の選択） | 統合 - 5% | 2023 年 3 月 13 日以降、Stable トラフィックの 6% |
| 分離 - 1% - 共有ストレージ（URL 選択）+ フェンスド フレームのみ | ||
| トピック | 統合 - 5% | 2023 年 3 月 13 日以降、Stable トラフィックの 6% |
| 分離 - 1% - トピックのみ |
2023 年 3 月
タイムラインの更新
当初、分離されたテストは 2023 年 3 月 13 日（月）に開始するとお知らせしましたが、テストの設定にさらに時間が必要になったため、新しいテストは 2023 年 3 月 16 日（木）に開始されます。Protected Audience API の 1% の増加（4% から 5%）も、2023 年 3 月 16 日（木）に実施されます。
Protected Audience API の 1% の段階的な復元
先月、テストのため Protected Audience API オリジン トライアル トラフィックを Chrome Stable の 5% から 4% に一時的に減らしました。最初のテストは終了し、2023 年 3 月 16 日（木）に統合テストの Protected Audience API を 4% から 5% に引き上げる予定です。
増加するユーザーは、減少したユーザーと同じユーザーになります。ただし、以前のインタレスト グループは、段階的な廃止から 30 日以上が経過しているため、期限切れになっています。
分離されたテスト
テストプロセスを改善し、オリジン トライアル API の指標のモニタリングを継続するため、既存の統合テストに加えて、API ごとに個別のテストを作成しています。Attribution Reporting、Topics、Protected Audience API と Fenced Frames の組み合わせ、Shared Storage の URL 選択オペレーションと Fenced Frames の組み合わせについて、新しいテストが作成されます。各分離テストでは、そのグループのユーザーが利用できる API は、割り当てられた API のみです。
| API | 分離されたテスト トラフィックの割り当て |
|---|---|
| アトリビューション レポート | 1% |
| Protected Audience API + フェンスド フレーム | 1% |
| 共有ストレージ（URL の選択）+ フェンスド フレーム | 1% |
| トピック | 1% |
3 月 16 日（木）より、既存の統合テストから受信している 5% のトラフィックに上乗せして、上記の API に対して Chrome Stable トラフィックの 1% を追加で受信できるようになります。新規ユーザーは各テストに割り当てられます。
トラフィック割り当て
2 月 28 日（火）時点での統合送信元テストのトラフィック割り当ては次のとおりです。
| API | 現在の統合テスト のトラフィック割り当て |
|---|---|
| アトリビューション レポート | 5% |
| フェンス付きフレーム | 5% |
| Protected Audience API | 4% |
| 共有ストレージ（URL の選択） | 5% |
| トピック | 5% |
3 月 16 日（木）に Protected Audience API が再び段階的に拡大され、新しい分離テストが開始されると、トラフィックの割り当ては次のようになります。
| API | 新しいトラフィック割り当て | ステータス |
|---|---|---|
| アトリビューション レポート | 統合 - 5% | 2023 年 3 月 16 日より、Stable トラフィックの 6% |
| 分離 - 1% - ARA のみ | ||
| フェンス付きフレーム | 統合 - 5% | 2023 年 3 月 16 日より Stable トラフィックの 7% |
| 分離 - 1% - 共有ストレージ（URL 選択）+ フェンスド フレームのみ | ||
| 分離 - 1% - Protected Audience API + フェンスド フレームのみ | ||
| Protected Audience API | 統合 - 5%（現在の割り当て 4% + 1% の段階的な増加） | 2023 年 3 月 16 日より、Stable トラフィックの 6% |
| 分離 - 1% - Protected Audience API + フェンスド フレームのみ | ||
| 共有ストレージ （URL の選択） |
統合 - 5% | 2023 年 3 月 16 日より、Stable トラフィックの 6% |
| 分離 - 1% - 共有ストレージ（URL 選択）+ フェンスド フレームのみ | ||
| トピック | 統合 - 5% | 2023 年 3 月 16 日より、Stable トラフィックの 6% |
| 分離 - 1% - トピックのみ |
これらの変更は、既存のオリジン トライアル トークンの設定には影響しません。また、オリジン トライアル トークンを更新または新規生成する必要もありません。
2023 年 1 月
Chrome の回帰調査の一環として、2023 年 1 月 26 日より、Protected Audience API オリジン トライアル トラフィックを Chrome Stable の 5% から 4% に暫定的に減らします。調査には 1 か月ほどかかる見込みです。トラフィックが再開されましたら、お知らせいたします。
この変更は自動的に行われ、既存のオリジン トライアル トークンには影響しません。トラフィックの 1% を段階的に削減するユーザーについては、インタレスト グループはブラウザに残ります。同じユーザーが段階的な復元の対象となり、そのユーザーの興味 / 関心グループは再利用できます。ただし、インタレスト グループは 30 日で期限切れになり、回帰調査にそれ以上かかる場合があります。
また、Shared Storage の URL Selection API オリジン トライアルは、2023 年 1 月 26 日より Chrome Stable トラフィックの 5% に拡大されます。
| API | メモ |
|---|---|
| アトリビューション レポート | Stable で利用可能。2022 年 10 月 26 日より 5% に引き上げられました。 |
| トピック | Stable で利用可能。2022 年 10 月 26 日より 5% に引き上げられました。 |
| Protected Audience API | Stable で利用可能。2023 年 1 月 26 日より一時的に 4% に引き下げ。 |
| フェンス付きフレーム | Stable で利用可能。2022 年 11 月 9 日より 5% に引き上げ。 |
| 共有ストレージ | 安定版で利用可能。2023 年 1 月 26 日より 5% 増加。 |
2022 年 11 月
Shared Storage の「selectURL」API は、11 月 9 日より Chrome Stable トラフィックの 1% でオリジン トライアルに加わります。
プライバシー サンドボックスの関連性と測定に関するオリジン トライアルを 5% に拡大というブログ投稿でお知らせしたとおり、Attribution Reporting と Topics の参加率が 5% に引き上げられ、Protected Audience API と Fenced Frames も 11 月 9 日に 5% に引き上げられます。
| API | メモ |
|---|---|
| アトリビューション レポート | Stable で利用可能。10 月 26 日より 5% に引き上げられました。 |
| トピック | Stable で利用可能。10 月 26 日より 5% に引き上げられました。 |
| Protected Audience API | Stable で利用可能。11 月 9 日より 5% に引き上げ。 |
| フェンス付きフレーム | Stable で利用可能。11 月 9 日より 5% に引き上げ。 |
| 共有ストレージ | 安定版では、11 月 9 日から 1% のユーザーを対象にリリースされます。 |
2022 年 10 月: 5% の引き上げ
Attribution Reporting、Topics、Protected Audience API、Fenced Frames は現在、Chrome Stable で利用可能で、増加するトラフィックにも含まれます。
Attribution Reporting と Topics のトラフィック増加は、今週から開始されます。Protected Audience API と Fenced Frames のトラフィック増加は 11 月 9 日から開始されます。
詳しくは、プライバシー サンドボックスの関連性と測定のオリジン トライアルを 5%に拡大に関するブログ投稿をご覧ください。
| API | メモ |
|---|---|
| アトリビューション レポート | Stable で利用可能。10 月 26 日以降は 5% に増加。 |
| トピック | Stable で利用可能。10 月 26 日以降は 5% に増加。 |
| Protected Audience API | Stable で利用可能。11 月 9 日より 5% に引き上げ。 |
| フェンス付きフレーム | Stable で利用可能。11 月 9 日より 5% に引き上げ。 |
| 共有ストレージ | 現時点では、M105 以降の Canary、Dev、Beta でのみご利用いただけます。 |
2022 年 10 月
- オリジン トライアルは Chrome 110 まで延長されました。
- Chrome のオリジン トライアルの利用を開始するで、オリジン トライアルの登録を更新する方法について説明しています。これには、参加する送信元に新しいトークンを提供する手順が含まれます。これは、他の送信元のトライアルの延長でも同じ手順で行われます。
この延長は、既存の公開タイムラインに沿ってフィードバックを提供する一方で、Stable チャンネルのエコシステムが API の改善のテストと検証を継続するための時間を与えるために付与されました。
プライバシー サンドボックスのタイムライン全体は変更されません。
試用版に含まれる API:
| API | メモ |
|---|---|
| アトリビューション レポート | オリジン トライアルのデベロッパー ガイド。 |
| Protected Audience API | オリジン トライアルのデベロッパー ガイド。 |
| トピック | オリジン トライアルのデベロッパー ガイド。 |
| フェンス付きフレーム | オリジン トライアルの使用については、Protected Audience API のガイダンスをご覧ください。 |
| 共有ストレージ | 現時点では、M105 以降の Canary、Dev、Beta でのみご利用いただけます。 |
2022 年 8 月
- オリジン トライアルの提供範囲を、Chrome Stable 104 からパソコン ユーザーの 1% に拡大します。
- モバイル ユーザーが対象になった時点で、最新情報をお知らせします。
- 安定版前のチャンネル（Canary、Beta）は、ユーザーの 50% のままです。
- iOS Chrome では API を使用できません。
2022 年 5 月
オリジン トライアルの利用範囲を、Chrome 102 Beta のユーザーの 50% に拡大しました。
試用版に含まれる API:
| API | メモ |
|---|---|
| アトリビューション レポート | オリジン トライアルのデベロッパー ガイド。 |
| Protected Audience API | オリジン トライアルのデベロッパー ガイド。 |
| トピック | オリジン トライアルのデベロッパー ガイド。ブラウザの安定性に影響するバグが原因で、Topics はオリジン トライアルで短期間無効になりました。 |
| フェンス付きフレーム | フェンスド フレームがオリジン トライアルに追加されました。テストの使用については、Protected Audience API のガイダンスをご覧ください。 |
2022 年 4 月
オリジン トライアルは、Chrome 102 ベータ版の一部ユーザーを対象に開始されます。
試用版に含まれる API:
| API | メモ |
|---|---|
| アトリビューション レポート | 個別のテストの目的（I2E）投稿。アトリビューション レポートは、個々のオリジン トライアルとしてもご利用いただけます。 |
| Protected Audience API | 個別のテストの目的（I2E）投稿。Protected Audience API は、一部の機能のみがデスクトップで利用できます。 |
| トピック | 個別のテストの目的（I2E）投稿。 |
オリジン トライアルに登録して構成する
サイトでオリジン トライアルを有効にするには、割り当てられたオリジン トライアル トークン（オリジン トライアルへの特定のアクセス権を表す時間ベースの文字列）を登録して埋め込む必要があります。詳しくは、Chrome のオリジン トライアルの開始をご覧ください。
Origin トライアル トークンはすぐに付与され、いつでも取り消したり再作成したりできます。
オリジン トライアルを使用するページごとに、その特定のページの 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 > [Applications] パネルで確認できます。
- [フレーム] ペインまで下にスクロールします。
- トークンを設定するフレームを選択します。たとえば、トップレベル ページの上部フレームや、埋め込みページの特定の iframe などです。
- 右側のペインで、[オリジン トライアル] セクションまでスクロールします。
PrivacySandboxAdsAPIsの試用に関するエントリが表示されます。- このエントリを開くと、オリジン トライアルと特定のトークンのステータスを確認できます。
オリジン トライアルは一部のクリエイターのみを対象としており、お客様のブラウザがテストグループに含まれていない場合があります。その結果、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 の有効なテストグループに属している。
ユーザー設定
トライアルの対象となるには、以下の条件も満たしている必要があります。
- [設定] > [セキュリティとプライバシー] > [プライバシー サンドボックス] でプライバシー サンドボックス（試用版）を有効にしている（
chrome://settings/adPrivacyからもアクセス可能）。 - [設定] > [セキュリティとプライバシー] > [Cookie と他のサイトデータ] で、サードパーティ Cookie が有効になっている（[すべての Cookie を許可] または [シークレット モードでサードパーティ Cookie をブロック] に設定されている）（
chrome://settings/cookiesからもアクセス可能）。 - シークレット モードではなく、標準のブラウジング セッションであること。
オリジン トライアルは、対象となるユーザーにのみアクティブとして表示されます。デベロッパー フラグを使用して、独自の本番環境サイトでテストすることもできます。
オリジン トライアルへの参加を管理する
オリジン トライアルの仕組みは変わりません。API をテストするコンテキストのオリジン トライアル トークンを取得します。テスト対象ユーザーを拡大する場合は、トライアルを有効にする場所でトラフィックのレベルを積極的にモニタリングし、制御する必要があります。
おすすめの方法は次のとおりです。
- テストするすべてのコンテキストに、デフォルトで送信元のトライアル トークンを含めます。
- 機能検出を使用して、アクティブな API を確認します。
- API が有効になっている（つまり、ブラウザがこのテストの対象である）場合は、独自のテスト条件に基づいて API を使用するかどうかを選択します。たとえば、トラフィックの割合、サンプリング、その他の属性をテストするための A/B テスト インフラストラクチャがすでにある場合は、この時点でどの機能を積極的に使用するかを決定できます。
レスポンスにトークンを含めないことで、すべてのブラウザ インスタンスでオリジン トライアルへの参加を完全に防ぐことができます。たとえば、テストの独自の割り当てに達した場合や、トライアル中に問題に対処する必要がある場合は、トークンを含めないと、ページで試験運用版の機能が使用または有効になりません。
地域別のオリジン トライアルの制御
特定の地域でオリジン トライアルをオプトアウトすることはできません。送信元トライアルは、HTTP ヘッダー（サーバーサイド）または HTML メタタグ（クライアントサイド）を介してトークンが含まれているページで有効になります。
ユーザーの位置情報を特定できる場合は、その位置情報に基づいてオリジン トライアル トークンを含むコードを作成できます。たとえば、IP アドレスを使用してユーザーの位置を特定しようとすることがあります。IP アドレスはなりすましされる可能性があるため、これは保証されたソリューションではありません。
ただし、地域固有のオリジンでは、権限ポリシーを設定して、使用可能な機能を制御できます。たとえば、us.example.com と uk.example.com は、制御可能な地理固有のオリジンです。これは、リージョンがオリジン トライアルをオプトアウトしたことを意味するものではありません。
権限ポリシーを使用すると、サイトはブラウザに指示を出す短いコード スニペットをページに追加します。ページが読み込まれると、ブラウザは権限ポリシーの手順を読み取り、権限ポリシーに記載されているように機能（または API）を許可またはブロックします。サイトが特定のリージョンで API を制限する場合、デベロッパーはそのリージョンからリクエストされたすべてのページにポリシーを設定できます。
トークンを更新する
Origin のトライアル トークンは、発行日から 6 週間後に有効期限が切れます（トライアルの終了日が早い場合は、その日）。
オリジン トライアル機能を中断なく使用するには、その期間内に新しいトークンを更新してデプロイすることが重要です。
トークンの更新には数分しかかかりません。同じページ内で同じトライアル用に複数のトークンをデプロイできます。既存のトークンの有効期限が切れる前に更新したトークンをデプロイできるため、ユーザーのサービスが中断されることはありません。
ローカルでテストする
ローカル デベロッパー テストに関する具体的なガイダンスについては、以下をご覧ください。
API はデフォルトではオンになっていないため、テスト用にフラグで有効にする必要があります。上記と同じ構成設定が有効になっていることを確認してから、次の操作を行います。
- これらの機能が利用可能な Chrome のバージョンとチャンネルを使用します。
chrome://settings/adPrivacyで、すべての広告プライバシー API を有効にします。
特定の API と機能の可用性や、よりきめ細かい構成のための追加フラグについては、デベロッパー ガイドをご覧ください。