Google Ads Import Integration V2

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は、企業が数百万のGoogleパートナーWebサイトや、Google検索、YouTube、Mapsなどのサービスを通じて、デジタル広告で製品やサービスをプロモーションできるオンライン広告プラットフォームです。このインテグレーションを使用すると、Google Adsのレポートとメトリクスを Treasure Data にインポートして、カスタマーエクスペリエンスをカスタマイズし、データに基づいた意思決定でキャンペーンを最適化し、より良いマーケティング結果を達成できます。

前提条件

• Treasure Data™ の基本知識
• Google Ads パフォーマンスデータの基本的な理解

要件と制限事項

• データが大きすぎると、インポートジョブが失敗する可能性があります。ページングを使用することで、この問題を解決できます。
• Googleは、パフォーマンスデータのデフォルトビューを時々変更する可能性があるため、以下の各レポートタイプの事前定義されたメトリクスコレクションは、Google Adsで見つかる対応するレポートと同じではない場合があります。ただし、不足しているメトリクスを追加して、データ要件を満たすことができます。
• この記事では、利用可能なすべてのattributes、segments、metrics、およびそれらの説明をリストすることを意図していません。詳細については、Google Ads Query Builder、または Google Ads UI (Campaigns > Insights and reports > Report Editor) にある Report Editor 機能を参照してください。

TD Console 経由で Google Ads からインポート

データをインポートする前に、TD Console でデータ接続を作成して設定する必要があります。データ接続の一部として、Google Ads アカウントの OAuth 認証を提供し、以下の手順でインテグレーションをデプロイします。

1. TD Console を開く
2. Integrations Hub > Catalog に移動
3. Google Ads V2 を検索して選択
4. Create Authentication を選択し、ターゲット Google Ads アカウントにアクセスできる Google アカウントの OAuth を提供
5. Integration Hub にリダイレクトされた後、上記の手順を繰り返し（今回は提供した OAuth が表示されます）、認証の名前を入力して Done を選択

Sourceの作成

1. TD Console を開く
2. Integrations Hub > Authentications に移動
3. 新しい認証を見つけて New Source を選択
4. 最初のステップ **1 - Connection** で、Data Transfer Name フィールドに Source 名を入力し、Next を選択

Source Tableの識別

以下のパラメータを使用して Treasure Data に取り込むデータを識別し、Next を選択します。

このインテグレーションは、ターゲットデータを定義する柔軟な方法をサポートしています:

• 4つの事前定義されたレポートタイプのいずれかを選択し、必要な Attributes、Segments、および Metrics を選択する。または、
• Google Ads で有効なカスタムクエリを入力して、必要なデータをインポートする。このオプションは Google Ads Query Builder と併用することをお勧めします。

Source Table Parameter

Source Table Parameter - Custom Query

データ設定の定義

オプションで、高度なデータ設定を変更できます。Next を選択して次のステップに進みます。

データのプレビュー

• **4 - Data Preview** ステップで、Generate Preview を選択して、インポートを実行する前にデータの近似ビューを確認します（オプション）
• Next を選択して続行

Data Placement

データの配置について、データを配置したいターゲット database と table を選択し、インポートを実行する頻度を指定します。

1. Next を選択します。Storage の下で、インポートされたデータを配置する新しい database を作成するか、既存の database を選択し、新しい table を作成するか、既存の table を選択します。

2. Database を選択 > Select an existing または Create New Database を選択します。

3. オプションで、database 名を入力します。

4. Table を選択 > Select an existing または Create New Table を選択します。

5. オプションで、table 名を入力します。

6. データをインポートする方法を選択します。

   • Append (デフォルト) - データインポートの結果は table に追加されます。 table が存在しない場合は作成されます。
   • Always Replace - 既存の table の全体の内容をクエリの結果出力で置き換えます。table が存在しない場合は、新しい table が作成されます。
   • Replace on New Data - 新しいデータがある場合のみ、既存の table の全体の内容をクエリの結果出力で置き換えます。

7. Timestamp-based Partition Key 列を選択します。 デフォルトキーとは異なるパーティションキーシードを設定したい場合は、long または timestamp 列をパーティショニング時刻として指定できます。デフォルトの時刻列として、add_time フィルターで upload_time を使用します。

8. データストレージの Timezone を選択します。

9. Schedule の下で、このクエリを実行するタイミングと頻度を選択できます。

一度だけ実行

1. Off を選択します。
2. Scheduling Timezone を選択します。
3. Create & Run Now を選択します。

定期的に繰り返す

