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

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

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

次の図は、Cortex Framework Data Foundation のマーケティング ワークロードで CM360 データを利用できるようにする方法を示しています。

CM360 データソース

図 1CM360 データソース。

構成ファイル

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 Cloud Composer で 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 のエンティティ関係図

図 2CM360: エンティティ リレーションシップ図。

ベースビュー

これらは ERD の青色のオブジェクトであり、CDC テーブルのビューで、一部の列名エイリアス以外の変換はありません。スクリプトは src/marketing/src/CM360/src/reporting/ddls にあります。

レポートビュー

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

DTv2 ファイル ストレージ

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

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

データの更新頻度と遅延

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

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

Cloud Composer 接続

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

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

Cloud Composer サービス アカウントの権限

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

取り込み設定

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

ソースから未加工テーブル

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

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

パラメータ 説明
base_table エンティティのデータ（「クリック」データなど）が保存されている未加工データセット内のテーブル。
load_frequency このエンティティの DAG が実行され、CDC テーブルにデータが入力される頻度。使用可能な値の詳細については、Airflow のドキュメントをご覧ください。
file_pattern エンティティに対応するベースファイル名パターン。
schema_file DTv2 フィールドを宛先テーブルの列名とデータ型にマッピングする src/table_schema ディレクトリ内のスキーマ ファイル。
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 省略可: パフォーマンスを考慮してこのテーブルをクラスタ化する場合は、詳細については、クラスタ設定をご覧ください。
レポート設定

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

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

次のステップ