広告関連 API の統一オリジントライアル
アトリビューション レポート、Protected Audience API、Topics、Fenced Frames、および共有ストレージの統一実験を実行します。
By Anusmita Ray, Kevin K. Lee and Rowan Merewood
プライバシーサンドボックスには、クロスサイトトラッキングを必要とせずに広告のユースケースを有効にするための提案が含まれています。オリジントライアルは、開発者が実際のテストを通じて新しいウェブテクノロジーを評価し、フィードバックを提供する機会です。プライバシーサンドボックスの広告関連のオリジントライアルでは、サイトがアトリビューション レポート、Protected Audience API、Topics、Fenced Frames、および共有ストレージを統合した単一のトライアルで実験することが可能です。
開発者は、この単一のオリジントライアルに登録すると、Topics、Protected Audience API、および Attribution Reporting API をテストすることができます。このガイドでは、これらの API にアクセスするための構成手順と構成を検証する方法を説明し、API に対してテストするためのその他のリソースを提供しています。
トラフィックとは、このトライアルに含まれる Chrome ブラウザインスタンスの割合を指しており、個々のサイトに対して行われたリクエストの割合ではありません。
オリジントライアルのステータスを確認する
2023 年 6 月
プライベート集計: 安定版で 1% 増加
Private Aggregation API は、2023 年 6 月 6 日火曜日から 7% の Chrome 安定版トラフィックで利用可能になります。この API は、メインの統合オリジントライアルグループ(5%)、Protected Audience の隔離グループ(1%)、および共有ストレージの隔離グループ(1%)で利用可能になります。プライベート集計が既存の隔離実験に追加されるため、プライベート集計と共有ストレージのトラフィックの割り当てに変更はありません。
6 月 6 日火曜日現在のトラフィック割り当て:
API | トラフィックの割り当て | 状況 |
アトリビューション レポート | 統合 - 5% | 2023 年 3 月 13 日時点で 6% の安定版トラフィック |
隔離 - 1% - ARA のみ | ||
Fenced Frames | 統合 - 5% | 2023 年 3 月 13 日時点で 7% の安定版トラフィック |
隔離 - 1% - 共有ストレージ + プライベート集計 + Fenced Frames のみ | ||
隔離 - 1% - Protected Audience + プライベート集計 + Fenced Frames のみ | ||
Protected Audience | 統合 - 5% | 2023 年 3 月 13 日時点で 6% の安定版トラフィック |
隔離 - 1% - Protected Audience + プライベート集計 + Fenced Frames のみ | ||
プライベート集計 | 統合 - 5% | 2023 年 6 月 6 日時点で 7% の安定版トラフィック |
隔離 - 1% - Protected Audience + プライベート集計 + Fenced Frames のみ | ||
隔離 - 1% - 共有ストレージ + プライベート集計 + Fenced Frames のみ | ||
共有ストレージ | 統合 - 5% | 2023 年 3 月 13 日時点で 6% の安定版トラフィック |
隔離 - 1% - 共有ストレージ + プライベート集計 + Fenced Frames のみ | ||
Topics | 統合 - 5% | 2023 年 3 月 13 日時点で 6% の安定版トラフィック |
隔離 - 1% - ARA のみ |
これまでの更新内容オリジントライアルに関する過去の更新内容をご覧ください。
これまでの更新内容
オリジントライアルに関する過去の更新内容をご覧ください。
2023 年 4 月
プライベート集計: 安定版で 1% 増加
Private Aggregation API オリジントライアルは、4 月 17 日月曜日から Chrome 安定版統合実験トラフィックの 1% で利用可能になります。プライベート集計の sendHistogramReport()
関数は、Protected Audience API および共有ストレージワークレットで使用できます。
4 月 17 日月曜日から、トラフィックの割り当ては次のようになります。
API | トラフィックの割り当て | スターテス |
アトリビューション レポート | 統合 - 5% | 2023 年 3 月 13 日以降 6% の安定版トラフィック |
隔離 - 1% - ARA のみ | ||
Fenced Frames | 統合 - 5% | 2023 年 3 月 13 日以降 7% の安定版トラフィック |
隔離 - 1% - 共有ストレージ(URL Selection)+ Fenced Frames のみ | ||
隔離 - 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 Selection) | 統合 - 5% | 2023 年 3 月 13 日以降 6% の安定版トラフィック |
隔離 - 1% - 共有ストレージ(URL Selection)+ Fenced Frames のみ | ||
Topics | 統合 - 5% | 2023 年 3 月 13 日以降 6% の安定版トラフィック |
隔離 - 1% - ARA のみ |
2023 年 3 月
タイムラインの更新
当初、隔離実験を 2023 年 3 月 13 日月曜日に開始するとお伝えしていましたが、実験の準備に追加の時間が必要となったため、新しい実験は 2023 年 3 月 16 日木曜日に開始されることになりました。Protected Audience API が 4% から 5% に 1% 増加することについても、2023 年 3 月 16 日木曜日を予定しています。
Protected Audience API: 1% 増加
先月、Protected Audience API のオリジントライアルのトラフィックをテスト用に Chrome 安定版の 5% から 4% に一時的に削減しました。初期テストは終了し、2023 年 3 月 16 日木曜日の統合実験では、Protected Audience API を 4% から最大 5% に戻す予定です。
ランプアップユーザーは、ランプダウンユーザーのセットと同じになりますが、減少から 30 日以上が経過したため、以前のインタレストグループは期限切れとなっています。
隔離実験
テストプロセスを改善し、オリジントライアル API のメトリクスを継続的に観察するために、既存の統合実験に加えて、API ごとに隔離された実験を作成しています。新しい実験は、アトリビューション レポート、Topics、Protected Audience API と Fenced Frames のコンボ、および共有ストレージの URL Selection 操作と Fenced Frames のコンボに対して作成されます。それぞれの隔離実験では、割り当てられた API のみがそのグループのユーザーに利用可能になります。
API | 隔離実験の トラフィックの割り当て |
---|---|
アトリビューション レポート | 1% |
Protected Audience API + Fenced Frames | 1% |
共有ストレージ(URL Selection)+ Fenced Frames | 1% |
Topics | 1% |
3 月 16 日木曜日より、既存の統合実験から受信している 5% のトラフィックに加えて、上記の API の Chrome 安定版トラフィックの 1% が追加で受信され始めます。各実験には新しいユーザーが割り当てられます。
トラフィックの割り当て
2 月 28 日火曜日時点での、統合オリジントライアルのトラフィックの割り当ては次のとおりです。
API | 現在の統合実験の トラフィックの割り当て |
---|---|
アトリビューション レポート | 5% |
Fenced Frames | 5% |
Protected Audience API | 4% |
共有ストレージ(URL Selection) | 5% |
Topics | 5% |
Protected Audience API の割り当てが戻され、新しい隔離実験が開始された後、3 月 16 日木曜日からのトラフィックの割り当ては次のようになります。
API | 新しいトラフィックの割り当て | スターテス |
---|---|---|
アトリビューション レポート | 統合 - 5% | 2023 年 3 月 16 日以降 6% の安定版トラフィック |
隔離 - 1% - ARA のみ | ||
Fenced Frames | 統合 - 5% | 2023 年 3 月 16 日以降 7% の安定版トラフィック |
隔離 - 1% - 共有ストレージ(URL Selection)+ Fenced Frames のみ | ||
隔離 - 1% - Protected Audience API + Fenced Frames のみ | ||
Protected Audience API | 統合 - 5%(4% の現在の割り当て + 1% 増加) | 2023 年 3 月 16 日以降 6% の安定版トラフィック |
隔離 - 1% - Protected Audience API + Fenced Frames のみ | ||
共有ストレージ(URL Selection) | 統合 - 5% | 2023 年 3 月 16 日以降 6% の安定版トラフィック |
隔離 - 1% - 共有ストレージ(URL Selection)+ Fenced Frames のみ | ||
Topics | 統合 - 5% | 2023 年 3 月 16 日以降 6% の安定版トラフィック |
隔離 - 1% - ARA のみ |
これらの変更は、既存のオリジントライアルトークンの設定には影響しないため、新しいオリジントライアルトークンへの更新や生成は必要はありません。
2023 年 1 月
Chrome の回帰調査の一環として、2023 年 1 月 26 日から、Protected Audience API のオリジントライアルトラフィックを Chrome 安定版の 5% から 4% に一時的に削減します。調査には約 1 か月かかると予想しており、トラフィックが戻される際にお知らせします。
この変更は自動的に行われ、既存のオリジントライアルトークンには影響しません。トラフィックが 1% 減少するユーザーの場合、インタレストグループはブラウザに残ります。同じユーザーがバックアップの一部となるため、そのインタレストグループを再利用できます。ただし、インタレストグループの有効期限は 30 日です。回帰調査にはそれよりも時間がかかる可能性があります。
また、共有ストレージの URL Selection API オリジントライアルは、2023 年 1 月 26 日から Chrome 安定版トラフィックの 5% に増加される予定です。
API | 備考 |
---|---|
アトリビューション レポート | 安定版で提供中。2022 年 10 月 26 日から 5% に増加。 |
Topics | 安定版で提供中。2022 年 10 月 26 日から 5% に増加。 |
Protected Audience API | 安定版で提供中。2023 年 10 月 26 日から一時的に 5% に増加。 |
Fenced Frames | 安定版で提供中。2022 年 11 月 9 日から 5% に増加。 |
共有ストレージ | 安定版で提供中。2023 年 10 月 26 日から 5% に増加。 |
2022 年 11 月
共有ストレージの selectURL
API は、11 月 9 日から Chrome 安定版トラフィックの 1% でオリジントライアルに追加されます。以前に「プライバシー サンドボックスの広告関連のオリジントライアルを 5% に増加」というブログ記事で発表したように、アトリビューション レポートと Topics は現在 5% になり、11 月 9 日には Protected Audience API と Fenced Frames も 5% となります。
API | 備考 |
---|---|
アトリビューション レポート | 安定版で提供中。10 月 26 日から 5% に増加。 |
Topics | 安定版で提供中。10 月 26 日から 5% に増加。 |
Protected Audience API | 安定版で提供中。11 月 9 日から 5% に増加。 |
Fenced Frames | 安定版で提供中。11 月 9 日から 5% に増加。 |
共有ストレージ | 安定版で提供予定。11 月 9 日より 1% で提供開始。 |
2022 年 10 月: 5% 増加
アトリビューション レポート、Topics、Protected Audience API、Fenced Frames はすべて Chrome 安定版で現在利用可能であり、トラフィック増加の一部になります。アトリビューション レポートと Topics のトラフィック増加は今週から開始し、Protected Audience API と Fenced Frames の増加は 11 月 9 日開始予定です。詳しくは、プライバシーサンドボックスの広告関連のオリジントライアルの 5% 引き上げに関するブログ記事をご覧ください。
API | 備考 |
---|---|
アトリビューション レポート | 安定版で提供中。10 月 26 日から 5% に増加。 |
Topics | 安定版で提供中。10 月 26 日から 5% に増加。 |
Protected Audience API | 安定版で提供中。11 月 9 日から 5% に増加。 |
Fenced Frames | 安定版で提供中。11 月 9 日から 5% に増加。 |
共有ストレージ | 現在、M105+ Canary、Dev、およびベータ版でのみ提供中。 |
2022 年 10 月
- オリジントライアルの期間が Chrome 110 まで延長されました。Chrome のオリジントライアルを始めるでは、オリジントライアルの登録を更新する方法について説明されています。これには、参加しているオリジンへの新しいトークンの提供が含まれます。これは、他のオリジントライアルの延長と同じプロセスです。
この延長は、Stable チャンネルのエコシステムに API の改善のテストと検証を継続しながら、既存の公開タイムラインに合わせてフィードバックを提供する時間を提供することを目的としています。
プライバシーサンドボックスの全体的なタイムラインは変更されていません。
トライアルに含まれる API:
API | 備考 |
---|---|
アトリビューション レポート | オリジントライアル開発者ガイド。 |
Protected Audience API | オリジントライアル開発者ガイド。 |
Topics | オリジントライアル開発者ガイド。 |
Fenced Frames | オリジントライアルの使用方法については、Protected Audience API ガイドをご覧ください。 |
共有ストレージ | 現在、M105+ Canary、Dev、およびベータ版でのみ提供中。 |
2022 年 8 月
オリジントライアルは、Chrome 安定版 104 の最大 1% のデスクトップユーザーに提供されます。
- この提供にモバイルユーザーが追加されると、更新が行われます。
安定版前のチャンネル(Canary、ベータ)のユーザー数は 50% のままです。
これらの API は、iOS Chrome では使用できません。
2022 年 5 月
オリジントライアルは、Chrome 102 ベータ版の最大 50% のユーザーに提供されます。このトライアルには以下の API が含まれます。
API | 備考 |
---|---|
アトリビューション レポート | オリジントライアル開発者ガイド。 |
Protected Audience API | オリジントライアル開発者ガイド。 |
Topics | オリジントライアル開発者ガイド。ブラウザの安定性に影響を与えるバグがあったため、オリジントライアルで一時的に Topics が無効にされていました。 |
Fenced Frames | Fenced Frames がオリジントライアルに追加されました。実験の使用方法については、Protected Audience API ガイドをご覧ください。 |
2022 年 4 月
オリジントライアルは、Chrome 102 ベータ版の一部の限定ユーザーに提供が開始されます。このトライアルには以下の API が含まれます。
API | 備考 |
---|---|
アトリビューション レポート | 個別の Intent to Experiment(I2E)に関する記事。 アトリビューション レポートは専用のオリジントライアルとしても提供されます。 |
Protected Audience API | 個別の Intent to Experiment(I2E)に関する記事。Protected Audience API は機能サブセット限定でデスクトップで提供されます。 |
Topics | 個別の Intent to Experiment(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 を介してオリジントライアルの機能を使用する場合は、以下を行う必要があります。
- オリジントライアルに登録する際に、Third-party matching オプションを選択します。
- Web Origin フィールドは、スクリプトのオリジンである必要があります。
- スクリプトからトップレベルページ(あなた自身のコンテンツではなくファースト パーティのページ)に
<meta>
タグを挿入します。例えば以下のようにします。
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
オリジントライアルをデバッグする
オリジントライアルのステータスは、DevTools > アプリケーションパネルで確認できます。
- フレームペインまで下にスクロールします。
- トップレベルページの場合は top フレーム、埋め込みページの場合は特定の iframe など、トークンを設定するフレームを選択します。
- 右側のペインで、 Origin Trialsセクションまで下にスクロールします。
PrivacySandboxAdsAPIs
トライアルのエントリが表示されます。- このエントリを展開して、オリジントライアルと特定のトークンのステータスを確認します。
オリジントライアルはごく一部の Chrome ユーザーに限定して提供されており、お使いのブラウザが実験グループに含まれていない場合があります。その結果、PrivacySandboxAdsAPIs
に対して赤い TrialNotAllowed
メッセージが表示されることがあります。エントリを展開してトークンステータスを確認したときに緑色の Success
メッセージが表示されている場合は、オリジントライアルが正しく構成されています。対象ユーザーには、Enabled
に設定されたメッセージが表示されます。
異なるメッセージが表示される場合は、オリジントライアルの構成を検証するための詳細なチェックリストについて、Chrome のオリジントライアルのトラブルシューティングをご覧ください。
機能を検出する
ウェブのあらゆる機能と同様に、それらを使用する前に、ブラウザで使用可能であることが報告されていることを確認する必要があります。これを行うには、関連する API が適切な場所に存在するかどうかを確認します。
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// FLEDGE 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/privacySandbox
からもアクセスできます。 - [設定] > [セキュリティとプライバシー] > [Cookie とその他のサイト データ] でサードパーティ Cookie を有効にし、「すべての Cookie を許可する」または「シークレット モードでサードパーティの Cookie をブロックする」に設定すること。これは
chrome://settings/cookies
からもアクセスできます。 - シークレットモードではなく、標準のブラウジングセッションを使用すること。
オリジントライアルは資格のあるユーザーに対してのみアクティブとして表示されますが、開発者フラグを使用して、独自の本番サイトに対してテストすることもできます。
オリジントライアルへの参加を制御する
オリジントライアルの仕組みは変わりません。API を試したいコンテキストのオリジントライアルトークンを取得します。テスト人口が拡大したため、トライアルを有効にすることを選択したトラフィックのレベルを積極的に監視し、確実に制御することが必要です。
Chrome 安定版トラフィックの 5% が、あなた自身のトラフィックの 5% に直接対応するわけではありません。サイトやサービスが受け取るトラフィックの実際の割合は、訪問者の構成によって異なります。
ここでは以下のアプローチが推奨されます。
- 実験するすべてのコンテキストに、デフォルトでオリジントライアルトークンを含めます。
- 機能検出を使用して、アクティブな API を確認します。
- API がアクティブな場合(したがって、ブラウザがこの実験に適している場合)、独自の実験基準に基づいて使用するかどうかを選択します。たとえば、トラフィックの割合、サンプリング、またはその他の属性で実験するための A/B テスト インフラストラクチャが既に存在する場合は、この時点で積極的に使用する機能を決定できます。
レスポンスにトークンを含めないことで、どのブラウザインスタンスもオリジントライアルに参加しないようにすることができます。たとえば、実験の独自のクォータに達した場合、またはトライアル中に問題に対処する必要がある場合、トークンを含めないことで、実験的な機能がページで使用可能にならない、またはアクティブにならないことが保証されます。
地域別のオリジントライアルの管理
特定の地域のオリジントライアルをオプトアウトすることはできません。オリジントライアルは、HTTP ヘッダー(サーバー側)または HTML メタタグ(クライアント側)を介して含まれるトークンを含むページで有効です。
ユーザーの場所を特定できる場合は、その位置情報に基づいてオリジントライアルトークンを含めるコードを記述することが可能です。たとえば、IP アドレスを使用してユーザーの場所を特定しようとする場合がありますが、IP アドレスはスプーフィングされる可能性があるため、これは保証されたソリューションではありません。
ただし、地理固有のオリジンは、権限ポリシーを設定して、使用できる機能を制御できます。たとえば、us.example.com
と uk.example.com
は、制御可能な地理固有のオリジンです。これは、地域がオリジントライアルをオプトアウトしたことを意味するものではありません。
権限ポリシーを使用すると、サイトはブラウザに指示を与える小さなコードスニペットをページに追加します。ページが読み込まれると、ブラウザは権限ポリシーの指示を読み取り、権限ポリシーに記載されている機能(または API)を許可またはブロックします。サイトが特定の地域で API を制限する場合、開発者はその地域から要求されたすべてのページに対してポリシーを設定できます。
ユーザーは、現在地とは異なる地域からオリジンにアクセスすることを選択する場合があります。つまり、米国のユーザーが uk.example.com
にアクセスできる可能性があるということです。これらのユーザーには、英国のサイトではブロックされていた米国のサイトの機能が表示されます。
トークンを更新する
オリジントライアルトークンの有効期限は、発行日から 6 週間です(トライアルが終了した場合は、これより早く期限切れとなります)。
オリジントライアルの機能を中断なく使用するには、その期間内に新しいトークンを更新してデプロイすることが重要です。
トークンの更新には数分しかかからず、同じページ内で同じトライアルに複数のトークンをデプロイできます。既存のトークンの有効期限が切れる前に、更新されたトークンをデプロイできるため、ユーザーへのサービスが中断されることはありません。
10 月末にトークンを更新すると、12 月初旬までしか使えません。年末にかけてコードがフリーズする場合は、更新されたトークンをデプロイできるようにするか、その期間中はオリジントライアルへの参加を一時停止するように計画する必要があります。
ローカルでテストする
ローカル開発者テストに関する具体的なガイドについては、以下をご覧ください。
API はデフォルトではオンにならないため、テスト用のフラグで有効にする必要があります。上記と同じ構成設定が有効になっていることを確認してから、以下を行ってください。
- 機能を利用できる Chrome のバージョンとチャンネルを使用します。
chrome://flags/#privacy-sandbox-ads-apis
フラグを有効にします。- 追加のフラグはこれと競合する可能性があるため、問題が発生した場合は、このフラグのみを設定することを検討してください。
特定の API と機能の可用性と、より詳細な構成に使用する追加のフラグについては、開発者ガイドをご覧ください。