1. On を選択します。
2. Schedule を選択します。UI では、@hourly、@daily、@monthly、またはカスタム cron の 4 つのオプションが提供されます。
3. Delay Transfer を選択して、実行時間の遅延を追加することもできます。
4. Scheduling Timezone を選択します。
5. Create & Run Now を選択します。

転送が実行された後、Data Workbench > Databases で転送の結果を確認できます。

CLI (Toolbelt) 経由で Google Ads からインポート

前提条件:

• TD Toolbelt: 最新バージョンの TD CLI ツールをインストール: TD Toolbelt
• Authentication ID: 上記の手順に従って、TD Console でこのインテグレーションの Authentication を作成します。その後、Authentication 画面の URL の最後の部分で ID を確認できます。

一般的な手順:

1. YML 設定ファイルを作成します。例: **load.yml**、`td_authentication_id' フィールドで作成した認証を参照します。 詳細については、以下のパラメータリファレンスと例を参照してください
2. 次のコマンドを使用して、入力データをプレビューします（オプション）: $ **td connector:preview** load.yml
3. 次のコマンドを使用して、データインポートをトリガーします: $ **td** **connector:issue** load.yml --database db-name --table table-name
4. 次のコマンドを使用して、実行をスケジュールします: $ **td** **connector:create** daily\_import "10 0 \* \* \*" db-name table-name load.yml

詳細な参考情報については、このページを参照してください

パラメータリファレンス

例

カスタムクエリを無効にする

in:
  type: google_adwords_v2
  td_authentication_id: 330392
  enable_custom_query: false
  client_customer_id: xx-xxxx-xxxx
  target: AD_PERFORMANCE_REPORT
  date_range: "CUSTOM_DATE"
  include_predefined_metrics: false
  incremental: true
  start_date: 2020-03-01
  end_date: 2020-03-02
  segments: ["segments.date"]
  metrics: ["metrics.absolute_top_impression_percentage"]
out:
  mode: append

カスタムクエリを有効にする

in:
  type: google_adwords_v2
  td_authentication_id: 330392
  enable_custom_query: true
  client_customer_id: xx-xxxx-xxxx
  date_range: "CUSTOM_DATE"
  enable_date_range: true
  incremental: true
  start_date: 2020-03-01
  end_date: 2020-03-02
  select_columns: ad_group_criterion.criterion_id, ad_group.id, ad_group.name, segments.date
  from_target: keyword_view
  other_conditions: "AND ad_group_criterion.type = 'KEYWORD'"
out:
  mode: append

Manager Ads Account で使用する

in:
  type: google_adwords_v2
  td_authentication_id: 330392
  enable_custom_query: true
  client_customer_id: xx-xxxx-xxxx
  login_customer_id: xx-xxxx-xxxx
  date_range: "CUSTOM_DATE"
  incremental: true
  start_date: 2020-03-01
  end_date: 2020-03-02
  select_columns: ad_group_criterion.criterion_id, ad_group.id, ad_group.name, segments.date
  from_target: keyword_view
  other_conditions: "AND ad_group_criterion.type = 'KEYWORD'"
out:
  mode: append

Workflow 経由で Google Ads V2 からインポート

TD Workflow を使用して Google Ads からデータをインポートできます。詳細については、こちらを参照してください。

Google Ads Query Language をコネクタのカスタムクエリに変換する方法

Query language リファレンス: https://developers.google.com/google-ads/api/docs/query/overview?hl=en

例:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE segments.date during LAST_30_DAYS
  AND campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
in:        type: google_adwords_v2  enable_custom_query: true  client_id: xxx  client_secret: xxx  refresh_token: xxx  client_customer_id: xx-xxxx-xxxx  date_range: "LAST_30_DAYS"  developer_token: xxx  select_columns: campaign.id, campaign.name, campaign.status, metrics.impressions, segments.date  from_target: campaign  other_conditions: "AND campaign.status = 'PAUSED' AND metrics.impressions > 1000"
in:        type: google_adwords_v2  enable_custom_query: true  client_id: xxx  client_secret: xxx  refresh_token: xxx  client_customer_id: xx-xxxx-xxxx  login_customer_id: xx-xxxx-xxxx  date_range: "LAST_30_DAYS"  developer_token: xxx  select_columns: campaign.id, campaign.name, campaign.status, metrics.impressions, segments.date  from_target: campaign  other_conditions: "AND campaign.status = 'PAUSED' AND metrics.impressions > 1000"

注: クエリには時間が必要で、where 条件を含める必要があります。例のように、other_conditions は AND で始まる必要があります。

事前定義されたメトリクス

利用可能な日付範囲