Google Ads Via Audience Partner Api 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を使用してマーケティングキャンペーンを実行する際に、Treasure Dataのデータを活用できます。

Treasure Dataに保持されているデータを使用して、Google Ads - DFPでオーディエンスリストを作成できます。次の手順に従って、Cookie、IDFA、ADIDを新規または既存のGoogle Ads内のオーディエンスリストに移動します。

以下のトピックに進んでください:

Prerequisites

• Treasure Dataの基礎知識（TD Toolbeltを含む）
• Google Adsアカウント
• Google AdsアカウントへのTreasure Data DMPアクセスの承認

Limitations from Google Ads

オーディエンスリストの更新がGoogle Adsに表示されるまでに、最大24時間かかる場合があります。クエリ完了時点から変更がGoogle Adsに反映されるまで、最大24時間待つ必要があります。

Grant Access for Treasure Data

Treasure Data Google Ads via Audience Partner APIコネクタには、Google Adsアカウントでオーディエンスセグメントを作成するための権限が必要です。Treasure DataにGoogle Adsアカウントへのアクセスを許可するため、Google Ads Supportにメールを送信してください。メールには以下の情報を記載してください:

• Request: Treasure Dataに権限を付与

• Treasure Data DMP:

  • Customer-ID: 140-996-0635
  • NID: treasuredata_dmp

この情報を送信することで、GoogleがTreasure Dataを認識し、TDアカウントとGoogle Adsアカウントを関連付けます。

Usage

データをエクスポートするには、新規または既存の接続を作成または選択し、クエリを作成または再利用してから、クエリを実行してオーディエンスリストをエクスポートします。

Create or Reuse a Query

• Query Editorに移動します。クエリ言語を選択してクエリを記述できます。
• データベースとテーブルを選択します。
• データのエクスポートに使用する予定のクエリにアクセスします。以下はサンプルクエリです:

SELECT DISTINCT "cookie", "list_name", "time", "process_consent" FROM "google_adwords_ddp"

Create or Select an Existing Google Ads via Audience Partner API Connection

新しい接続の作成:

既存の接続の選択:

Configure the Connection by Specifying the Parameters

Google Ads via Audience Partner API接続を選択すると、Configurationダイアログペインが表示されます:

Google APIからの移行により、Use Audience Partner APIsオプションを選択することを推奨します。

Source Column Name Mappings (Optional)

Google DDP列名とクエリで指定した出力列名の間のマッピングを定義します。ターゲット列を選択してから、ソース列を選択します。例えば、google_cookieがTDデータソースの識別子列である場合、マッピングをcookie:google_cookieとして定義する必要があります。マッピングにソース列が欠落している場合は、ターゲット列名が使用されます。例えば、cookieはcookie:cookieマッピングと同じです。

サポートされている列名と使用方法の詳細については、追加のコネクタ設定情報を参照してください。

Cookie or Mobile Identifier Column Header

ユーザーCookieまたはモバイル識別子のソースを指定します。

次のいずれかのオプションを選択する必要があります:

• cookie_encrypted : 暗号化された識別子（例: Web）、ユーザーIDのCookieハッシュ
• cookie_idfa : iOS Advertising Identifier
• cookie_adid : Android Advertising Identifier
• cookie_epid Cookie externally provided 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 を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリに名前を付けて保存してから実行するか、そのまま実行します。クエリが正常に完了すると、結果は自動的に処理されます。オーディエンスリスト（セグメントとも呼ばれる）がGoogle Adsに反映されるように、少なくとも24時間前にデータを転送するように計画してください。

Audience Studio で Segment をアクティベートする

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 を選択します。

Additional Connector Configuration Information

TreasureDataからのデータをGoogleがどのように処理するかは、コネクタの設定方法に影響します。

Column Mappings

Google Ads via Audience Partner APIは、列ごとにデータソーステーブルを読み取り、以下の列名マッピングを使用して各行データを処理します:

Cookie or Mobile Identifier Name

アップロードプロセスは複数の異なる識別子をサポートしており、これらの識別子が正しいアップロードファイル形式を使用してセグメントにアップロードされることが重要です。一般的に、識別子は2つのカテゴリのいずれかに分類されます: 暗号化された識別子（Googleシステムから取得されたもの）と生の識別子（外部システムまたはソースから取得されたもの）。暗号化された識別子はcookie_encryptedまたはcookie_epidファイル形式を使用してアップロードされ、生の識別子はMobile Advertising Identifierなどの型固有のアップロードファイル形式（例: cookie_idfaまたはcookie_adid）でアップロードされます。

サポートされているCookieタイプは、cookie_encrypted、cookie_epid、cookie_idfa、およびcookie_adidです。