Google Ads Remarketing Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

いくつかのGoogle Ads Integrationが利用可能です。この記事では、Google Ads Remarketing V2について説明します。

この記事では、Google Ads via Audience Partner API(旧AdWords via DDPとして知られていた)については説明しません。 この名前は、GoogleがGoogle AdWordsをGoogle Adsにリブランディングした後に変更されました。このIntegrationは、特定のタイプのAudience List(Customer list)でのみ機能します。App UserやWebsite Visitorsなどの他のRemarketing Listタイプは、このIntegrationではサポートされていません。

このIntegrationを活用することで、メールアドレスや電話番号などのユーザープロファイルをGoogle Ads Remarketingユーザーリストにエクスポートできます。TD SQLクエリジョブの結果を実行してCRMデータを一括アップロードし、Google Remarketingユーザーリストにデータを追加または削除できます。

userIdカラムのデータをエクスポートできます。また、既存のSegmentからユーザーを削除することもできます。

前提条件

• TD Toolbeltを含むTreasure Dataの基本的な知識。
• Google Adsアカウント。
• 自身のGoogle AdsアカウントへのTreasure Data Google OAuthアプリアクセスの承認。
  • Google AdsアカウントではStandardまたはAdminのアクセスレベルが必要です

制限事項

以下の制限事項は、Google Ads APIドキュメント「Remarketing and Audience Targeting」およびサポート記事に記載されています。

• 最低5000ユーザー。広告は、少なくとも5000人のユーザーがいるユーザーリストに配信されます。「Customer Match Limitations」セクションを参照してください。ドキュメントには次のように記載されています:「広告の配信を開始するには、リストに少なくとも5,000人のメンバーをアップロードしてください。」
• Google Accountメール。メールはGoogle Accountを使用して接続する必要があります。「Customer Match with email address, address, or user ID」セクションを参照してください。
• @gmail.com以外のアドレスは無視されます。Gmailでのターゲティングには、@gmail.comの形式のメールのみ使用できます。「Customer Match with email address, address, or user ID」セクションを参照してください。
• ユーザーリストの丸め処理。 Google Ads管理サイトでは、ユーザーリストの数は正確には表示されません:
  • ユーザー数が1000未満の場合、100の単位に丸められます。
  • それ以外の場合は、最上位2桁に丸められます。「Customer Match Limitations」セクションを参照してください。
• Google Display Networkのcustomer match。Customer matchは、Google Display Network内のサードパーティサイトでは利用できません。「Customer Match with email address, address, or user ID」セクションを参照してください。
• 48時間の遅延。 Googleがリストに新しいユーザーを追加するには、最大48時間かかります。https://support.google.com/google-ads/answer/7474263の「Note」セクションを参照してください。
• replaceモードを実行する場合、最大72時間かかる場合があります。Remove data from a Customer Match audience listを参照してください。

カラムの命名規則

出力結果は、事前定義されたカラム名を使用する必要があります。サポートされているカラム名は以下の通りです:

• mobile_id: IDFA(Identifier for Advertising)またはAAID(Google Advertising ID)モバイルデバイスID。例: AEBE52E7-03EE-455A-B3C4-E57283966239(フォーマットは: 8-4-4-4-12の16進数文字)
• email: メールアドレス
• phone_number: 電話番号
• user_id: 広告主が生成および割り当てたユーザーID。この機能を使用するには、ホワイトリストに登録されたGoogleアカウントが必要です。詳細については、Customer Match Policyを参照してください。

クエリ結果からサポートされているカラムが見つからない場合、エラーが発生します。カラムのエイリアスは大文字小文字を区別しません。例えば、emailまたはEMAILを使用できます。

カラム名がサポートされている値と一致しない場合は、クエリでエイリアスを使用する必要があります。例:

SELECT
  an_email_column AS email,
  another_phone_column AS phone_number
FROM
  your_table;

データの正規化とハッシュ化

Treasure Dataの結果出力は、Googleのフォーマットとプライバシーガイドラインに従うため、値を自動的に正規化およびハッシュ化します。サポートされているハッシュアルゴリズムはSHA-256のみです。

CRMデータは、受け入れられるために特定のフォーマットガイドラインに従う必要があります。不適切なフォーマットは、アップロードエラーまたはマッチしたレコード数の低下につながる可能性があります。

以下の変換動作が、正規化のための結果出力時にデータタイプに応じて適用されます。

• Mobile Advertising ID: 正規化なし。
• Email:
  • データがプレーンテキストの場合、先頭と末尾の空白をトリムし、すべての文字を小文字に変換してから、送信前にハッシュ化します
  • データが既にハッシュ化されている場合、変換は適用されません
• Phone Number: E.164フォーマットを使用します。例: +1234567890
  • データがプレーンテキストの場合、値をハッシュ化します
  • データが既にハッシュ化されている場合、変換は適用されません
