このページは Cloud Translation API によって翻訳されました。

機能の概要

集計サービスは、広告技術プロバイダが顧客とのキャンペーンの効果を高めるために必要なパフォーマンス分析情報を提供します。

このドキュメントでは、以下について説明します。

主な用語と概念
集計可能レポートの元データから詳細なコンバージョンデータとリーチ測定を取得する集計サービスの仕組み
集計可能レポートのバッチ処理のコンセプトの概要
Cloud コンポーネントのコンセプトの概要

このドキュメントの対象者

このページは、広告技術プロバイダとデベロッパーが、Google の API を使用してプライバシーを保護しながら効果的な広告測定を行う方法を理解するのに役立ちます。

このドキュメントは、Private Aggregation API、Attribution Reporting API、Protected Audience API、Shared Storage、Trusted Execution Environments に精通していることを前提としています。

主な用語と概念

先に進む前に、主な用語について理解しておいてください。

用語集

アドテック

広告プラットフォームとは、広告を配信するためのサービスを提供している企業です。

集計可能レポート

集計可能レポートは、個々のユーザーのデバイスから送信される暗号化されたレポートです。これらのレポートには、クロスサイトのユーザー行動とコンバージョンに関するデータが含まれます。コンバージョン（アトリビューショントリガーイベントと呼ばれることもあります）と関連する指標は、広告主または広告テクノロジーによって定義されます。各レポートは暗号化され、さまざまな関係者が基盤となるデータにアクセスできないようにしています。

詳しくは、集計可能なレポートについての記事をご覧ください。

集計可能レポートのアカウンティング

両方のコーディネーターにある分散レジャー。割り当てられたプライバシーバジェットを追跡し、「重複なし」ルールを適用します。これは、コーディネーター内に配置され、実行されるプライバシー保護メカニズムです。これにより、割り当てられたプライバシーバジェットを超えるレポートが集計サービスに渡されないようにします。

詳しくは、バッチ処理戦略と集計可能なレポートの関係をご覧ください。

集計可能レポートのアカウンティング予算

個々のレポートが複数回処理されないようにする予算への参照。

集計サービス

集計可能レポートを処理して概要レポートを作成する、広告テクノロジー運営のサービス。

集約サービスの背景については、説明と利用規約の全文リストをご覧ください。

宣誓

通常は暗号ハッシュまたは署名を使用して、ソフトウェアの ID を認証するメカニズム。集計サービスの提案では、構成証明は、広告テクノロジーが運用する集計サービスで実行されているコードとオープンソースコードを照合します。

構成証明の詳細

掛金の拠出

コーディネーター

鍵の管理と集計可能なレポートの処理を担当するエンティティ。コーディネーターは、承認済みの集計サービス構成のハッシュのリストを維持し、復号鍵へのアクセスを構成します。

ノイズとスケーリング

集計プロセス中に概要レポートに追加される統計ノイズ。プライバシーを保護し、最終レポートで匿名化された測定情報を提供できるようにします。

ラプラス分布から取得される加算ノイズメカニズムの詳細を確認する。

報告元

集計可能レポートを受信するエンティティ（つまり、Attribution Reporting API を呼び出したお客様または広告テクノロジー）。集計可能レポートは、ユーザーデバイスから、レポート送信元に関連付けられた既知の URL に送信されます。報告元は登録時に指定します。

共有 ID

shared_info、reporting_origin、destination_site（Attribution Reporting API のみ）、source_registration-time（Attribution Reporting API のみ）、scheduled_report_time、バージョンで構成される計算値。

shared_info フィールドで同じ属性を共有する複数のレポートには、同じ共有 ID を設定する必要があります。共有 ID は、集計可能レポートのアカウンティングで重要な役割を果たします。

詳しくは、信頼できるサーバーについての記事をご覧ください。

概要レポート

Attribution Reporting API と Private Aggregation API のレポートタイプ。サマリーレポートには、集計されたユーザーデータが含まれます。また、ノイズが追加された詳細なコンバージョンデータも含まれる場合があります。概要レポートは集計レポートで構成されます。イベントレベルレポートよりも柔軟性が高く、より豊富なデータモデルを提供します。特に、コンバージョン値などのユースケースではその効果が顕著です。

高信頼実行環境（TEE）

コンピュータのハードウェアとソフトウェアの安全な構成。これにより、外部の関係者は、漏洩を恐れずにマシンで実行されているソフトウェアの正確なバージョンを確認できます。これにより外部関係者は、ソフトウェアメーカーが主張している動作を、ソフトウェアが、それ以上でもそれ以下でもなく正確に実行していることを確認できます。

プライバシーサンドボックスの提案で使用される TEE について詳しくは、Protected Audience API サービスの説明と集計サービスの説明をご覧ください。

集計サービスのワークフロー

集計サービスは、集計可能な元のレポートから、コンバージョンとリーチの詳細なデータの概要レポートを生成します。レポート生成フローは次のステップで構成されます。

ブラウザが公開鍵を取得して暗号化されたレポートを生成します。
暗号化された集計可能レポートが広告テクノロジーサーバーに送信されます。
広告テクノロジーサーバーがレポートを（avro 形式で）バッチ化して、集計サービスに送信します。
集計ワーカーが集計レポートを取得して復号します。
集計ワーカーは、コーディネーターから復号鍵を取得します。
集計ワーカーは、集計とノイズ追加のためにレポートを復号します。
集計可能なレポートアカウンティングサービスは、指定された集計可能なレポートの概要レポートを生成するのに十分なプライバシーバジェットがあるかどうかを確認します。
集計サービスが最終的な概要レポートを送信します。

次の図は、ウェブデバイスとモバイルデバイスからレポートが受信されてから、集計サービスによって概要レポートが作成されるまでの集計サービスの動作を示しています。

