トピック、フェンス付きフレーム、共有ストレージ。 キーワード: product:PrivacySandbox、docType:Guide、topicAdSetup、contentTypeSolution、category:Web、apiGroupAds、audienceAdBuyer、audienceAdSeller、audienceAdMeasurementProvider、スキル:初心者
プライバシー サンドボックスには、広告での利用を可能にするためのさまざまな提案が含まれている ケースを簡単に特定できます。出発地 トライアルは、デベロッパーが 実際のテストを通じて新しいウェブ技術に関するフィードバックを提供できます。「 プライバシー サンドボックスの関連性と 測定のオリジン トライアル 1 回のトライアルで、複数のサイトで統一されたテストを実施 Attribution Reporting、Protected Audience API、Topics、Fenced Frames、Shared 。 デベロッパーはこの単一オリジン トライアルに登録して、 Topics、Protected Audience API、Attribution Reporting API に共通する情報です。この このガイドでは、API にアクセスするための構成手順について説明し、 構成の検証方法について学び、テストのための追加リソースを提供します。 公開されています。
オリジン トライアルのステータスを確認する
2023 年 6 月
Stable でのプライベート アグリゲーション 7% の立ち上げ
Private Aggregation API は 2023 年 6 月 6 日(火曜日)より、Chrome Stable のトラフィックの 7% でご利用いただけるようになります。API メインの統一オリジン トライアル グループ(5%)、Protected オーディエンス分離グループ(1%)、共有ストレージ分離グループ(1%)。「 Protected Audience と共有ストレージのトラフィック割り当ては変更されない 既存の分離テストにプライベート アグリゲーションが追加されるため。
6 月 6 日(火)時点でのトラフィックの割り当て:
API | トラフィックの割り当て | ステータス |
アトリビューション レポート | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
分離 - 1% - ARA のみ | ||
フェンス付きフレーム | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 7% |
分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンス付きフレームのみ | ||
分離 - 1% - Protected Audience + 非公開集計 + フェンス付きフレームのみ | ||
Protected Audience | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
分離 - 1% - Protected Audience + 非公開集計 + フェンス付きフレームのみ | ||
プライベート アグリゲーション | 統合 - 5% | 2023 年 6 月 6 日時点での Stable トラフィックの 7% |
分離 - 1% - Protected Audience + 非公開集計 + フェンス付きフレームのみ | ||
分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンス付きフレームのみ | ||
共有ストレージ | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
分離 - 1% - 共有ストレージ + プライベート アグリゲーション + フェンス付きフレームのみ | ||
トピック | 統合 - 5% | 2023 年 3 月 13 日時点での Stable トラフィックの 6% |
分離 - 1% - トピックのみ |
以前の更新情報
オリジン トライアルに関する以前の更新情報をご確認ください。
2023 年 4 月
Stable でのプライベート アグリゲーション 1% の立ち上げ
プライベート
Aggregation API オリジン トライアルは Chrome Stable の 1% で利用可能
4 月 17 日(月)の統一テスト トラフィックです。sendHistogramReport()
Private Aggregation の機能は、Protected Audience API で使用できます。
および共有ストレージ
ワークレット
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 + フェンス付きフレームのみ | ||
プライベート アグリゲーション | 統合 - 1% | 2023 年 4 月 17 日以降の Stable トラフィックの 1% |
共有ストレージ(URL の選択) | 統合 - 5% | 2023 年 3 月 13 日以降の Stable トラフィックの 6% |
分離 - 1% - 共有ストレージ(URL 選択)+ フェンス付きフレームのみ | ||
トピック | 統合 - 5% | 2023 年 3 月 13 日以降の Stable トラフィックの 6% |
分離 - 1% - トピックのみ |
2023 年 3 月
タイムラインの更新
当初は個別のテストを月曜日に開始するとお伝えしましたが 新しいテストは 2023 年 3 月 13 日(木)から 2023 年。これはテストの設定に時間がかかるためです。1% Protected Audience API の 4% から 5% へのバックアップは、木曜日にも実施されます。 2023 年 3 月 16 日
Protected Audience API を 1% 再開
先月、Google はテストのために、Chrome Stable の 5% から 4% に Protected Audience API のオリジン トライアルのトラフィックを一時的に減らしました。Protected Audience API のテストは終了し、2023 年 3 月 16 日(木)の統合テストで Protected Audience API を 4% から 5% まで再び拡大する予定です。
拡大されたユーザーは、縮小されたユーザーと同じグループになります。ただし、縮小から 30 日以上経過しているため、以前のインタレスト グループは有効期限が切れています。
分離されたテスト
テストプロセスを改善し、オリジン トライアル API の指標を引き続きモニタリングするために、既存の統合テストに加えて、API ごとに個別のテストを作成しています。新しいテストは、Attribution Reporting、Topics、Protected Audience API と Fenced Frames の組み合わせ、Shared Storage の URL Selection オペレーションと Fenced Frames の組み合わせに対して作成されます。個々の分離テストでは、そのグループのユーザーは割り当てられた API のみを使用できます。
API | 個別のテストのトラフィック 割り当て |
---|---|
アトリビューション レポート | 1% |
Protected Audience API + フェンス付きフレーム | 1% |
共有ストレージ(URL の選択)+ フェンス付きフレーム | 1% |
トピック | 1% |
3 月 16 日(木)より、 5% のトラフィックに加え、上記 API の Chrome Stable トラフィック 現在の統合テストで得られたテストです新規ユーザーが割り当てられます おすすめします
トラフィック割り当て
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 日であり、回帰調査にはそれより長くなる場合があります。
また、2023 年 1 月 26 日より、Shared Storage の URL Selection API オリジン トライアルを Chrome Stable トラフィックの 5% に引き上げます。
API | メモ |
---|---|
アトリビューション レポート | Stable 版で利用可能で、2022 年 10 月 26 日から 5% に引き上げられました。 |
トピック | Stable 版で利用可能で、2022 年 10 月 26 日から 5% に引き上げられました。 |
Protected Audience API | Stable 版でご利用いただけますが、2023 年 1 月 26 日から一時的に 4% に引き下げられます。 |
フェンス付きフレーム | 2022 年 11 月 9 日から 5% に引き上げられ、Stable 版で利用できます。 |
共有ストレージ | 2023 年 1 月 26 日から 5% 増加する Stable 版で利用できます。 |
2022 年 11 月
11 月 9 日より、Chrome Stable トラフィックの 1% で、共有ストレージの「selectURL」API がオリジン トライアルに追加されます。
ブログ投稿「プライバシー サンドボックスの関連性と測定のオリジン トライアルを 5%に引き上げ」で以前にお知らせしたとおり、11 月 9 日より、Attribution Reporting と Topics が Protected Audience API と Fenced Frames で 5% になりました。
API | メモ |
---|---|
アトリビューション レポート | Stable 版で利用可能で、10 月 26 日から 5% に引き上げられました。 |
トピック | Stable 版で利用可能で、10 月 26 日から 5% に引き上げられました。 |
Protected Audience API | 11 月 9 日から 5% に引き上げられ、Stable 版で利用できます。 |
フェンス付きフレーム | 11 月 9 日から 5% に引き上げられ、Stable 版で利用できます。 |
共有ストレージ | 11 月 9 日から Stable 版の 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 | 11 月 9 日から 5% に引き上げられ、Stable 版で利用できます。 |
フェンス付きフレーム | 11 月 9 日から 5% に引き上げられ、Stable 版で利用できます。 |
共有ストレージ | 現時点では、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% に拡大。
- モバイル ユーザーもご利用可能になり次第、お知らせいたします。
- Stable チャンネル(Canary、Beta)はユーザーの 50% のままです。
- API は iOS Chrome では使用できません。
2022 年 5 月
オリジン トライアルの提供対象を Chrome 102 ベータ版のユーザーの 50% に拡大。
トライアルに含まれる API:
API | メモ |
---|---|
アトリビューション レポート | 開発者 オリジン トライアルのガイドをご覧ください。 |
Protected Audience API | 開発者 オリジン トライアルのガイドをご覧ください。 |
トピック | オリジン トライアル。オリジン トライアルで Topics が一時的に無効になりました 。 |
フェンス付き フレーム | フェンス付きフレームをオリジン トライアルに追加。Protected Audience API のガイダンスを見る ご確認ください |
2022 年 4 月
オリジン トライアルは、Chrome 102 ベータ版の一部のユーザーを対象に開始されます。
トライアルに含まれる API:
API | メモ |
---|---|
アトリビューション レポート | 個々の意向 (テスト(I2E)の投稿)。Attribution Reporting は オリジントライアルは必要です |
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 のプロバイダ この場合、次の操作を行う必要があります。
- オリジンの登録時に [サードパーティ マッチング] オプションを選択する 無償ツールキットで
- [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 で確認できます。アプリケーション できます。
<ph type="x-smartling-placeholder">![トークンの成功ステータスと有効。](https://developers-dot-devsite-v2-prod.appspot.com/privacy-sandbox/assets/images/token-success-status.avif?authuser=19&hl=ja)
- [Frames] ペインまで下にスクロールします。
- トークンを設定するフレームを選択します。たとえば、top iframe(埋め込みページの場合)を指定します。
- 右側のペインで、[オリジン トライアル] セクションまで下にスクロールします。
PrivacySandboxAdsAPIs
トライアルのエントリが表示されます。- このエントリを展開すると、オリジン トライアルのステータスと、 使用します。
オリジン トライアルの対象は一部の Chrome ユーザーに限られ、ブラウザによっては
テストグループに含まれていません。その結果、赤色の TrialNotAllowed
が表示されることがあります。
PrivacySandboxAdsAPIs
に対してメッセージを送信しました。エントリを展開して
トークンのステータス。緑色の Success
メッセージが表示される場合は、オリジン トライアルです。
確認します。要件を満たすユーザーには、Enabled
に設定されたメッセージが表示されます。
![トークンの成功ステータスであり、有効になっていません。](https://developers-dot-devsite-v2-prod.appspot.com/privacy-sandbox/assets/images/token-success-status-not-enabled.avif?authuser=19&hl=ja)
異なるメッセージが表示された場合は、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 が有効である場合(つまり、ブラウザが対象である場合) 使用するかどうかを選択できます できます。たとえば、A/B テスト インフラストラクチャがすでにあり、 トラフィックの割合やサンプリング その他の属性に基づいてテストできます この段階で、積極的に使用する機能を決めます。
すべてのブラウザでオリジン トライアルへの参加を完全に禁止できます レスポンスにトークンを含めないでください。たとえば テストの割り当てに達したとき、またはテスト期間中に問題に対処する必要があった トークンを含めないことで、試験運用中の機能が ページ上で使用可能またはアクティブになります
地域別のオリジン トライアルの管理
特定の地域のオリジン トライアルを無効にすることはできません。オリジントライアルは 含まれるページで token が含まれます。 HTTP ヘッダー(サーバーサイド)または HTML メタタグ(クライアントサイド)で設定する。
ユーザーの現在地を特定できる場合は、以下に示すようにコードを記述することもできます。 オリジン トライアル トークン。たとえば、 IP アドレスを使用してユーザーの現在地を特定しようとすることがあります。IP アドレス なりすましの可能性があるため、確実な解決策ではありません。
ただし、地域固有のオリジンの場合は、権限
Policy を使用して、
あります。たとえば、us.example.com
と uk.example.com
は次のようになります。
配信元を設定できます。だからといって、
オリジン トライアルがオプトアウトされています。
権限ポリシーでは、サイトのページに簡単なコード スニペットを追加する ブラウザに指示を表示するものです。ページが読み込まれると、ブラウザは 権限ポリシーの手順を読み、機能(または API など)での使用を制限する必要があります。サイトが API を制限したい場合 ある地域では、リクエストするすべてのページにポリシーを設定できる 選択します
トークンを更新する
オリジン トライアル トークンの有効期限は、発行日から 6 週間(または トライアルを利用します)。
新しいインフラストラクチャを更新してデプロイすることは その時間枠内のトークンを オリジン トライアル機能を引き続きご利用いただけます。
トークンの更新は数分で完了します。また、複数のトークンを複数の 同じページ内で同じトライアルを使用できますトークンを更新する前に、更新したトークンを 既存のトークンは期限切れになるため、サービスの中断は発生しません。
ローカルでテストする
ローカル デベロッパー テストの具体的なガイダンスについては、以下をご覧ください。
API はデフォルトでは有効になっていないため、 「*」フラグ 説明します。同じ構成設定が有効になっていることを確認してください。 上記のステップの後に次を行います。
- 利用可能な Chrome のバージョンとチャンネルを使用します。
chrome://settings/adPrivacy
で、すべての広告プライバシー API を有効にします。
特定の API と機能の提供状況については、デベロッパー ガイドをご覧ください。 よりきめ細かい構成が必要な場合は、追加のフラグが必要です。