Google Campaign Manager Enhanced Conversions エクスポートインテグレーション

Google Campaign Manager 360（CM360）Enhanced Conversions コネクターを使用すると、Treasure AI から Google Campaign Manager 360 に直接コンバージョンデータをエクスポートできます。Campaign Manager 360 API を使用して、Floodlight アクティビティに紐付けられたコンバージョンレコードをアップロードまたは更新します。

• TD Toolbelt を含む Treasure AI の基本的な知識。
• Campaign Manager 360 へのアクセス権を持つ Google アカウント。
• コンバージョンをアップロードする権限を持つ Campaign Manager ユーザープロファイル ID。
• アップロードするコンバージョンアクションの Floodlight 設定 ID および Floodlight アクティビティ ID。

• 各コンバージョンレコードには最大 5 件の userIdentifiers エントリを含めることができます。この制限を超えるレコードは無効です。
• userIdentifiers の各エントリには、メール、電話番号、または住所情報のいずれか 1 つの識別子タイプのみを含める必要があります。同じ数値サフィックス内でタイプを混在させることは許可されておらず、スキーマ検証時に強制されます。
• 住所ベースの userIdentifiers では、同じ数値サフィックスに対して 7 つすべての住所フィールド（first_name、last_name、city、state、country_code、postal_code、street_address）が必要です。
• クエリスキーマには、コンバージョン識別子列が正確に 1 つ（または encrypted_user_id_candidates* 列のグループが 1 つ）含まれている必要があります。識別子グループがゼロまたは複数ある場合は、レコードが処理される前にスキーマ検証で拒否されます。
• 暗号化ユーザー ID（include_encrypted: true）を使用する場合は、encryption_entity_id を指定する必要があります。
• カスタム変数エントリには、同じサフィックスに対して custom_variable_type と custom_variable_value の両方が必要です。
• カートデータアイテムエントリには、同じサフィックスに対して 3 つすべてのアイテムフィールド（cart_data_item_id、cart_data_item_quantity、cart_data_item_unit_price）が必要です。

クエリを実行する前に、Treasure コンソールでデータ接続を作成して設定する必要があります。データ接続の一部として、インテグレーションへのアクセスに使用する認証情報を提供します。

1. Treasure コンソールを開きます。
2. Integrations Hub > Catalog に移動します。
3. Google Campaign Manager Enhanced Conversions を検索して選択します。認証を作成を選択します。

4. 認証に使用する認証情報を選択します。

5. 必要に応じて、Google でサインインを選択して Google にログインします。
6. Integrations Hub > Catalog に戻ります。
7. Google Campaign Manager Enhanced Conversions を検索して選択します。
8. 新しい認証ダイアログが開きます。
9. ドロップダウンリストからアカウント名が付いた OAuth 接続を選択します。
10. 続行を選択します。
11. 接続に名前を付けます。
12. 完了を選択します。

Treasure コンソールはデータをエクスポートするための複数の方法をサポートしています。Data Workbench からデータをエクスポートするには、以下の手順を実行します。

1. Data Workbench > Queries に移動します。
2. 新しいクエリを選択してクエリを定義します。
3. 結果のエクスポートを選択して、データエクスポートを設定します。
4. 既存の Google CM360 Enhanced Conversions 認証を選択するか、前述の手順で新しい認証を作成します。
5. エクスポートパラメーターを設定します。
6. 完了を選択します。

Campaign Manager にコンバージョンデータをアップロードするには、エクスポートクエリに必須列とオプション列の組み合わせを含める必要があります。列名は大文字と小文字を区別せず、空白はトリミングされます。NULL 値を持つ列はそのレコードに対してスキップされます。列が必須の場合、そのレコードは無効と見なされます。

*これらのフィールドのうち、レコードごとに NULL 以外の値を持つものは 1 つのみである必要があります。

これらの列は、各コンバージョンの userIdentifiers 配列を設定します。これは拡張ユーザーマッチングに使用されます。数値サフィックスを使用して複数の識別子を提供できます（例：email、email1、email2）。各サフィックスは関連するフィールドを 1 つの UserIdentifier エントリにグループ化します。レコードには最大 5 件の userIdentifiers エントリを含めることができます。

