YouTube との統合（ディスプレイ＆ビデオ 360）

このページでは、ディスプレイ＆ビデオ 360（DV360）を Cortex Framework Data Foundation のマーケティング ワークロードのデータソースとして使用して、YouTube からデータを取得するために必要な構成について説明します。

DV360 は、YouTube 広告を他のデジタル チャネルとともに管理するための Google の広告プラットフォームです。広告主は、マーケティング活動をより効率的に管理できます。

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

図 1. ディスプレイ＆ビデオ 360 データソース。

注: DV360 データソースの構成ファイル、分析ビュー、モデルにアクセスするには、データソース ディレクトリをご覧ください。

構成ファイル

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

   "marketing": {
        "deployDV360": true,
        "DV360": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_DV360"
            }
        }
   }

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

パラメータ	意味	デフォルト値	説明
marketing.deployDV360	DV360 をデプロイする	true	ディスプレイ＆ビデオ 360 のデータソースのデプロイを実行します。
marketing.DV360.deployCDC	ディスプレイ＆ビデオ 360 用の CDC スクリプトをデプロイする	true	Managed Service for Apache Airflow で DAG として実行する DV360 CDC 処理スクリプトを生成します。
marketing.DV360.datasets.cdc	ディスプレイ＆ビデオ 360 の CDC データセット	-	ディスプレイ＆ビデオ 360 の CDC データセット。
marketing.DV360.datasets.raw	ディスプレイ＆ビデオ 360 の元データセット	-	ディスプレイ＆ビデオ 360 の未加工データセット。
marketing.DV360.datasets.reporting	ディスプレイ＆ビデオ 360 のレポート用データセット	REPORTING_DV360	ディスプレイ＆ビデオ 360 のレポート用データセット。

データモデル

このセクションでは、エンティティ関連図（ERD）を使用して、YouTube（ディスプレイ＆ビデオ 360 を含む）データモデルについて説明します。

図 2. YouTube（ディスプレイ＆ビデオ 360 を使用）: エンティティ関連図。

レポートビュー

ERD の青いオブジェクトは、集計指標を含むレポートビューを表します。src/marketing/src/DV360/src/reporting/ddls のスクリプトをご覧ください。

ディスプレイ＆ビデオ 360 の元データの抽出を設定する

Cortex Framework は、インスタント レポート機能を使用してディスプレイ＆ビデオ 360 と統合されます。インスタント レポートは、DV360 の信頼性が高く低コストの標準機能です。この機能を使用すると、大規模で複雑なレポートを保存、スケジュール設定、ファイルやさまざまな場所にダウンロードできます。各レポートは、選択した頻度で、選択した期間のデータを含むエクスポート データテーブルを、同じ構成済みのテーブル名接頭辞を使用して BigQuery に定期的に作成します。

注: Google は、2024 年 7 月からすべてのオフライン レポートをインスタント レポートに移行します。BigQuery へのエクスポート機能は、両方のレポートタイプで同じように機能します。すべてのインスタント レポートの管理はお客様の責任となります。Cortex Framework は、その動作を構成または制御しません。

権限

インスタント レポートを使用してディスプレイ＆ビデオ 360 から生データを正常にエクスポートするには、次の権限を持つユーザーが必要です。

• DV360:
  • 選択したパートナーまたは広告主に対する標準権限。
• Google Cloud:
  • DV360 サービス アカウントに割り当てられた BigQuery User ロール。
  • DV360 サービス アカウントに割り当てられた BigQuery Data Editor ロール。

設定

DV360 からの未加工テーブルのエクスポートを設定する手順は次のとおりです。

1. [Link BigQuery Exporter Account]（BigQuery エクスポータ アカウントをリンク）の [Permission Details]（権限の詳細）セクションで、DV360 BigQuery エクスポータに必要なサービス アカウントを確認します。詳細については、図 2 をご覧ください。
   図 2. [BigQuery Exporter アカウントのリンク] でサービス アカウントを特定する
