キャンペーン マネージャー 360 との統合

このページでは、Cortex Framework Data Foundation のマーケティング ワークロードのデータソースとしてキャンペーン マネージャー 360 からデータを取得するために必要な構成について説明します。

キャンペーン マネージャー 360（CM360）は、広告主様と代理店向けに Google が提供するウェブベースの広告管理プラットフォームです。さまざまなチャネルで展開するすべてのデジタル広告キャンペーンを管理、最適化するための一元的なハブとして機能します。Cortex Framework は、CM360 データを分析し、他のマーケティング チャネルのデータと組み合わせて、AI を使用してより深い分析情報を取得し、マーケティング戦略全体を最適化するためのツールとプラットフォームを提供します。

次の図は、Cortex Framework Data Foundation のマーケティング ワークロードを通じて CM360 データを利用できる仕組みを示しています。

CM360 データソース

図 1. CM360 データソース。

構成ファイル

config.json ファイルは、さまざまなワークロードからデータを転送するためにデータソースに接続するために必要な設定を構成します。このファイルには、CM360 の次のパラメータが含まれています。

   "marketing": {
        "deployCM360": true,
        }

        "CM360": {
            "deployCDC": true,
            "dataTransferBucket": "",
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_CM360"
            }
        }

次の表に、各マーケティング パラメータの値を示します。

パラメータ 意味 デフォルト値 説明
marketing.deployCM360 CM360 をデプロイする true CM360 データソースのデプロイを実行します。
marketing.CM360.deployCDC CM360 用の CDC スクリプトをデプロイします。 true Managed Service for Apache Airflow で DAG として実行する CM360 CDC 処理スクリプトを生成します。
marketing.CM360.dataTransferBucket Data Transfer Service の結果を含むバケット - DTv2 ファイルが保存されるバケット。
marketing.CM360.datasets.cdc CM360 の CDC データセット CM360 の CDC データセット。
marketing.CM360.datasets.raw CM360 の元データセット CM360 の元データセット。
marketing.CM360.datasets.reporting CM360 のレポート用データセット "REPORTING_CM360" CM360 のレポート用データセット。

データモデル

このセクションでは、エンティティ関連図（ERD）を使用して CM360 データモデルについて説明します。

CM360 のエンティティ関係図

図 2. CM360: エンティティ関連図。

ベースビュー

これらは ERD の青いオブジェクトであり、一部の列名エイリアス以外の変換がない CDC テーブルのビューです。src/marketing/src/CM360/src/reporting/ddls のスクリプトをご覧ください。

レポートビュー

これらは ERD の緑色のオブジェクトであり、集計指標を含むレポートビューです。src/marketing/src/CM360/src/reporting/ddls のスクリプトをご覧ください。

DTv2 ファイルの保存

DTv2（データ転送バージョン 2）ファイルは、キャンペーンのパフォーマンス データを配信するためにキャンペーン マネージャー 360 で使用される特定の形式です。CM360 を Cortex Framework で使用するには、データ転送 V2.0 のドキュメントに沿ってデータ転送プロセスを設定します。

CM360 の DTv2 ファイルを保存するための Cloud Storage バケットを作成または追加します。バケット内のファイルが、Managed Airflow で DAG を実行するサービス アカウントで読み取り可能であることを確認します。詳細については、ストレージ バケットを作成するをご覧ください。

データの更新頻度と遅延

一般に、Cortex Framework データソースのデータの更新速度は、アップストリーム接続で許可されている内容と DAG 実行の頻度によって制限されます。上流の頻度、リソースの制約、ビジネスニーズに合わせて、DAG の実行頻度を調整します。

CM360 の Data Transfer v2 では、インプレッション数とクリック数のデータが 1 日 24 回（1 時間ごと）に配信されます。処理時間はファイルによって異なるため、ファイルが順不同で表示されることがあります。アクティビティ ファイルは毎日配信されます。

Managed Airflow 接続

マネージド Airflow で次の接続を作成します。詳細については、Airflow 接続の管理に関するドキュメントをご覧ください。

接続名 目的
cm360_raw_dataflow CM360 DTv2 ファイル > BigQuery Raw データセット
cm360_cdc_bq 元データセット > CDC データセットの転送
cm360_reporting_bq CDC データセット > レポート データセットの転送

Managed Service for Apache Airflow サービス アカウントの権限

Managed Airflow で使用されるサービス アカウント（cm360_raw_dataflow 接続で構成）に Dataflow 権限を付与します。Dataflow のドキュメントの手順をご覧ください。

取り込み設定

src/CM360/config/ingestion_settings.yaml ファイルの設定で Source to Raw と Raw to CDC のデータ パイプラインを制御します。このセクションでは、各データ パイプラインのパラメータについて説明します。

ソースから元テーブル

このセクションでは、DTv2 のどのファイルを処理するかを制御するエントリについて説明します。各エントリは、1 つのエンティティに関連付けられたファイルに対応しています。この構成に基づいて、Cortex Framework は Airflow DAG を作成し、Dataflow パイプラインを実行して DTv2 ファイルからデータを処理します。

次のパラメータは、各エントリの Source to Raw の設定を制御します。

パラメータ 説明
base_table エンティティのデータが保存されている Raw データセット内のテーブル（「クリック数」データなど）。
load_frequency このエンティティの DAG が CDC テーブルにデータを入力するために実行される頻度。取り得る値の詳細については、Airflow のドキュメントをご覧ください。
file_pattern エンティティに対応するベース ファイル名パターン。
schema_file src/table_schema ディレクトリ内のスキーマ ファイル。DTv2 フィールドを宛先テーブルの列名とデータ型にマッピングします。
partition_details 省略可: パフォーマンスを考慮してこのテーブルをパーティション分割する場合。詳細については、テーブル パーティションをご覧ください。
cluster_details 省略可: パフォーマンスを考慮してこのテーブルをクラスタ化する場合。詳細については、クラスタ設定をご覧ください。

元テーブルから CDC テーブル

このセクションには、未加工テーブルから CDC テーブルにデータを移動する方法を制御するエントリがあります。各エントリは、未加工のテーブルに対応しています（未加工のテーブルは、前述のように DTv2 エンティティに対応しています）。

次のパラメータは、各エントリの Raw to CDC の設定を制御します。

パラメータ 説明
base_table CDC 変換後の元データが保存される CDC データセット内のテーブル（例: customer）。
load_frequency このエンティティの DAG が CDC テーブルにデータを入力するために実行される頻度。取り得る値の詳細については、Airflow のドキュメントをご覧ください。
row_identifiers このテーブルの一意のレコードを形成する列のリスト（カンマ区切り）。
partition_details 省略可: パフォーマンスを考慮してこのテーブルをパーティション分割する場合。詳細については、テーブル パーティションをご覧ください。
cluster_details 省略可: パフォーマンスを考慮してこのテーブルをクラスタ化する場合。詳細については、クラスタの設定をご覧ください。
レポート設定

レポート設定ファイル（src/CM360/config/reporting_settings.yaml）を使用して、Cortex Framework が CM360 の最終レポート レイヤのデータを生成する方法を構成して制御できます。このファイルは、レポート レイヤの BigQuery オブジェクト（テーブル、ビュー、関数、ストアド プロシージャ）の生成方法を制御します。

詳しくは、レポート設定ファイルのカスタマイズをご覧ください。

次のステップ