関連性と測定のための統合オリジン トライアル

プライバシー サンドボックスには、サイトをまたいだトラッキングを必要とせずに広告のユースケースを実現するための提案がいくつか含まれています。オリジン トライアルでは、デベロッパーが新しいウェブ テクノロジーを実際にテストして評価し、フィードバックを送信できます。プライバシー サンドボックスの関連性と測定のオリジン トライアルでは、サイトが 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%）で利用できます。Private Aggregation は既存の分離されたテストに追加されるため、Protected Audience と Shared Storage のトラフィック割り当ては変更されません。

6 月 6 日（火）時点のトラフィックの割り当て:

API トラフィックの割り当て ステータス
アトリビューション レポート 統合 - 5% 2023 年 3 月 13 日時点で Stable トラフィックの 6%
Isolated - 1% - ARA のみ
フェンス付きフレーム 統合 - 5% 2023 年 3 月 13 日時点で Stable トラフィックの 7%
分離 - 1% - Shared Storage + Private Aggregation + Fenced Frames のみ
分離型 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ
Protected Audience 統合 - 5% 2023 年 3 月 13 日時点で Stable トラフィックの 6%
分離 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ
プライベート アグリゲーション 統合 - 5% 2023 年 6 月 6 日時点で安定版トラフィックの 7%
分離 - 1% - Protected Audience + Private Aggregation + Fenced Frames のみ
分離 - 1% - Shared Storage + Private Aggregation + Fenced Frames のみ
共有ストレージ 統合 - 5% 2023 年 3 月 13 日時点で Stable トラフィックの 6%
分離 - 1% - Shared Storage + Private Aggregation + Fenced Frames のみ
トピック 統合 - 5% 2023 年 3 月 13 日時点で Stable トラフィックの 6%
分離 - 1% - トピックのみ

以前の更新情報

オリジン トライアルに関するこれまでの更新情報を確認する。

2023 年 4 月

Stable での Private Aggregation の 1% 増加

Private Aggregation API のオリジン トライアルは、4 月 17 日（月）より Chrome 安定版の統合試験運用トラフィックの 1% で利用可能になります。Private Aggregation の sendHistogramReport() 関数は、Protected Audience API と Shared Storage のワークレットで使用できます。

4 月 17 日（月）から、トラフィックの割り当ては次のようになります。

API トラフィックの割り当て ステータス
アトリビューション レポート 統合 - 5% 2023 年 3 月 13 日より、安定版トラフィックの 6%
分離 - 1% - ARA のみ
フェンス付きフレーム 統合 - 5% 2023 年 3 月 13 日より Stable トラフィックの 7%
分離 - 1% - 共有ストレージ（URL 選択）+ フェンス付きフレームのみ
分離 - 1% - Protected Audience API + Fenced Frames のみ
Protected Audience API 統合 - 5% 2023 年 3 月 13 日より、安定版トラフィックの 6%
分離 - 1% - Protected Audience API + Fenced Frames のみ
プライベート アグリゲーション 統合 - 1% 2023 年 4 月 17 日より、安定版トラフィックの 1%
共有ストレージ（URL 選択） 統合 - 5% 2023 年 3 月 13 日より、安定版トラフィックの 6%
分離 - 1% - 共有ストレージ（URL 選択）+ フェンス付きフレームのみ
トピック 統合 - 5% 2023 年 3 月 13 日より、安定版トラフィックの 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 安定版の 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 分離されたテスト
トラフィック割り当て
アトリビューション レポート 1%
Protected Audience API + Fenced Frames 1%
共有ストレージ（URL 選択）+ フェンス付きフレーム 1%
トピック 1%

3 月 16 日（木）より、上記の API について、既存の統合テストから受け取っている 5% のトラフィックに加えて、Chrome 安定版のトラフィックの 1% が追加で配信されるようになります。新規ユーザーは各テストに割り当てられます。

トラフィック割り当て

2 月 28 日火曜日の時点での現在の統合オリジン トライアルのトラフィック割り当ては次のとおりです。

API 現在の統合テストの
トラフィック割り当て
アトリビューション レポート 5%
フェンス付きフレーム 5%
Protected Audience API 4%
共有ストレージ（URL 選択） 5%
トピック 5%

Protected Audience API の段階的な導入が再開され、新しい分離テストが開始される 3 月 16 日（木）以降、トラフィックの割り当ては次のようになります。