各 UserIdentifier エントリは以下のタイプのいずれかである必要があります：

メール

電話番号

住所情報（サフィックスごとに 7 つすべてのフィールドが必須）

カートデータはショッピングカート情報でコンバージョンレコードを強化します。カートデータ列が存在する場合、3 つのトップレベルカートデータフィールドが必須です。

トップレベルカートデータフィールド（カートデータが使用される場合に必須）

カートデータアイテムフィールド（複数アイテムには数値サフィックスを使用）

同じ数値サフィックスでグループ化された 3 つのアイテムフィールドのセットが 1 つのカートアイテムを表します。各サフィックスに対して 3 つのフィールドすべてが存在する必要があります。

カスタム変数を各コンバージョンにアタッチして、追加データを Floodlight に渡すことができます。

custom_variable_type と custom_variable_value の両方が各数値サフィックスに対して存在する必要があります。

SELECT
    floodlight_configuration_id,
    floodlight_activity_id,
    timestamp_micros,
    value,
    quantity,
    ordinal,
    gclid,
    email,
    phone_number1,
    first_name2,
    last_name2,
    city2,
    state2,
    country_code2,
    postal_code2,
    street_address2,
    ad_user_data_consent,
    merchant_id,
    merchant_feed_label,
    merchant_feed_language,
    cart_data_item_id1,
    cart_data_item_quantity1,
    cart_data_item_unit_price1,
    custom_variable_type1,
    custom_variable_value1
FROM conversions_tbl

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

1. Data Workbench > Queries に移動します

2. 新しいクエリを作成するか、既存のクエリを選択します。

3. Schedule の横にある None を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

次の名前付きエントリを使用できます:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. Audience Studio に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、Create Activation を選択します。
4. Details パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. Output Mapping パネルで activation 出力をカスタマイズします。

• Attribute Columns
  • Export All Columns を選択すると、変更を加えずにすべての列をエクスポートできます。
  • + Add Columns を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。+ Add Columns を選択し続けて、activation 出力用の新しい列を追加します。
• String Builder
  • + Add string を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    • String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    • Timestamp: エクスポートの日時。
    • Segment Id: segment ID 番号。
    • Segment Name: segment 名。
    • Audience Id: parent segment 番号。

6. Schedule を設定します。

• スケジュールを定義する値を選択し、オプションでメール通知を含めます。

7. Create を選択します。

TD Toolbelt を使用すると、CLI からクエリ結果のエクスポートをトリガーできます。td query コマンドの --result オプションを使用して、エクスポートジョブのパラメーターを指定する必要があります。詳細については、こちらの記事を参照してください。

オプションの形式は JSON であり、一般的な構造は以下のとおりです。

{
  "type": "google_cm360_enhanced_conversions",
  "td_authentication_id": "${authentication_id_from_td_console}",
  "profile_id": "123456789",
  "mode": "ADD",
  "include_encrypted": true,
  "encryption_entity_type": "ENCRYPTION_ENTITY_TYPE_UNKNOWN",
  "encryption_entity_id": "123",
  "encryption_source": "ENCRYPTION_SCOPE_UNKNOWN",
  "skip_invalid_records": true
}

ADD モード（新しいコンバージョンの挿入）

td query \
  --result '{"type":"google_cm360_enhanced_conversions","td_authentication_id": "xxxx","profile_id":"123456789","mode":"ADD","skip_invalid_records":true}' \
  -d my_database \
  "SELECT floodlight_configuration_id, floodlight_activity_id, timestamp_micros, value, quantity, ordinal, gclid FROM conversions" \
  -T presto

UPDATE モード

td query \
  --result '{"type":"google_cm360_enhanced_conversions","td_authentication_id": "xxxx","profile_id":"123456789","mode":"UPDATE","skip_invalid_records":true}' \
  -d my_database \
  "SELECT floodlight_configuration_id, floodlight_activity_id, timestamp_micros, value, quantity, ordinal, gclid FROM conversions" \
  -T presto