エンドツーエンドの集計サービスフロー。 — エンドツーエンドの集計サービスフロー

まとめると、Attribution Reporting API または Private Aggregation API は、複数のブラウザインスタンスからレポートを生成します。Chrome は、コーディネータの鍵ホスティングサービスから公開鍵を取得します。この鍵は 7 日ごとにローテーションされ、レポートを暗号化してから広告テクノロジーのレポート作成元に送信します。広告テクノロジーのレポート作成元は、受信したレポートを収集して avro 形式に変換し、集計サービスに送信します。集計サービスにバッチリクエストが送信されると、集計サービスは Key Hosting Service から復号鍵を取得し、レポートを復号して集計し、ノイズを追加して概要レポートを作成します（作成するのに十分なプライバシーバジェットがある場合）。

集計可能なレポートを準備する方法については、実装セクションをご覧ください。

集計可能レポートのバッチ処理

レポートフローは、登録プロセスで指定した指定されたレポート送信元サーバーの助けなしでは完了しません。レポート作成元は、集計可能なレポートの収集、変換、バッチ処理を行い、Google Cloud または Amazon Web Services の集計サービスに送信する準備を行います。詳しくは、集計可能なレポートの準備方法をご覧ください。

クラウドコンポーネント

集約サービスは、複数のクラウドサービスコンポーネントで構成されています。提供されている Terraform スクリプトを使用して、必要なすべてのクラウドサービスコンポーネントをプロビジョニングして構成します。

フロントエンドサービス

マネージドクラウドサービス: Cloud Functions（Google Cloud）/ API Gateway（Amazon Web Services）

Frontend Service は、ジョブの作成とジョブ状態の取得のための Aggregation API 呼び出しのメインエントリポイントであるサーバーレスゲートウェイです。Aggregation Service ユーザーからのリクエストの受信、入力パラメータの検証、集計ジョブのスケジューリングプロセスの開始を行います。

Frontend Service には、次の 2 つの API があります。

エンドポイント	説明
`createJob`	この API は、集計サービスジョブをトリガーします。ジョブをトリガーするには、ジョブ ID、入力ストレージの詳細、出力ストレージの詳細、レポート送信元などの情報が必要です。
`getJob`	この API は、指定されたジョブ ID を持つジョブのステータスを返します。ジョブのステータス（「受信済み」、「処理中」、「完了」など）に関する情報を提供します。ジョブが完了すると、ジョブの実行中に発生したエラーメッセージなど、ジョブの結果も返されます。

Aggregation Service API のドキュメントを確認する。

ジョブキュー

マネージドクラウドサービス: Pub/Sub（Google Cloud）/ Amazon SQS（Amazon Web Services）

ジョブキューは、集計サービスのジョブリクエストを含むメッセージキューです。Frontend Service は、キューにジョブリクエストを挿入します。このリクエストは、Aggregation Worker によって消費され、処理されます。

クラウドストレージ

マネージドクラウドサービス: Google Cloud Storage（Google Cloud）/ Amazon S3（Amazon Web Services）

Aggregation Service で使用される入力ファイルと出力ファイル（暗号化されたレポートファイルや出力概要レポートなど）は、Cloud Storage に保存されます。

ジョブのメタデータデータベース

マネージドクラウドサービス: Spanner（Google Cloud）/ DynamoDB（Amazon Web Services）

ジョブメタデータデータベースは、集計ジョブのステータスの保存と追跡に使用されます。作成日時、リクエスト日時、更新日時、状態（受信済み、進行中、完了済みなど）などのメタデータが記録されます。集計ワーカーは、ジョブの進行に応じてジョブメタデータデータベースを更新します。

集計ワーカー

マネージドクラウドサービス: Confidential Space を使用した Compute Engine（Google Cloud）/ Nitro Enclave を使用した Amazon Web Services EC2（Amazon Web Services）。

集計ワーカーは、ジョブキューでジョブリクエストを処理し、コーディネータの鍵生成と配布サービス（KGDS）から取得した鍵を使用して暗号化された入力を復号します。ジョブ処理のレイテンシを最小限に抑えるために、集計ワーカーは復号キーを 8 時間キャッシュに保存し、処理するジョブ全体で使用します。

集計ワーカーは、高信頼実行環境（TEE）インスタンス内で動作します。ワーカーは一度に 1 つのジョブのみを処理します。自動スケーリング構成を設定することで、ジョブを並行して処理するように複数のワーカーを構成できます。自動スケーリングを使用する場合、自動スケーリングはジョブキュー内のメッセージ数に応じてワーカー数を動的に調整します。自動スケーリングのワーカーの最小数と最大数は、Terraform 環境ファイルで構成できます。自動スケーリングの詳細については、Amazon Web Services または Google Cloud の Terraform スクリプトをご覧ください。

集計ワーカーは、集計可能レポートのアカウンティングのために集計可能レポートアカウンティングサービスを呼び出します。このサービスは、プライバシーバジェットの上限を超えていない場合にのみジョブが実行されることを確認します。（「重複なし」ルールを参照）。予算が利用可能な場合は、ノイズの多い集計値を使用して概要レポートが生成されます。詳しくは、集計可能なレポートのアカウント設定をご覧ください。

集計ワーカーは、ジョブメタデータデータベースでジョブのメタデータを更新します。この情報には、ジョブの戻りコードと、レポートの一部が失敗した場合のレポートエラーカウンタが含まれます。ユーザーは、getJob ジョブ状態取得 API を使用して状態を取得できます。

Aggregation Service の詳細については、こちらの説明をご覧ください。

次のステップ

Aggregation Service の仕組みを理解したので、スタートガイドに沿って、Google Cloud または Amazon Web Services で独自のインスタンドをデプロイします。

機能の概要 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。