クロスサイトのストレージに無制限の書き込みアクセスを許可し、プライバシーを保護した読み取りアクセスを許可します。
実装ステータス
このドキュメントでは、パーティション分割されていないクロスサイト ストレージの提案である Shared Storage API の概要を説明します。
- The Shared Storage API has now moved to general availability.
- A live demo is available, as is testing:
- URL selection output gate is available for local testing from Chrome M105+.
- Private Aggregation output gate is available for local testing from Chrome M107+.
- Measurement with the Private Aggregation API is now in general availability.
- Chrome platform status
| Proposal | Status |
|---|---|
Event-level reporting for Content Selection (selectURL()) |
Available until at least 2026 |
| Per-site budgeting Explainer |
Available in M119 |
| Allow writing from response headers Explainer GitHub Issue |
Available in M124. Can be manually enabled in M119-M123 |
| Private Aggregation contribution timeout Explainer |
Available in M119 |
| Debugging Shared Storage worklets with DevTools Section |
Available in M120 |
| Update Shared Storage data storage limit to 5MB Explainer |
Available in 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 ページには、すべてのページのアクティブな共有ストレージ ワークレットがすべて表示されます。
Engage and share feedback
The Shared Storage proposal is under active discussion and subject to change in the future. If you try this API and have feedback, we'd love to hear it.
- GitHub: Read the proposal, raise questions and participate in discussion.
- Shared Storage API announcements: Join or view past announcements on our mailing list
- Developer support: Ask questions and join discussions on the Privacy Sandbox Developer Support repo.