API 新しいトラフィックの割り当て ステータス
アトリビューション レポート 統合 - 5% 2023 年 3 月 16 日より、安定版トラフィックの 6%
分離 - 1% - ARA のみ
フェンス付きフレーム 統合 - 5% 2023 年 3 月 16 日より Stable トラフィックの 7%
分離 - 1% - 共有ストレージ（URL 選択）+ フェンス付きフレームのみ
分離 - 1% - Protected Audience API + Fenced Frames のみ
Protected Audience API 統合 - 5%（現在の割り当て 4% + 1% のランプアップ） 2023 年 3 月 16 日より、安定版トラフィックの 6%
分離 - 1% - Protected Audience API + Fenced Frames のみ
共有ストレージ
（URL の選択） 		統合 - 5% 2023 年 3 月 16 日より、安定版トラフィックの 6%
分離 - 1% - 共有ストレージ（URL 選択）+ フェンス付きフレームのみ
トピック 統合 - 5% 2023 年 3 月 16 日より、安定版トラフィックの 6%
分離 - 1% - トピックのみ

これらの変更は、既存のオリジン トライアル トークンの設定には影響しません。オリジン トライアル トークンを更新したり、新しいオリジン トライアル トークンを生成したりする必要はありません。

2023 年 1 月

Chrome の回帰テストの一環として、2023 年 1 月 26 日より、Protected Audience API オリジン トライアルのトラフィックを Chrome Stable の 5% から 4% に一時的に減らします。調査には 1 か月ほどかかる見込みです。トラフィックが再び増加した時点で、お知らせいたします。

この変更は自動的に行われ、既存のオリジン トライアル トークンには影響しません。トラフィックの 1% のユーザーについては、インタレスト グループはブラウザに残ります。同じユーザーがランプアップの対象となり、インタレスト グループを再利用できます。ただし、インタレスト グループは 30 日で期限切れになるため、回帰調査にはそれ以上の時間がかかる可能性があります。

また、Shared Storage の URL 選択 API のオリジン トライアルは、2023 年 1 月 26 日より Chrome 安定版トラフィックの 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 メモ
アトリビューション レポート 安定版で利用可能。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 のトラフィックを増やし始めます。Protected Audience API と Fenced Frames は 11 月 9 日よりトラフィックを増やします。

詳しくは、プライバシー サンドボックスの関連性と測定のオリジン トライアルを 5%に拡大のブログ投稿をご覧ください。

API メモ
アトリビューション レポート Stable で利用可能。10 月 26 日以降は 5% に増加します。
トピック Stable で利用可能。10 月 26 日以降は 5% に増加します。
Protected Audience API 安定版で利用可能。11 月 9 日より 5% に増加します。
フェンス付きフレーム 安定版で利用可能。11 月 9 日より 5% に増加します。
共有ストレージ 現時点では、M105 以降の Canary、Dev、Beta でのみ利用可能です。

2022 年 10 月

  • オリジン トライアルは Chrome 110 まで延長されました。
  • Chrome のオリジン トライアルを使ってみるでは、オリジン トライアルの登録を更新する方法について説明しています。これには、参加しているオリジンに新しいトークンを提供することも含まれます。これは、他のオリジン トライアルの延長と同じプロセスです。

この延長は、エコシステムが安定版チャンネルで API の改善のテストと検証を継続し、既存の公開タイムラインと一貫性のあるフィードバックを提供するための時間を確保するために認められました。

プライバシー サンドボックスの全体的なタイムラインは変更されません。

トライアルに含まれる API:

API メモ
アトリビューション レポート オリジン トライアルのデベロッパー ガイド。
Protected Audience API オリジン トライアルのデベロッパー ガイド。
トピック オリジン トライアルのデベロッパー ガイド。
フェンス付きフレーム オリジン トライアルの使用については、Protected Audience API のガイダンスをご覧ください。
共有ストレージ 現時点では、M105 以降の Canary、Dev、Beta でのみ利用可能です。

2022 年 8 月

  • オリジン トライアルの利用対象は、Chrome Stable 104 からパソコン ユーザーの 1% に拡大されます。
  • モバイル ユーザーが対象に含まれる場合は、アップデートが実施されます。
  • Stable 以外のチャンネル（Canary、Beta）は、ユーザーの 50% のままです。
  • API は iOS 版 Chrome では使用できません。

2022 年 5 月

オリジン トライアルの利用可能範囲は、Chrome 102 ベータ版のユーザーの 50% まで拡大されます。

トライアルに含まれる API:

API メモ
アトリビューション レポート オリジン トライアルのデベロッパー ガイド。
Protected Audience API オリジン トライアルのデベロッパー ガイド。
トピック オリジン トライアルのデベロッパー ガイド。Topics は、ブラウザの安定性に影響するバグのため、オリジン トライアルで一時的に無効になりました。
フェンス付きフレーム オリジン トライアルに Fenced Frames を追加しました。試験運用については、Protected Audience API のガイダンスをご覧ください。

2022 年 4 月

オリジン トライアルは、Chrome 102 ベータ版のユーザーの一部を対象に開始されます。

