広告のオフライン コンバージョン DAG

概要

このページでは、tcrm_bq_to_ads_oc_v2 および tcrm_gcs_to_ads_oc_v2 の DAG の構成方法と、データの準備方法について説明します。

広告は、オンラインでの購入に直接つながらなくても、ユーザーの購入経路の起点となり、最終的に実店舗や電話といったオフラインでの購入につながることがあります。オフライン コンバージョンをインポートすると、広告のクリックや広告経由の電話問い合わせを経てオフラインで発生したコンバージョンを測定できます。

詳しくは、オフライン コンバージョンのインポートについてをご覧ください。

Airflow 変数を構成する

必要な新しい tcrm_bq_to_ads_oc_v2 DAG 変数を作成する

次のセクションでは、tcrm_bq_to_ads_oc_v2 DAG を実行するために必要な変数を示します。これらの変数は、BigQuery をデータソースとして使用する場合にのみ設定する必要があります。

変数名 値の例 変数情報
tcrm_bq_to_ads_oc_v2_bq_dataset_id my_dataset データを含む BigQuery データセットの名前。
tcrm_bq_to_ads_oc_v2_bq_table_id my_table データを含む BigQuery テーブルの名前。
tcrm_bq_to_ads_OC_v2_google_ads_yaml_credentials Google Ads API の認証情報については、Google Ads API の概要をご覧ください。

新しい必須 tcrm_gcs_to_ads_oc_v2 DAG 変数を作成する

次のセクションでは、tcrm_gcs_to_ads_oc_v2 DAG を実行するために必要な変数を示します。Google Cloud Storage をデータソースとして使用する場合にのみ、これらの変数を設定する必要があります。

変数名 値の例 変数情報
tcrm_gcs_to_ads_oc_v2_gcs_bucket_name my_bucket Cloud Storage バケット名。
tcrm_gcs_to_ads_oc_v2_gcs_bucket_prefix folder/sub_folder バケット内のデータフォルダへのパス。
tcrm_gcs_to_ads_oc_v2_gcs_content_type（任意） JSON または CSV のいずれか。 Cloud Storage のコンテンツ タイプ。
tcrm_gcs_to_ads_oc_v2_google_ads_yaml_credentials Google Ads API の認証情報については、Google Ads API の概要をご覧ください。

Google 広告のオフライン コンバージョンに送信するデータを準備する

データ フィールドの説明:

customerId は、アップロードを行う顧客の ID です。

conversionActionId は、このコンバージョンに関連付けられたコンバージョン アクションの ID です。特定のコンバージョンの URL で ID を確認できます。スクリーンショットをご覧ください。このページを表示します。上部のメニューで TOOLS AND SETTINGS をクリックし、ポップアップの MEASUREMENT の下にある Conversion をクリックします。オフライン クリック コンバージョンが送信される Conversion action をクリックします。

conversionDateTime は、yyyy-mm-dd hh:mm:ss+|-hh:mm のパターンである必要があります。

データを Google 広告に送信するには、次の 3 つの方法があります。

  1. BigQuery から SQL テーブル形式の tcrm_bq_to_ads_oc_v2 DAG を使用する。

    テーブル スキーマ:

    フィールド名 タイプ
    お客様 ID STRING
    conversionActionId STRING
    gclid STRING
    conversionValue STRING
    conversionDateTime STRING

    テーブルの例:

    お客様 ID conversionActionId gclid conversionValue conversionDateTime
    1234567890 123456789 gclick_id_1 0.1 2022-01-11 18:00:00+0900
    1234567890 123456789 g2_id_2 0.2 2022-01-12 18:00:00+0900
    1234567890 123456789 gclick_id_3 0.3 2022-01-13 18:00:00+0900
    1234567890 123456789 gclick_id_4 0.4 2022 年 1 月 14 日 18:00:00+0900

  2. Google Cloud Storage から（JSON 形式の tcrm_gcs_to_ads_oc_v2 DAG を使用）。

    {"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_1", "conversionValue":"0.1", "conversionDateTime": "2022-01-11 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_2", "conversionValue":"0.2", "conversionDateTime": "2022-01-12 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_3", "conversionValue":"0.3", "conversionDateTime": "2022-01-13 18:00:00+0900"}
{"customerId": "1234567890", "conversionActionId": "123456789", "gclid": "gclick_id_4", "conversionValue":"0.4", "conversionDateTime": "2022-01-14 18:00:00+0900"}

  3. Google Cloud Storage から、CSV 形式の tcrm_gcs_to_ads_oc_v2 DAG を使用。

    customerId,conversionActionId,googleClickId,conversionValue,conversionTime
1234567890,123456789,gclick_id_1,0.1,2022-01-11 18:00:00+0900
1234567890,123456789,gclick_id_2,0.2,2022-01-12 18:00:00+0900
1234567890,123456789,gclick_id_3,0.3,2022-01-13 18:00:00+0900
1234567890,123456789,gclick_id_4,0.4,2022-01-14 18:00:00+0900

DAG の実行

Airflow コンソールで、上部のメニューバーにある DAGs オプションをクリックします。左側のリストで、実行する DAG を見つけます。次に、リストの右側にある [Play] ボタンをクリックして実行します。

DAG のログの読み取り

よくある質問の DAG のログの読み取りをご覧ください。