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

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

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

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

CM360 データソース

図 1 。CM360 データソース。

構成ファイル

The 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 データモデルについて説明します。

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

ベースビュー

これらは 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 を使用するには、 Data Transfer V2.0 のドキュメントに沿ってデータ転送プロセスを設定します。

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

データの鮮度と遅延

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

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

Managed Airflow 接続

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

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

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

Managed Airflow で使用されるサービスアカウント（cm360_raw_dataflow 接続で構成）に 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`	`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 オブジェクト（テーブル、ビュー、関数、ストアドプロシージャ）の生成方法を制御します。

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

次のステップ

他のデータソースとワークロードの詳細については、データソースとワークロードをご覧ください。
本番環境でのデプロイの手順の詳細については、 Cortex Framework Data Foundation のデプロイの前提条件をご覧ください。