2. Google Cloud 権限を取得します。BigQuery Administrator ロールを持つユーザーが、前の手順で特定した DV360 サービス アカウントに BigQuery User ロールと BigQuery Data Editor ロールを付与する必要があります。
3. BigQuery を DV360 にリンクし、プロセスで使用する Raw データセットを指定します。オフライン レポート > BigQuery を有効にするの手順に沿って操作します。

4. インスタント レポートに移動し、次の表の各行に対して 1 つのレポートを作成します。列は表のとおりにします。src/DV360/config/table_schema の詳細な列スキーマ定義ファイルの詳細については、Raw から CDC へのテーブル スキーマのセクションをご覧ください。

   1. パートナーまたは広告主のフィルタを 1 つ以上追加します。これが、ステップ 3 の BigQuery リンクの権限と一致していることを確認します。
   注: 複数のパートナーまたは広告主をエクスポートする場合は、複数のレポートまたはエクスポートを設定する必要があることがあります。
   1. レポートのタイムゾーン設定として [広告主様のタイムゾーン] を選択します。詳細については、次のセクション その他の考慮事項をご覧ください。
   注: アカウントまたは BigQuery リンクに広告主へのアクセス権しかない場合、パートナー フィルタを含めることはできません。含めると、パートナー フィルタが削除されるまで、[BigQuery にエクスポート] オプションが無効になります。

   テーブルの接頭辞	含めるフィールド
   lineitem_details	日付 広告申込情報 ID 広告申込情報 キャンペーン ID キャンペーン 広告申込情報タイプ 広告申込情報の開始日 広告申込情報の終了日	インプレッション
   lineitem_insights	日付 広告申込情報 ID デバイスの種類 ブラウザ 環境 国 パートナー ID パートナー パートナーの通貨 広告主 ID 広告主 広告主の通貨 キャンペーン ID キャンペーン 広告掲載オーダー ID 広告掲載オーダー 広告申込情報 広告申込情報タイプ 広告申込情報の開始日 広告申込情報の終了日	インプレッション クリック数 収益（USD） エンゲージメント 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   adgroup_insights_by_age_gender	日付 YouTube 広告グループ ID 年齢（YouTube） 性別 広告申込情報 ID パートナー ID パートナー パートナーの通貨 AdvertiserID 広告主 広告主の通貨 広告掲載オーダー ID 広告掲載オーダー 広告申込情報 YouTube 広告グループ	収益（USD） インプレッション クリック数 エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   adgroup_insights_by_audience	日付 YouTube 広告グループ ID オーディエンス セグメント オーディエンス セグメント タイプ 広告申込情報 ID パートナー ID パートナー PartnerCurrency 広告主 ID 広告主 広告主の通貨 広告掲載オーダー ID 広告掲載オーダー 広告申込情報	インプレッション クリック数 YouTube 広告グループ 収益（USD） エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   adgroup_insights_by_adformat	日付 YouTube 広告グループ ID YouTube 広告フォーマット 広告申込情報 ID パートナー ID パートナー パートナーの通貨 広告主 ID 広告主 広告主の通貨 広告掲載オーダー ID 広告掲載オーダー 広告申込情報	インプレッション クリック数 YouTube 広告グループ 収益（USD） エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   adgroup_insights_by_placement	日付 YouTube 広告グループ ID プレースメント（すべての YouTube チャンネル） プレースメント名（すべての YouTube チャンネル） 広告申込情報 ID PartnerID パートナー パートナーの通貨 広告主 ID 広告主 広告主の通貨 広告掲載オーダー ID 広告掲載オーダー 広告申込情報	インプレッション YouTube 広告グループ 収益（USD） エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   adgroup_insights_by_adtype	日付 YouTube 広告グループ ID YouTube 広告タイプ 広告申込情報 ID パートナー ID パートナー パートナーの通貨 広告主 ID 広告主 広告主の通貨 広告掲載オーダー ID 広告掲載オーダー 広告申込情報	インプレッション クリック数 YouTube 広告グループ 収益（USD） エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数
   ad_insights	日付 YouTube 広告 ID 広告申込情報 ID パートナー ID パートナー パートナーの通貨 広告主 ID 広告主 AdvertiserCurrency 広告掲載オーダー ID 広告掲載オーダー 広告申込情報 YouTube 広告グループ ID YouTube 広告グループ YouTube 広告	インプレッション クリック数 収益（USD） エンゲージメント（YouTube） 収益（パートナーの通貨） 収益（広告主の通貨） TrueView: 視聴回数

