Google Ads統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Reporting API | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
1. 統合前の準備
1.1 Developer tokenの申請
Google Ads Manager AccountでGoogle Adsの管理画面にログインし、右上のメニューで「TOOLS & SETTINGS」-「SETUP」-「API Center」を選択して、Google Ads API Token Applicationに記入し、Developer tokenを申請します。
アクセス権限がBasic LevelのDeveloper Token、つまり申請完了後のDeveloper Tokenを提供する必要があります。権限がTest AccountのDeveloper Tokenは使用できません。
申請をよりスムーズに完了できるよう、申請フォームの質問に対する回答例をまとめました。こちらのドキュメントで確認できます。また、Developer tokenの詳細については公式ドキュメントも参照してください：
申請フォームに記入したら、Token Review TeamがDeveloper Tokenを承認するまで待つ必要があります。審査はほとんどの場合1営業日以内に完了し、通常3日を超えることはありません。
1.2 Client IDとClient Secretの生成
Developer Tokenの取得と並行して、APIのアクセス認証情報、つまりClient IDとClient Secretも作成する必要があります。API認証情報を作成する前に、Google Cloud Platformにプロジェクトがあり、そのプロジェクトでGoogle Ads APIが有効になっている必要があります。この節の手順に従って、Client IDとClient Secretを作成してください。
1.2.1 Google Cloud Platformでプロジェクトを作成
Google Cloud Platformでまだプロジェクトを作成していない場合は、Google Cloud Platformにログインし、「CREATE PROJECT」をクリックしてプロジェクトを作成します。すでにプロジェクトを作成済みの場合は、この手順をスキップできます。
図1. 新規プロジェクトの作成イメージ
1.2.2 Google Ads APIの権限を有効化
プロジェクトを作成したら、次にGoogle Ads APIの権限を有効にします。Google Cloud Platformの管理画面上部の検索バーで「Google Ads API」を検索し、紹介ページに移動します。ページ内の下図の領域に「ENABLE」と表示されている場合は、プロジェクトでGoogle Ads APIの権限がまだ有効になっていません。「ENABLE」をクリックして権限を有効にしてください。
図2. Google Ads APIの紹介ページ
1.2.3 API認証情報を作成し、Client IDとClient Secretを取得
Google Ads APIの権限を有効にしたら、次にGoogle Ads APIの権限を持つAPI認証情報、つまりデータ取得時に必要なClient IDとClient Secretを作成します。
- Google Ads APIの権限を有効にすると、次のページに移動するはずです。ここで下図の赤枠の「CREATE CREDENTIALS」をクリックすると、認証情報の作成フローに進みます。
- 上記のページが見つからない場合は、ページ左上のメニューバーで「APIs & Services」-「Enabled APIs & services」を開くこともできます。リストからGoogle Ads APIを探してクリックし、下図のページに移動します。ここで「CREDENTIALS」タブを選択し、「+ CREATE CREDENTIALS」をクリックして「Help me choose」を選択しても、認証情報の作成フローに進めます。
認証情報の作成フローに進んだら、以下の手順に従って設定を完了してください
- Credential Typeページで、Google Ads API、User Dataを順に選択し、「NEXT」をクリックします
- Scopesページで「ADD OR REMOVE SCOPES」をクリックし、リストからGoogle Ads APIを探してチェックを入れ、Scopeリストに追加します。「SAVE AND CONTINUE」をクリックします
- OAuth Client IDページで、Application typeにWeb applicationを選択します
- 同じくOAuth Client IDページで、Authorized redirect URIsにコールバックURLを設定します。現時点ではまだAEシステムでプランを作成していないため、認証URLにはひとまず「https://www.example.com」と入力し、プランの作成が完了してから正式なコールバックURLに変更してください。
- すべての設定が完了したら、「CREATE」をクリックして認証情報を作成します。作成が完了すると、ページにClient IDとClient Secretが表示されます。この2つの情報は大切に保管してください
- 最後に、「OAuth consent screen」に入り、Publishing status欄で「PUBLISH APP」をクリックして、アプリを正式版として公開します
1.3 Customer IDとLogin Customer IDの取得
最後に、データを取得する広告アカウントのCustomer IDと、そのユーザーのマネージャーアカウントのCustomer ID（以降の呼び出しで使用するLogin Customer ID）を用意してください。これらのIDは次の手順で確認できます。
- Google Adsの管理画面で、データを取得する広告アカウントにログインします
- 右上のヘルプアイコンをクリックします
- メニューの下部でCustomer IDを確認します
- マネージャーアカウントに切り替え、上記の手順でCustomer IDを取得します。これがLogin Customer IDです（マネージャーアカウントの管理者から直接Customer IDを入手することもできます）
1.4 まとめ
以上で、Googleプラットフォームでの統合前の準備作業は完了です。次の情報を取得できていることを確認してください：
- Develop Token
- Client ID
- Client Secret
- Login Customer ID（マネージャーアカウントのCustomer ID）
- データを取得するすべての広告アカウントのCustomer ID
2. プランの設定
Googleプラットフォームでの準備作業が完了したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を行います。下図はGoogle Adsの設定画面です。本章の内容に従ってプランを作成してください
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した情報を入力します：
2.2 定期取得
「定期取得」モジュールで、AEシステムがGoogle Ads Reporting APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_mapping | 格納後のイベント名。カスタマイズ可能で、JSON型です。Keyはsource.report_typesに対応し、Valueはそのresourceのデータのイベント名です。sink_event.event_nameと排他 |
| event_name | 格納後のイベント名。カスタマイズ可能で、文字列型です。受信したデータはすべてこの名前をイベント名とします。sink_event.event_mappingと排他 | |
| source | report_types | 取得するresource、つまり取得するレポートの名前。リスト型です。要素は1つだけ、つまり一度に1つのレポートのデータのみを取得することをお勧めします 選択可能な値: ad_group_ad_asset_view、ad_group_ad、conversion_action、campaign、geographic_view、およびその他のresources。詳しくは以下の内容を参照してください |
| metrics | データ内の指標。リスト型です。階層によって対応するmetricsが異なるため、入力時に注意が必要です | |
| group_by | データ内のグループ化ディメンション。リスト型です。階層によって対応するgroup_byが異なるため、入力時に注意が必要です | |
| extra_params | date_key | データ内の時間フィールド |
| where | 追加のフィルター条件。GAQLの構文を使用する必要があります |
階層ごとにデータの設定が大きく異なるため、各階層の設定テンプレートをそのまま使用するか、テンプレートを微調整して使用することをお勧めします
2.4.1 Ad Group Ad Asset Viewテンプレート
Ad Group Ad Asset Viewは、ad group階層とasset階層を統合したレポートです。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、公式ドキュメントを確認し、metricsで始まる指標をsource.metricsに、その他のディメンションフィールドをsource.group_byに追加してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"ad_group_ad_asset_view"
],
"metrics":
[
"metrics.all_conversions",
"metrics.all_conversions_value",
"metrics.all_conversions_value_per_cost",
"metrics.average_cpc",
"metrics.clicks",
"metrics.conversions",
"metrics.conversions_value",
"metrics.conversions_value_per_cost",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.ctr",
"metrics.impressions",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.biddable_app_install_conversions"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"ad_group_ad.ad.id",
"ad_group_ad.ad.name",
"asset.id",
"asset.name",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"ad_group_ad.action_items",
"asset.youtube_video_asset.youtube_video_title",
"asset.youtube_video_asset.youtube_video_id"
]
}
}
- テンプレートでは、データ内のsegments.dateフィールド（データの日付）をデータの時間として使用します
- テンプレートで使用するイベント名は -- google_ads_ad_group_ad_asset_view です
2.4.2 Ad Group Adテンプレート
Ad Group Adでは、Ad階層のデータを確認でき、ad group、campaign階層のディメンションも使用できます。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、公式ドキュメントを確認し、metricsで始まる指標をsource.metricsに、その他のディメンションフィールドをsource.group_byに追加してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"ad_group_ad"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks",
"metrics.conversions",
"metrics.ctr",
"metrics.average_cpm",
"metrics.average_cpe",
"metrics.average_cpc",
"metrics.trueview_average_cpv",
"metrics.average_cost",
"metrics.all_conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.active_view_cpm",
"metrics.active_view_ctr",
"metrics.video_trueview_views",
"metrics.video_trueview_view_rate",
"metrics.video_quartile_p25_rate",
"metrics.video_quartile_p50_rate",
"metrics.video_quartile_p75_rate",
"metrics.video_quartile_p100_rate"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"ad_group_ad.ad.id",
"ad_group_ad.ad.name",
"campaign.bidding_strategy",
"campaign.bidding_strategy_type",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"campaign.app_campaign_setting.bidding_strategy_goal_type",
"ad_group_ad.action_items"
]
}
}
- テンプレートでは、データ内のsegments.dateフィールド（データの日付）をデータの時間として使用します
- テンプレートで使用するイベント名は -- google_ads_ad_group_ad です
2.4.3 Conversion Actionテンプレート
Conversion Actionは、コンバージョン行動のデータ分析に特化したレポートです。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、公式ドキュメントを確認し、metricsで始まる指標をsource.metricsに、その他のディメンションフィールドをsource.group_byに追加してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"conversion_action"
],
"metrics":
[
"metrics.all_conversions",
"metrics.all_conversions_value"
],
"group_by":
[
"customer.id",
"segments.date",
"customer.manager",
"customer.time_zone",
"customer.tracking_url_template",
"customer.auto_tagging_enabled",
"customer.conversion_tracking_setting.conversion_tracking_id",
"customer.conversion_tracking_setting.cross_account_conversion_tracking_id",
"customer.currency_code",
"customer.descriptive_name",
"conversion_action.app_id",
"conversion_action.attribution_model_settings.attribution_model",
"conversion_action.attribution_model_settings.data_driven_model_status",
"conversion_action.category",
"conversion_action.click_through_lookback_window_days",
"conversion_action.counting_type",
"conversion_action.id",
"conversion_action.include_in_conversions_metric",
"conversion_action.mobile_app_vendor",
"conversion_action.name",
"conversion_action.owner_customer",
"conversion_action.phone_call_duration_seconds",
"conversion_action.resource_name",
"conversion_action.status"
]
}
}
- テンプレートでは、データ内のsegments.dateフィールド（データの日付）をデータの時間として使用します
- テンプレートで使用するイベント名は -- google_ads_conversion_action です
2.4.4 Campaignテンプレート
Campaignレポートでは、campaign階層のデータを確認できます。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、公式ドキュメントを確認し、metricsで始まる指標をsource.metricsに、その他のディメンションフィールドをsource.group_byに追加してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"campaign"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks",
"metrics.conversions",
"metrics.ctr",
"metrics.average_cpm",
"metrics.average_cpe",
"metrics.average_cpc",
"metrics.trueview_average_cpv",
"metrics.average_cost",
"metrics.all_conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.value_per_all_conversions",
"metrics.value_per_conversion",
"metrics.view_through_conversions",
"metrics.active_view_cpm",
"metrics.active_view_ctr",
"metrics.current_model_attributed_conversions",
"metrics.current_model_attributed_conversions_value",
"metrics.engagement_rate",
"metrics.engagements",
"metrics.cost_per_current_model_attributed_conversion",
"metrics.cross_device_conversions",
"metrics.conversions_value_by_conversion_date",
"metrics.absolute_top_impression_percentage",
"metrics.active_view_impressions",
"metrics.active_view_measurability",
"metrics.active_view_measurable_impressions",
"metrics.active_view_measurable_cost_micros",
"metrics.active_view_viewability",
"metrics.all_conversions_by_conversion_date",
"metrics.all_conversions_from_interactions_rate",
"metrics.all_conversions_value",
"metrics.all_conversions_value_by_conversion_date",
"metrics.average_page_views",
"metrics.average_time_on_site",
"metrics.bounce_rate",
"metrics.conversions_by_conversion_date",
"metrics.conversions_from_interactions_rate",
"metrics.interactions",
"metrics.interaction_event_types",
"metrics.interaction_rate",
"metrics.percent_new_visitors",
"metrics.top_impression_percentage",
"metrics.value_per_all_conversions_by_conversion_date",
"metrics.value_per_conversions_by_conversion_date",
"metrics.value_per_current_model_attributed_conversion"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"segments.date",
"segments.ad_network_type",
"campaign.id",
"campaign.name",
"campaign.bidding_strategy",
"campaign.bidding_strategy_type",
"campaign.advertising_channel_type",
"campaign.advertising_channel_sub_type",
"campaign.app_campaign_setting.bidding_strategy_goal_type"
]
}
}
- テンプレートでは、データ内のsegments.dateフィールド（データの日付）をデータの時間として使用します
- テンプレートで使用するイベント名は -- google_ads_campaign です
2.4.5 Geographic Viewテンプレート
Geographic Viewレポートでは、地理的な位置の階層のデータを確認できます。以下はこのインターフェースのテンプレートで、全文をそのまま統合構成にコピーできます。調整が必要な場合は、公式ドキュメントを確認し、metricsで始まる指標をsource.metricsに、その他のディメンションフィールドをsource.group_byに追加してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_mapping":
{
"ad_group_ad_asset_view": "google_ads_ad_group_ad_asset_view",
"ad_group_ad": "google_ads_ad_group_ad",
"conversion_action": "google_ads_conversion_action",
"campaign": "google_ads_campaign",
"geographic_view": "google_ads_geographic_view"
}
},
"source":
{
"report_types":
[
"geographic_view"
],
"metrics":
[
"metrics.all_conversions",
"metrics.average_cpc",
"metrics.average_cpm",
"metrics.clicks",
"metrics.conversions",
"metrics.conversions_value",
"metrics.cost_micros",
"metrics.cost_per_all_conversions",
"metrics.cost_per_conversion",
"metrics.ctr",
"metrics.impressions",
"metrics.interaction_event_types",
"metrics.interaction_rate",
"metrics.interactions",
"metrics.value_per_conversion",
"metrics.video_trueview_views"
],
"group_by":
[
"customer.id",
"customer.currency_code",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name",
"geographic_view.country_criterion_id",
"geographic_view.location_type",
"geographic_view.resource_name",
"segments.ad_network_type",
"segments.date",
"segments.device"
]
}
}
- テンプレートでは、データ内のsegments.dateフィールド（データの日付）をデータの時間として使用します
- テンプレートで使用するイベント名は -- google_ads_geographic_view です
2.4.6 カスタムテンプレートの作成方法
上記はよく使われるいくつかのResourceのテンプレートです。その他のResourceのデータを取得したい場合は、この節の内容に従って操作してください。
まず、Google Ads APIの公式ドキュメントにアクセスします。「Resource with metrics」で該当するリソースを探すことをお勧めします。リソースとはレポートのことで、リソースごとに分析ディメンションと指標が異なります。右側でそのリソースの概要を確認できます。このリソースを統合すると決めたら、右側のリソース名（下図のad_groupなど）を控えて、source.report_typesに追加します
続いてこのページを見ていくと、Resource fields、Segments、Metricsの3列のフィールドがあります。この3列が、選択したリソースで使用できる指標とディメンションです。必要なフィールド名をクリックすると、ad_group.idのようなフィールドのフルネームを確認できます。必要なフィールドのフルネームを控え、metrics.で始まるフィールドはsource.metricsに、その他のフィールドはsource.group_byに記述してください
このほか、Attributed resourcesに記載されているリソースのResource fieldsも使用できます。
下図はad_groupのAttributed resourcesで、campaignというresourceがあります。「campaign」のハイパーリンクをクリックすると、表示されたページに示されるcampaignのResource fieldsは、すべてad groupで使用できるディメンションです。たとえば、campaign.idはad_groupリソースで使用できます。これらのフィールドはsource.group_byに記述してください
最後に、格納するイベント名とデータの格納時間を決める必要があります。
まずは格納名です。既存のsink_event.event_mappingを削除してsink_event.event_nameを追加し、そこに格納するイベント名を記述することをお勧めします。イベント名を記述しないと、データを格納できません。
次にデータの格納時間です。一般的には、segments.dateをデータの時間として使用することをお勧めします。その場合は、source.group_byにsegments.dateを追加し、extra_params.date_keyにも同じくsegments.dateを追加する必要があります。その他のフィールドをデータの時間として使用する場合も、この2か所にそのフィールドの元の名前を追加する必要があります。
以上でカスタムテンプレートの作成は完了です。以下の設定を参考にカスタムテンプレートを作成してください：
{
"extra_params":
{
"date_key": "segments.date"
},
"sink_event":
{
"event_name": "google_ads_ad_group"
},
"source":
{
"report_types":
[
"ad_group"
],
"metrics":
[
"metrics.impressions",
"metrics.clicks"
],
"group_by":
[
"customer.id",
"segments.date",
"campaign.id",
"campaign.name",
"ad_group.id",
"ad_group.name"
]
}
}
2.4.7 extra_params.whereの使い方
統合パラメータextra_params.whereは高度なパラメータで、Reporting APIのフィルター機能に対応しています。この機能はGAQL文（Reporting APIのクエリ文で、SQLに類似）に対応しているため、次の方法で記述することをお勧めします：
まず、統合したいResourceのページに移動し、上部の「Help me build a query」をクリックしてGAQLの作成補助ページに進みます
次に、下図の「WHERE」タブをクリックして、そのresourceで使用できるフィルターフィールドを確認します：
必要なフィールドを選択し、画面の案内に従ってフィルター条件を選択します
すべてのフィルター条件を作成したら、上部の作成エリアを確認し、Whereより後ろの内容をコピーしてextra_params.whereに記入します
{
"extra_params":
{
"date_key": "segments.date",
"where": "ad_group.name = 'abc' AND ad_group.type = 'TRAVEL_ADS'"
}
//...... other params
}
2.4.8 Google Adsのクエリタイムアウト設定
Google Adsのクエリの合計タイムアウトは、統合プランまたはデータベースで設定でき、単位はミリ秒です。正の整数のみ有効です。設定されていない場合や設定が無効な場合は、次の優先順位の値が使用されます。
統合プランでの設定
{
"extra_params": {
"ta_options": {
"search_total_timeout_ms": 300000
}
}
}
例の300000は5分を表します。
データベースでの設定
INSERT INTO ta.ta_software_config (namespace, config_key, config_val)
VALUES ('ta-thirdparty', 'google_ads_search_total_timeout_ms', '300000');
設定の優先順位
- 統合プランの
extra_params.ta_options.search_total_timeout_ms - データベースの
google_ads_search_total_timeout_ms - Google Ads SDKのデフォルト値（現在は4時間）
2.5 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
-
Google Ads Reporting APIは集計データを返すため、ユーザー識別子として固定値を使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください
-
extra_paramsのdate_keyに対応するフィールド（通常はsegments.dateフィールド）を、イベントの#event_timeとして使用します
-
sink_event.event_mappingの設定を使用し、データのイベント名は次のとおりです：
- ad_group_ad_asset_view：google_ads_ad_group_ad_asset_view
- ad_group_ad：google_ads_ad_group_ad
- conversion_action：google_ads_conversion_action
- campaign：google_ads_campaign
- geographic_view：google_ads_geographic_view
-
その他のフィールドはすべて格納されます
2.6 標準化フィールド
データに次のイベントプロパティが存在する場合は、自動的に標準化処理を行います：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| customer_id | te_ads_object.ad_account_id | 広告アカウントID |
| campaign_name | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| ad_group_name | te_ads_object.ad_group_name | 広告グループ名 |
| ad_group_id | te_ads_object.ad_group_id | 広告グループID |
| ad_group_ad_ad_name | te_ads_object.ad_name | 広告名 |
| ad_group_ad_ad_id | te_ads_object.ad_id | 広告ID |
| segment_slot | te_ads_object.placement | 広告の配置 |
| geographic_view_country_criterion_id | te_ads_object.country | 国・地域コード |
| customer_currency_code | te_ads_object.currency | コストまたは収益の通貨 |
| metrics_impressions | te_ads_object.impressions | 露出数 |
| metrics_clicks | te_ads_object.clicks | クリック数 |
| metrics_conversions | te_ads_object.conversions | コンバージョン数 |
| metrics_biddable_app_install_conversions | te_ads_object.installs | コンバージョン数（インストール） |
| metrics_cost_micros（1000000で割る） | te_ads_object.cost | ユーザー獲得コスト |
2.7 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
次に、Google Cloud Platformに戻り、先ほど作成したcredentialsを編集します（サイドバーの「APIs & Services」-「Credentials」で、以前作成したOauth 2.0 Client IDを確認でき、その後ろにある編集ボタンをクリックすると編集ページに移動します）。Authorized redirect URIsに先ほどコピーしたコールバックURLを追加し、「Save」をクリックして変更を完了します。
最後に、AEの画面に戻って「認証設定へ」をクリックすると、Google Adsの認証ページが開きます
マネージャーアカウントに関連付けられたGoogleアカウントでログインし、Googleの指示に従って以降の認証操作を完了してください
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックし、右下の「認証完了」をクリックして設定を終了します。これで、Google Adsのデータ統合は完了です。
3. バージョン更新履歴
2026-01-29 バージョン更新
変更内容：Google AdsのインターフェースのバージョンがV19からV22に更新され、一部のプロパティの名前が変更されました
公式サイトのリンク：https://developers.google.com/google-ads/api/docs/upgrade
| V19の旧フィールド | V22の現フィールド | フィールドの説明 |
|---|---|---|
average_cpv | trueview_average_cpv | 広告が視聴されるたびに支払う平均費用です。平均視聴単価（CPV）は、すべての広告視聴の総費用をTrueView視聴回数で割った値として定義されます。 |
| video_view_rate | video_trueview_view_rate | TrueView動画広告の視聴回数を表示回数で割った値です。TrueViewディスプレイ広告のサムネイル表示回数も含まれます。 |
| video_views | video_trueview_views | 動画広告のTrueView視聴回数です。 |
TEのGoogle Adsサードパーティ統合プランのインターフェースでの対応：
| 既存のプラン | 変更されたフィールドを使用している場合 | 2026-01-29のバージョン更新後、新旧両方のフィールドにデータを二重書き込みします。どちらを使用するかはお客様が選択できます |
| 変更されたフィールドを使用していない場合 | 影響なし | |
| 新規プラン | 変更されたフィールドを使用している場合 | すべて更新後のV22インターフェースのテンプレートを使用します |
| 変更されたフィールドを使用していない場合 |