クロスサイトのストレージに無制限の書き込みアクセスを許可し、プライバシーを保護した読み取りアクセスを許可します。
実装ステータス
このドキュメントでは、パーティション分割されていないクロスサイト ストレージの提案である Shared Storage API の概要を説明します。
- Shared Storage API が一般提供になりました。
- 以下のライブデモも利用できます。
- URL 選択出力ゲートは、Chrome M105 以降のローカルテストで使用できます。
- 非公開集計の出力ゲートは、Chrome M107 以降でローカルテストに利用できます。
- Private Aggregation API による測定の一般提供が開始されました。
- Chrome プラットフォームのステータス
| 提案 | ステータス |
|---|---|
コンテンツの選択（selectURL()）のイベントレベルのレポート |
少なくとも 2026 年まで利用可能 |
| サイトごとの予算設定 説明 |
M119 で利用可能 |
| レスポンス ヘッダーからの書き込みを許可する 説明 GitHub の問題 |
M124 で利用可能。M119 ～ M123 では手動で有効に可能 |
| プライベート アグリゲーションのコントリビューションのタイムアウト 説明 |
M119 で利用可能 |
| DevTools を使用した共有ストレージ ワークレットのデバッグ セクション |
M120 で利用可能 |
| 共有ストレージのデータ ストレージの上限を 5 MB に更新 説明 |
M124 で利用可能 |
この API が必要な理由
クロスサイト ユーザー トラッキングを防ぐため、ブラウザではすべての形式のストレージ（Cookie、localStorage、キャッシュなど）をパーティショニングしています。しかし、パーティション分割されていないストレージを利用する正当なユースケースも数多くありますが、これは新しいウェブ API の支援がなければ不可能です。たとえば、コンテンツ制作者は、クロスサイト識別子に依存せずに、さまざまなサイト間のリーチを測定したい場合があります。
Shared Storage API を使用すると、サイトはパーティション分割されていないクロスサイト データを保存してアクセスできます。漏洩を防ぐため、このデータは安全な環境で読み取る必要があります。
共有ストレージのデータは、次の 2 つの方法で使用できます。
- クロスサイト コンテンツの選択。
- Private Aggregation API を使用したクロスサイト データのノイズの多い集計
対象者
Shared Storage API を使用するメリットは、さまざまな種類の企業にあります。次に例を示します。
- 広告テクノロジーは、キャンペーンのリーチの測定、フリークエンシー キャップの設定、クリエイティブのローテーションなどを行っていましたが、現在はいずれもサードパーティ Cookie に依存しています。
- 決済機関は、ユーザーが既存の顧客かどうかを判断し、購入手続きを調整できます。
- Web セキュリティ企業は、疑わしい動作や危険な動作にフラグを立てるカスタム・ロジックを構築できます。
まだ対処されていないクロスサイト ストレージ ソリューションをお探しですか？ユースケースを共有します。
ユースケース
Shared Storage API は、サードパーティ Cookie のいくつかの既存の用途に代わるもので、多くのユースケースをサポートすることを目的としています。該当するものは次のとおりです。
| ユースケース | 説明 | 出力ゲート |
|---|---|---|
| 広告クリエイティブをローテーションで表示する | クリエイティブ ID、表示回数、ユーザー操作などのデータを保存して、さまざまなサイトでどのクリエイティブ ユーザーが閲覧したかを特定できます。これにより、ビューのバランスを取り、特定のコンテンツが過度に彩度の高い状態になるのを防ぎ、ユーザー エクスペリエンスの低下を防ぐことができます。 | URL の選択 |
| A/B テストの実施 | ユーザーをテストグループに割り当て、そのグループを共有ストレージに保存して、クロスサイトでアクセスすることができます。 | URL の選択 |
| 既知の顧客向けにユーザー エクスペリエンスをカスタマイズする | ユーザーの登録ステータスなどのユーザーの状態に基づいて、カスタム コンテンツと行動を促すフレーズを共有できます。 | URL の選択 |
| 不正使用対策 | 不正使用対策、不正防止、Web セキュリティを担当する組織は、多くの場合、自動 bot か、危害を及ぼそうとする実際の人間かを問わず、独自の手法を使用して悪意のあるユーザーを検出します。ここでは、URL 選択出力ゲートを使用してユーザーの信頼性評価をエンコードする方法や、プライベート アグリゲーション出力ゲートを使用して異常検出用のデータセットを構築する方法など、さまざまな戦略をテストできます。 | URL の選択、Private Aggregation API |
| ユニークリーチを測定する | コンテンツ制作者や広告主の多くは、自分のコンテンツを見たユニーク ユーザー数を知りたいと思っています。共有ストレージを使用すると、広告、埋め込み動画、パブリケーションをユーザーが初めて見たときにレポートを作成し、同じユーザーが別のサイトで重複してカウントされるのを防ぎ、おおよそのユニークリーチのノイズの多いレポートを作成できます。 | Private Aggregation API |
| ユーザー属性を測定する | コンテンツ制作者の多くは、視聴者のユーザー属性を把握したいと考えています。共有ストレージを使用すると、所有している状況（自社サイトなど）でユーザー属性データを記録し、集計レポートを使用して他の多くのサイト（埋め込みコンテンツなど）でレポートを作成できます。 | Private Aggregation API |
| K+ フリークエンシー リーチを測定する | 「有効フリークエンシー」と呼ばれることもあります。多くの場合、ユーザーが特定のコンテンツを認識または思い出すようになるまでの最小視聴回数が必要です（多くの場合、広告視聴のコンテキストで）。共有ストレージを使用すると、コンテンツを K 回以上表示したユニーク ユーザーのレポートを作成できます。 | Private Aggregation API |
この提案は、将来起こり得る多くのユースケースをサポートする汎用 API を作成することを意図しています。これにより さらなるテストや変更が可能になり ウェブのエコシステムとともに成長できます
共有ストレージの仕組み
共有ストレージを使用すると、ユーザー情報（ブラウザ履歴やその他の個人情報など）を埋め込みサイトと共有したり、独自のサーバーにデータを流出させたりすることなく、クロスサイト データに基づいて情報に基づいた意思決定を行うことができます。
localStorage や IndexingDB などの他の JavaScript ストレージ API と同様に、共有ストレージにいつでも書き込めます。他のストレージ API とは異なり、共有ストレージの値を読み取ることができるのは、共有ストレージ ワークレットと呼ばれる安全な環境のみです。
ワークレットは、ビジネス ロジックを追加する場所です。ワークレット内では、共有ストレージから値を読み取って処理できますが、正確な値をワークレットの呼び出し元に直接返すことはできません。ワークレットから有用な情報を抽出するために、一連の「ゲート」を利用できます。利用可能なゲートは 2 つありますが、今後さらに追加される可能性があります。
利用可能な Shared Storage API の出力ゲートは次のとおりです。
- クロスサイト URL の選択: ワークレット スクリプトを実行し、保存されているデータに基づいて指定されたリストから URL を選択し、そのコンテンツをフェンス付きフレームにレンダリングできます。
- Private Aggregation API によるノイズの多い集計: ワークレットを実行して、Private Aggregation API を介してクロスサイト データを送信し、概要レポートを返すことができます。
Shared Storage API を試す
テストには、URL 選択出力ゲートとプライベート集計出力ゲート用の Shared Storage API を使用できます。コンテンツの選択は Chrome Canary/Dev/Beta M105 以降でテストでき、Private Aggregation API は Chrome M107 以降の Canary および Dev でテストできます。API をテストするには、chrome://flags/#privacy-sandbox-ads-apis でプライバシー サンドボックス広告 API のテストフラグを有効にします。
デモを使用する
デモが用意されており、GitHub でコードを確認できます。
このデモは、広告主、広告テクノロジー、コンテンツ配信者、さまざまなパブリッシャーのサイト間で情報を保存するその他のサードパーティ サービスの観点から構築されています。このデモでは、各ユースケースについて、同じサードパーティのコードがパブリッシャー A とパブリッシャー B の両方のサイトで実行されます。パブリッシャーのページにアクセスして、クロスサイト コンテキストでデータがどのように共有されるかをご確認ください。
このデモには、コンテンツ選択とプライベート アグリゲーションのユースケースが含まれています。
コンテンツ選択のデモでは、広告クリエイティブをローテーションする、既知の顧客に合わせてエクスペリエンスをカスタマイズする、A/B テストを実施するユースケースが用意されています。
プライベート アグリゲーションのデモでは、ユニークリーチの測定と K+ フリークエンシーのリーチの測定をプレビューできます。ユーザー属性を測定する
DevTools を使用した共有ストレージ ワークレットのデバッグ
現在のページから開始された共有ストレージ ワークレットを調べるには、DevTools パネルの [Sources] タブにアクセスして、[Shared Storage Worklet / Script First Statement] イベント リスナー ブレークポイントを追加します。このブレークポイントは、起動時に最初のモジュール スクリプトの実行または一時的なワークレットを一時停止します。
また、chrome://inspect/#shared-storage-worklets ページには、すべてのページのアクティブな共有ストレージ ワークレットがすべて表示されます。
フィードバックを共有
共有ストレージの提案は現在検討中であり、将来変更される可能性があります。この API をお試しいただき、フィードバックがございましたら、ぜひお寄せください。
- GitHub: 提案を確認し、質問を投稿し、ディスカッションに参加する。
- Shared Storage API に関するお知らせ: メーリング リストに参加したり、過去のお知らせを確認したりできます。
- デベロッパー サポート: プライバシー サンドボックス デベロッパー サポート リポジトリで質問したり、ディスカッションに参加したりできます。