5. スケジュールを設定し、過去のデータを入力します。ステップ 1 で構成した BigQuery リンクと、前の表に示されているとおりのテーブル プレフィックスを使用してください。詳細については、次のセクション その他の考慮事項をご覧ください。

6. • バックフィル実行を手動でトリガーするか、スケジュール設定されたエクスポートが開始されるまで待ちます。どちらの場合でも、データは BigQuery リンク用に構成された Raw データセットに自動的に保存されます。

その他の考慮事項

タイムゾーンの選択について:

• 一部のレポートタイプでは、エクスポートの設定時に日付のタイムゾーンとして広告主のタイムゾーンまたは UTC タイムゾーンを選択できます。ただし、YouTube 関連のレポートは広告主様のタイムゾーンのみをサポートしています。そのため、エクスポートを設定する際は、[広告主] のタイムゾーン設定を選択してください。

• レポートのエクスポートは日単位で事前集計されるため、Cortex Framework はタイムゾーン変換なしで提供された日付を直接使用します。報告されたタイムゾーン情報の解釈は、ユーザーの責任で行ってください。

過去のデータのスケジュール設定とバックフィルについて:

• エクスポートの期間として [過去 7 日間]、エクスポートの頻度として [毎日] を選択することをおすすめします。エクスポートの日付範囲とエクスポートの頻度を選択することは、データの精度とストレージ費用とのバランスを取るために必要です。ただし、どの設定でも CDC プロセスで機能します。

• BigQuery にエクスポートする場合、インスタント レポートでは最大 14 日間のデータのエクスポートがサポートされます。ただし、ディスプレイ＆ビデオ 360 では、レポート日の最大 31 日後まで、データに軽微な更新が加えられることがあります。複数の広告主様に対してエクスポートを設定した場合、各広告主様の日付はそれぞれのタイムゾーンで表示されます。

• 過去のデータが必要な場合は、スケジュール設定されていない 1 回限りのものとして、インスタント レポートで最大 2 年分のデータを BigQuery テーブルに直接エクスポートできます。この操作は、ディスプレイ＆ビデオ 360 の UI から手動で少なくとも 1 回は行う必要があります。

データの更新頻度と遅延

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

ディスプレイ＆ビデオ 360 のインスタント レポートでは、BigQuery エクスポートの設定時に設定したエクスポートの頻度（毎日、毎週、毎月など）によって、データの更新速度が異なります。

構成

このセクションでは、データ プロセスの構成について説明します。

Managed Service for Apache Airflow 接続

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

接続名	目的
dv360_cdc_bq	元データセット > CDC データセットの転送。
dv360_reporting_bq	CDC データセット > レポート データセットの転送。

未加工データから CDC テーブルへのスキーマ

ディレクトリ src/DV360/config/table_schema には、DV360 からエクスポートされたテーブルのセット（同じ接頭辞で識別される）ごとに 1 つのスキーマ ファイルが含まれます。各スキーマ ファイルには、ColumnName と ColumnDataType の 2 つの列が含まれています。

注: ユースケースでインスタント レポートのエクスポートに列を追加している場合は、対応するスキーマ ファイルにも追加してください。

取り込み設定

src/DV360/config/ingestion_settings.yaml ファイルには、ソースから CDC へのデータ パイプラインを制御する追加の設定が含まれています。

ソースから CDC テーブル

このセクションには、DV360 でエクスポートされたテーブルの取り込み方法と関連する CDC プロセスの動作を制御するエントリがあります。各エントリは、エクスポート プレフィックスで識別される 1 つのインスタント レポートに対応しています。

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

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

レポート設定

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

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

次のステップ

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