• User ID: 正規化なし。

Google Adsポリシー

Treasure Dataは、特に以下のGoogle Adsポリシーの遵守を推奨しています:

• Google Ads Policy for Personalized Advertising
• Google Ads カスタマーマッチポリシー: ファーストパーティコンテキストで収集した顧客情報のみをアップロードする

TD Console を使用する

新しい接続を作成する

Treasure Data では、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

1. TD Console を開きます。

2. Integrations Hub > Catalog に移動します。

3. Google Ads V2 を検索して選択します。

4. Create Authentication を選択します。

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

オプションで、Click here を選択して Google にログインします。

6. Integrations Hub > Catalog に戻ります。

7. Google Ads を検索して選択します。

8. New Authentication を選択します。

9. OAuth 接続フィールドの定義を確認します。

10. Continue を選択します。

接続の名前を入力します。

Done を選択します。

クエリを定義する

出力結果は、事前定義されたカラム名を使用する必要があります。

user_id を Google にアップロードするには、user_id カラムをクエリする必要があります。

Treasure Data の結果出力は、Google のフォーマットとプライバシーガイドラインに従うために、値を自動的に正規化してハッシュ化します。サポートされているハッシュアルゴリズムは SHA-256 のみです。

Google Ads Remarketing V2 の統合パラメータ

クエリの例

TD Console の Queries ページから、Google Ads 接続への出力結果を指定して、次のようなクエリを実行します。このクエリは例です。

SELECT email, phone_number FROM (
  VALUES ('demo1@example.com', '+1234567890'),
         ('demo2@example.com', '+9876543210'),
         ('demo3@example.com', '+9988776655')
)  tbl (email, phone_number)

クエリではソーステーブルを指定する必要はありませんが、データベースを選択する必要があります。

SELECT email FROM app_users

クエリには次のものを含めることができます:

• mobile_idのみ
• emailおよび/またはphone_numberのみ
• user_idのみ
• その他のすべてのカラムは無視されます

クエリは数秒で完了するはずです。

オプション: クエリ結果を検証する

オーディエンスリストを検証して、新しく入力されたデータを表示します:

(オプション) Query Export ジョブをスケジュールする

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

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

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

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

TD Console を使用してジョブをスケジュールする

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	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- 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 を有効にすることで、クエリの開始時刻を遅延させることができます。

トラブルシューティング

Q: 1日または2日間「Populating」のステータスが続いた後、ユーザーリストのステータスが「Error with the last upload」に変わります。なぜですか?

• テスト中に、同時に複数のリストをアップロードすると、Google APIにこの問題が発生するようです。問題を引き起こす可能性のあるユーザーリストの数は不明ですが、一度にアップロードするユーザーリストは3〜5個に制限する必要があります。

Q: ユーザーリストのサイズの値が変わり続けるのはなぜですか?

• 観察によると、各ネットワークのサイズは、アクティブユーザーの数に基づいて毎日変わる可能性があります:

Q: リストのステータスが「Populating...」になるのはなぜですか?

• リストにメンバーが入力されるまでに6〜12時間かかります。そのため、12時間ごとに1回以上の頻度でオーディエンスリストにアップロードすると、Ads UIで「Populating...」ステータスが表示される可能性があります。ほとんどの場合、リストが確定するまでに最大48時間かかることがあります。

Q: 十分な権限を持つユーザーを設定したにもかかわらず、「Caused by: io.grpc.StatusRuntimeException: PERMISSION_DENIED: Request had insufficient authentication scopes.」エラーが発生しました。なぜですか?

• 設定したユーザーがMCCアカウントである可能性があります。MCCアカウントは管理用であり、エクスポートジョブを完了するための十分な権限を持っていないため、Googleアカウントを使用する必要があります。

オプション: ワークフローでエクスポート結果を設定する

Treasure Workflow内で、データコネクタを使用してデータをエクスポートするように指定できます。

詳細はUsing Workflows to Export Data with the TD Toolbeltをご覧ください。

ワークフローの例 - UserListにuser_idを追加する

_export:
  td:
    database: google_ads_v2_db

+google_ads_v2_export_task:
  td>: append_user_id.sql
  database: ${td.database}
  result_connection: new_created_google_ads_v2_auth
  result_settings:
    type: google_adwords_v2
    client_customer_id: "xxx-yyy-zzzz"
    name: "test_append_user_id"
    mode: "append"

ワークフローの例 - UserListからuser_idを削除する

_export:
  td:
    database: google_ads_v2_db

+google_ads_v2_export_task:
  td>: remove_user_id.sql
  database: ${td.database}
  result_connection: new_created_google_ads_v2_auth
  result_settings:
    type: google_adwords_v2
    client_customer_id: "xxx-yyy-zzzz"
    name: "test_remove_user_id"
    mode: "remove"

詳細はUsing Workflows to Export Data with the TD Toolbeltをご覧ください。