集計サービスは、未加工の集計可能レポートから、詳細なコンバージョン データとリーチ測定値のサマリー レポートを生成します。広告テクノロジーは、クライアントサイドで集計エントリ ポイントを 2 つ用意しており、Attribution Reporting API または Private Aggregation API を介して集計サービスにレポートを送信します。
実装ステータス
- 集計サービスが一般提供になりました。
- 集計サービスは、Attribution Reporting API と Protected Audience API および Shared Storage API の Private Aggregation API で使用できます。
対象
| 提案 | ステータス |
|---|---|
| Attribution Reporting API と Private Aggregation API でアグリゲーション サービスをアマゾン ウェブ サービス（AWS）でサポート
解説 |
利用可能 |
| Attribution Reporting API と Private Aggregation API での Google Cloud の Aggregation Service のサポート 説明 |
利用可能 |
| 集約サービスのサイト登録とマルチオリジン集約。サイトの登録には、クラウド アカウント（AWS または GCP）へのサイトのマッピングが含まれます。複数のオリジンを集約するには、オリジンが同じサイトのものである必要があります。
GitHub に関するよくある質問 サイト集計 API ドキュメント |
利用可能 |
| Aggregation Service のε 値は、さまざまなパラメータのテストとフィードバックを容易にするために、最大 64 の範囲で維持されます。
ARA イプシロンのフィードバックを送信する。 PAA イプシロン フィードバックを送信します。 |
利用できます。イプシロンの範囲の値が更新される前に、エコシステムに事前に通知します。 |
| 集計サービス クエリの貢献度フィルタリングをより柔軟に。
説明 |
利用可能 |
| 障害発生後の予算回復プロセス（エラー、構成ミスなど）
説明 |
利用可能 予算の復元を使用して広告テクノロジーによって復元された共有 ID の割合を確認し、2025 年上半期に予定されている過剰な復元については今後の復元を停止するメカニズム |
| AWS のコーディネーターの一人として活動している Accenture
デベロッパー ブログ |
利用可能 |
| Google Cloud のコーディネーターとして活動する独立した組織
デベロッパー ブログ |
利用可能 |
| Attribution Reporting API の集計デバッグ レポートに対する集計サービスのサポート
説明 |
利用可能 |
主な用語と概念
広告テクノロジー ワークフローで集計サービスの使用を検討している場合、次の用語とコンセプトを参考にして、この新しい集計フローをチームに提供してください。
| 用語 | 説明 |
|---|---|
| 集計サービス | 集計可能レポートを処理して概要レポートを作成する、広告テクノロジー運営のサービス。 |
| 集計可能レポート |
可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。 集計可能レポートの詳細 |
| 集計可能レポートのアカウンティング | 両方のコーディネータに配置された分散レジャー。割り当てられたプライバシー バジェットを追跡し、「重複なし」ルールを適用します。これは、コーディネーター内に配置され、そこで実行されるプライバシー保護メカニズムです。これにより、割り当てられたプライバシー バジェットを超えるレポートが集計サービスに渡されることがなくなります。 バッチ処理戦略が集計可能レポートとどのように関連しているかについては、こちらをご覧ください。 |
| 集計可能レポートのアカウンティング予算 | レポートが複数回処理されないようにするための予算の参照。 |
| 高信頼実行環境 (TEE) |
可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。 如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。 |
| コーディネーター |
コーディネーターは、鍵の管理と集計可能レポートの会計を担当するエンティティです。コーディネーターは、承認された集計サービス構成のハッシュのリストを保持し、復号鍵へのアクセスを構成します。 |
| 共有 ID |
次の要素で構成される計算値: shared_info、reporting_origin、destination_site（Attribution Reporting API でのみ利用可能）、source_registration-time（Attribution Reporting API でのみ利用可能）、scheduled_report_time、version。
つまり、複数のレポートで shared_info フィールドの同じ属性を共有している場合、それらのレポートは同じ共有 ID に属します。これは、集計可能レポートアカウンティングで重要な役割を果たします。
トラステッド サーバーの詳細 |
| 概要レポート |
サマリー レポートは、Attribution Reporting API と Private Aggregation API のレポート タイプです。概要レポートには、集計されたユーザーデータが含まれ、詳細なコンバージョン データが含まれる場合はノイズが追加されます。概要レポートは集計レポートで構成されています。概要レポートは、特にコンバージョン値などの一部のユースケースで、イベントレベル レポートよりも柔軟性が高く、豊富なデータモデルを使用できます。 |
| レポート元 |
レポート元は、集計可能レポートを受け取るエンティティです。つまり、広告テクノロジー 呼び出すことができます集計可能レポートは、ユーザーのデバイスから、レポート送信元に関連付けられた well-known URL に送信されます。報告元は登録時に指定する必要があります。 |
| 寄付金 | 集計可能レポートには、任意の数のカウンタ増分を含めることができます。たとえば、ユーザーが広告主のサイトで閲覧した商品の数をレポートに含めることができます。1 つのソースイベントに関連するすべての集計可能レポートの増分値の合計は、指定された上限「L1=2^16」を超えないようにする必要があります。 詳細については、集計可能レポートの説明をご覧ください。 |
| ノイズとスケーリング | 集計処理の一環として一定量の統計的ノイズが概要レポートに追加されます。このノイズは、プライバシーを保護し、最終的なレポートで匿名化された測定情報を提供するようにも機能します。ラプラス分布から取得される加算ノイズ メカニズムの詳細を確認する。 |
| 宣誓 |
構成証明は、ソフトウェア ID を認証するメカニズムであり、通常は暗号ハッシュまたは署名を使用します。集計サービスの提案では、構成証明は、広告テクノロジーが運営する集計サービスで実行されているコードとオープンソース コードを照合します。 構成証明の詳細を確認する。 |
集約サービスの背景情報について詳しくは、説明と利用規約の全文をご覧ください。
集計のユースケース
広告の測定と、それに対応する測定用のクライアント ライブラリについて、以下のデベロッパー ジャーニーについて考えてみましょう。
| ユースケース | エントリ ポイント | 説明 |
|---|---|---|
| 入札の最適化 | Attribution Reporting API （Chrome と Android） | 集計レポートを使用してコンバージョン シグナルを取り込んで、入札を最適化します。 |
| クロス プラットフォーム測定 | Attribution Reporting API （Chrome と Android） | ウェブとアプリをまたいだ測定機能を使用して、Chrome と Android をまたいだパフォーマンスを可視化します。 |
| コンバージョン レポート | Attribution Reporting API （Chrome と Android） | お客様のキャンペーンのニーズ（CTC と VTC を含む）に合わせてカスタマイズされた集計コンバージョン レポートを作成する。 |
| キャンペーンのリーチ測定 | Shared Storage API と Private Aggregation API (Chrome) | クロスサイト広告ビュー変数を使用して、キャンペーンのリーチを測定します。 |
| ユーザー属性レポート | Shared Storage API とPrivate Aggregation API（Chrome） | クロスサイト広告ビューとユーザー属性情報を使用して、ユーザー属性別のリーチを測定します。 |
| コンバージョン経路の分析 | Shared Storage API と Private Aggregation API (Chrome) | クロスサイト広告ビューとコンバージョン変数を保存して、コンバージョン経路の集計分析を行います。 |
| ブランド効果とコンバージョン リフト | Shared Storage API とPrivate Aggregation API（Chrome） | テストグループとコントロール グループに関するレポートとアンケート情報を使用して、ブランド効果と増分効果を測定します。 |
| オークションのデバッグ | Protected Audience API と Private Aggregation API（Chrome） | 集計レポートはデバッグに使用します。 |
| 入札単価の分布 | Protected Audience API と Private Aggregation API（Chrome）(Chrome) | 集計レポートを使用して、オークションの入札値の分布を把握する。 |
エンドツーエンドのフロー
次の図は、集計サービスの動作を示しています。ここでは、ウェブとモバイルからレポートを受け取ってから、集計サービスでの概要レポートを作成するまでのエンドツーエンドのフローに焦点を当てます。
- 公開鍵を取得して暗号化されたレポートを生成します。
- 広告テクノロジー サーバーに送信される、暗号化された集計可能レポート。収集、変換、一括処理が行われます。
- 広告テクノロジー サーバーがレポート（avro 形式）をバッチ処理し、デプロイ済みの集計サービスに送信します。（広告テクノロジーが完了する必要があります）。
- 集計レポートを取得して復号します。
- コーディネーターから復号鍵を取得します。
- 集計サービスは、集計とノイズ追加のためにレポートを復号します。
- 集計可能レポート アカウンティング サービスは、指定された集計可能レポートの概要レポートを生成するために残っているプライバシー バジェットがあるかどうかをチェックします。
- 最終概要レポートを提出する。
この図は、集計サービスと、主なクライアント測定 API（Attribution Reporting API、Private Aggregation API、コーディネーター）との全体的な関係を示しています。
このフローは、Attribution Reporting API や Private Aggregation API などのさまざまな Measurement API から始まり、複数のブラウザ インスタンスからレポートを生成します。Chrome は Coordinator の Key Hosting Service から公開鍵を取得して、レポートを暗号化してから、広告テクノロジーのレポート送信元に送信します。公開鍵は 7 日ごとにローテーションされます。
広告テクノロジーのレポート送信元がこれらのレポートを受信したら、レポートを収集して avro 形式に変換し、デプロイされた集計サービス インスタンスに送信するようにレポート送信元を構成する必要があります。バッチ処理戦略を確認する。
広告テクノロジーがバッチ処理の準備ができたら、集計サービスへのバッチ リクエストを作成します。ここで、Key Hosting Service から復号鍵を取得してレポートを復号し、集計してノイズを加えて概要レポートを作成します。これは、最終的な概要レポートを生成するのに十分なプライバシー バジェットがあるかどうかに左右されます。
レポートが収集される広告テクノロジー レポート送信元エンドポイントは、広告テクノロジーによってホストされ、集計サービスは広告テクノロジーのクラウドにデプロイされます。
集計可能レポートのバッチ処理
レポート フローは、指定されたレポート送信元サーバーのサポートなしでは完了しません。これは、広告テクノロジーが登録プロセスで送信したオリジンです。レポート送信元が担当する主なアクションは、受信した集計可能なレポートの収集、変換、バッチ処理、Google Cloud または Amazon Web Services にデプロイされた広告テクノロジーの集計サービスへの送信の準備です。詳しくは、集計可能レポートを準備する方法をご覧ください。
一般的なコンセプトを理解したところで、集約サービスにデプロイされるコンポーネントを詳しく見てみましょう。
Cloud コンポーネント
アグリゲーション サービスは、さまざまなクラウド サービス コンポーネントで構成されています。提供されている Terraform スクリプトによって、必要なすべてのクラウド サービス コンポーネントがプロビジョニングされ、構成されます。
フロントエンド サービス
マネージド クラウド サービス: Cloud Functions（Google Cloud）/ API Gateway（Amazon Web Services）
Frontend Service は、ジョブの作成とジョブ状態の取得のための Aggregation API 呼び出しのエントランス ポイントとして機能するサーバーレス ゲートウェイです。集計サービスのユーザーからリクエストを受信し、入力パラメータを検証して、集計ジョブ スケジューリング プロセスを開始します。
Frontend Service では、次の 2 つの API を使用できます。
| エンドポイント | 説明 |
|---|---|
createJob |
この API は、集計サービス ジョブをトリガーします。ジョブ ID、入力ストレージの詳細、出力ストレージの詳細、レポート送信元など、ジョブをトリガーする情報が必要です。 |
getJob |
この API は、指定されたジョブ ID のジョブのステータスを返します。ジョブのステータス（「受信済み」、「処理中」、「完了」など）に関する情報を提供します。また、ジョブが完了すると、ジョブの実行中に発生したエラー メッセージなど、ジョブの結果が表示されます。 |
Aggregation Service API のドキュメントを確認する。
ジョブキュー
マネージド クラウド サービス: Pub/Sub（Google Cloud）/ Amazon SQS（Amazon Web Services）
ジョブキューは、集約サービスのジョブ リクエストを格納するメッセージ キューです。フロントエンド サービスは、ジョブ リクエスト メッセージをキューに挿入します。このメッセージは、ジョブ リクエストを処理するために集計ワーカーによって使用されます。
クラウド ストレージ
マネージド クラウド サービス: Google Cloud Storage（Google Cloud）/ Amazon S3（Amazon Web Services）Cloud Storage は、Aggregation Service で使用される入出力ファイル（暗号化されたレポート ファイル、出力概要レポートなど）の保存に使用されます。
ジョブ メタデータ データベース
マネージド クラウド サービス: Spanner（Google Cloud）/ DynamoDB（Amazon Web Services）
ジョブ メタデータ データベースは、集計ジョブのステータスを保存し、追跡します。データベースには、作成日時、リクエスト日時、更新日時、状態（受信済み、処理中、終了など）などのメタデータが記録されます。集計ワーカー: ジョブの進行に合わせてジョブ メタデータ データベースを更新します。
集計ワーカー
マネージド クラウド サービス: Confidential Space（Google Cloud）を備えた Compute Engine / Nitro Enclave を備えた Amazon Web Services EC2（Amazon Web Services）
集約ワーカーは、ジョブキュー内のジョブ リクエストによって開始されたジョブ リクエストを処理し、コーディネーターの鍵生成および配布サービス（KGDS）から取得した鍵を使用して暗号化された入力を復号します。ジョブ処理のレイテンシを最小限に抑えるために、復号キーは Aggregation Worker に 8 時間キャッシュに保存され、そのワーカー インスタンスによって処理されるジョブで使用できます。
ワーカーは、高信頼実行環境（TEE）インスタンス内で動作します。各ワーカーは一度に 1 つのジョブのみを処理します。広告テクノロジーは、自動スケーリング構成を設定して、ジョブを並列処理するように複数のワーカーを構成できます。自動スケーリングにより、ジョブキューに残っているメッセージの数に応じてワーカー数が動的に調整されます。自動スケーリングのワーカーの最小数と最大数は、Terraform 環境ファイルで構成できます。自動スケーリングの詳細については、次の Terraform スクリプトをご覧ください。[アマゾン ウェブ サービス / Google Cloud]
集計ワーカーは、集計可能レポートのアカウンティングのために集計可能レポート アカウンティング サービスを呼び出します。集計可能レポート アカウンティング サービスでは、プライバシー バジェットの上限を超えていない限りジョブが実行されます。（「重複なし」ルールをご覧ください）。予算に余裕がある場合、ノイズの多い集計を使用して概要レポートが生成されます。詳しくは、集計可能レポートのアカウンティングをご覧ください。
集計ワーカーは、ジョブ メタデータ データベースのジョブメタデータを更新します。これには、適切なジョブ戻りコードや、レポートの一部が失敗した場合のエラー カウンタが含まれます。ユーザーは、ジョブ状態取得 API（getJob）を使用して状態を取得できます。
集計サービスの詳細については、説明をご覧ください。
次のステップ
アグリゲーション サービスの要点を学んだので、Google Cloud またはアマゾン ウェブ サービスを介して、独自のアグリゲーション サービス インスタンスをデプロイします。スタートガイド セクションをご覧ください。デプロイされたアグリゲーション サービスの運用方法について詳しくは、こちらで集約サービスの運用をご覧ください。
トラブルシューティング
エラー メッセージの詳細な説明、発生したエラーの原因、緩和するための次のステップについては、一般的なエラーコードと緩和策のドキュメントをご覧ください。
サポートの利用とフィードバックの提供
- 技術的な問題、プロダクトに関する質問、フィードバック、機能リクエストについては、GitHub リポジトリでイシューを作成してください。
- トラブルシューティングのために機密情報や専有情報を指定する必要がある場合は、aggregation-service-support@google.com までお問い合わせください。
- 既知の問題については、公開ステータス ダッシュボードをご覧ください。