トライアルに含まれる 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 > [アプリケーション] パネルで確認できます。

トークンのステータスが「成功」で、有効になっている。
トークンのステータスが成功で有効になっている。
  1. [フレーム] ペインまで下にスクロールします。
  2. トークンを設定するフレームを選択します。たとえば、トップレベル ページの top フレームや、埋め込みページの特定の iframe などです。
  3. 右側のペインで、[オリジン トライアル] セクションまでスクロールします。
  4. PrivacySandboxAdsAPIs のトライアルのエントリが表示されます。
  5. このエントリを開くと、オリジン トライアルのステータスと特定のトークンが表示されます。

オリジン トライアルは Chrome ユーザーの一部に限定されており、お使いのブラウザがテストグループに含まれていない可能性があります。その結果、PrivacySandboxAdsAPIs に対して赤い TrialNotAllowed メッセージが表示されることがあります。エントリを開いてトークンのステータスを確認したときに、緑色の Success メッセージが表示された場合は、オリジン トライアルの構成が正しいことを示しています。対象ユーザーには、Enabled に設定されたメッセージが表示されます。

トークンのステータスが [Success] で、有効になっていない。
トークンが成功ステータスで有効になっていない。

別のメッセージが表示された場合は、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 を試したいコンテキストのオリジン トライアル トークンを取得します。テスト対象ユーザーの拡大に伴い、トライアルを有効にするトラフィックのレベルを積極的にモニタリングし、制御する必要があります。

ここでは、次のようなアプローチが有効です。

  1. テストを行うすべてのコンテキストで、オリジン トライアル トークンをデフォルトで含めます。
  2. 機能検出を使用して、アクティブな API を確認します。
  3. API が有効になっている場合（つまり、ブラウザがこのテストの対象となる場合）、独自のテスト基準に基づいて、API を使用するかどうかを選択します。たとえば、トラフィックの割合、サンプリング、その他の属性でテストを行うための A/B テスト インフラストラクチャがすでに存在する場合は、この時点で積極的に使用する機能を決定できます。

レスポンスにトークンを含めないことで、任意のブラウザ インスタンスでオリジン トライアルへの参加を完全に防ぐことができます。たとえば、テストの割り当てを満たしている場合や、トライアル中に問題に対処する必要がある場合、トークンを含めないことで、ページでテスト機能が利用可能になったり有効になったりしないようにします。

地域別のオリジン トライアルの制御

特定のリージョンのオリジン トライアルをオプトアウトすることはできません。オリジン トライアルは、HTTP ヘッダー（サーバーサイド）または HTML メタタグ（クライアントサイド）を介して含まれるトークンを含むページで有効になります。

ユーザーの位置情報を特定できる場合は、その位置情報に基づいてオリジン トライアル トークンを含めるコードを記述できます。たとえば、IP アドレスを使用してユーザーの位置を特定しようとすることがあります。IP アドレスはスプーフィングされる可能性があるため、これは保証された解決策ではありません。

ただし、地域固有の配信元は、Permissions Policy を設定して、使用可能な機能を制御できます。たとえば、us.example.com と uk.example.com は、制御可能な地理固有のオリジンです。これは、リージョンがオリジン トライアルからオプトアウトしたことを意味するものではありません。

権限ポリシーを使用すると、サイトはページに短いコード スニペットを追加して、ブラウザに指示を提供できます。ページが読み込まれると、ブラウザは権限ポリシーの指示を読み取り、権限ポリシーで指定されたとおりに機能（または API）を許可またはブロックします。特定のリージョンで API を制限したい場合、デベロッパーは、そのリージョンからリクエストされたすべてのページに対してポリシーを設定できます。

トークンを更新する

オリジン トライアル トークンは、発行日から 6 週間後に有効期限が切れます（または、トライアルがそれより早く終了する場合は、トライアルの終了時に有効期限が切れます）。

オリジン トライアルの機能を中断なく使用するには、この期間内に新しいトークンを更新してデプロイすることが重要です。

トークンの更新には数分しかかかりません。同じページの同じトライアルに複数のトークンをデプロイできます。既存のトークンの有効期限が切れる前に更新されたトークンをデプロイできるため、ユーザーのサービスが中断されることはありません。

ローカルでテストする

ローカル デベロッパー テストに関する具体的なガイダンスについては、以下をご覧ください。

API はデフォルトでは有効になっていないため、テスト用にフラグで有効にする必要があります。上記の構成設定が有効になっていることを確認してから、次の操作を行います。

  • 機能が利用可能な Chrome のバージョンとチャンネルを使用します。
  • chrome://settings/adPrivacy で広告プライバシー API をすべて有効にします。

特定の API と機能の可用性、およびより詳細な構成のための追加のフラグについては、デベロッパー ガイドをご覧ください。