- 24 Aug 2023
- 1 分で読み終わります
- 印刷
- ダークライト
転送元 - Google Ads(Google広告)
- 更新日 24 Aug 2023
- 1 分で読み終わります
- 印刷
- ダークライト
概要
Google広告(Google Ads)の実績を取得してデータを転送する設定のヘルプページです。
対応プロトコル
- データ転送(Embulk)
- 利用しているAPI:Google Ads APIの
v12
制約
データの取得が可能なフィールドの指定値は、以下の2つの条件を満たす必要があります。
指定した「リソースタイプ (レポート種別)」で取得可能な、
Fields
Segments
Metrics
であること。リソースタイプ別の取得可能な
Fields/Segments/Metrics
- Account (customer)
- Campaign (campaign)
- Ad group (ad_group)
- Ad (ad_group_ad)
- Search keyword (keyword_view)
- Search terms (search_term_view)
- Paid and organic (paid_organic_search_term_view)
- Expanded Landing page (expanded_landing_page_view)
- account_budget
- account_budget_proposal
- account_link
- ad_group_ad_asset_view
- ad_group_ad_label
- ad_group_asset
- ad_group_audience_view
- ad_group_bid_modifier
- ad_group_criterion
- ad_group_criterion_label
- ad_group_criterion_simulation
- ad_group_extension_setting
- ad_group_feed
- ad_group_label
- ad_group_simulation
- ad_parameter
- ad_schedule_view
- age_range_view
- asset
- asset_group_asset
- batch_job
- bidding_strategy
- billing_setup
- campaign_asset
- campaign_audience_view
- campaign_bid_modifier
- campaign_budget
- campaign_criterion
- campaign_criterion_simulation
- campaign_draft
- campaign_extension_setting
- campaign_feed
- campaign_label
- campaign_shared_set
- carrier_constant
- change_status
- click_view
- conversion_action
- currency_constant
- custom_interest
- customer_asset
- customer_client
- customer_client_link
- customer_extension_setting
- customer_feed
- customer_label
- customer_manager_link
- customer_negative_criterion
- detail_placement_view
- display_keyword_view
- distance_view
- domain_category
- dynamic_search_ads_search_term_view
- extension_feed_item
- feed
- feed_item
- feed_item_target
- feed_mapping
- feed_placeholder_view
- gender_view
- geo_target_constant
- geographic_view
- group_placement_view
- hotel_group_view
- hotel_performance_view
- income_range_view
- keyword_plan
- keyword_plan_ad_group
- keyword_plan_ad_group_keyword
- keyword_plan_campaign
- keyword_plan_campaign_keyword
- label
- language_constant
- location_view
- managed_placement_view
- media_file
- mobile_app_category_constant
- mobile_device_constant
- offline_user_data_job
- operating_system_version_constant
- parental_status_view
- product_bidding_category_constant
- product_group_view
- recommendation
- remarketing_action
- shared_criterion
- shared_set
- shopping_performance_view
- third_party_app_analytics_link
- topic_constant
- topic_view
- user_interest
- user_list
- user_location_view
- video
フィールドに複数の値を指定する場合、指定値に含まれる
Segments
と互換性のある値(同時に取得可能な値)であること。
Segments
ごとの互換性のある値は、公式ドキュメントのSegments一覧各項目の「Selectable With」欄を参照ください。
指定可能なフィールドであるかどうかは、公式ツールの「Google Ads Query Builder」を用いて検証することが可能です。
Google Ads Query Builderを利用したフィールド指定可能値の検証方法を参照ください。
設定項目
STEP1 基本設定
項目名 | 必須 | デフォルト値 | 内容 |
---|---|---|---|
Google Ads API接続情報 | Yes | - | あらかじめ登録してある接続情報から、今回の転送設定に必要な権限を持つものを選択します。 Google Ads API接続情報の作成についてはこちらをご覧ください。 |
顧客ID | Yes | - | Google広告のアカウント一覧から、顧客IDを確認してください。 候補一覧には接続設定で使用したGoogleアカウントでアクセス可能な顧客IDが表示されます。 ![]() |
リソースタイプ(レポート種別) | Yes | - | レポートタイプの一覧は GoogleAdsAPI公式からご確認いただけます。 |
フィールド | Yes | - | レポートに含める項目(フィールド)を選択します。 各リソースタイプに設定できるフィールドは一覧は GoogleAdsAPI公式からご確認いただけます。 |
データ取得期間 | No | - | 取得するレポートの期間を入力します。開始日、終了日両方を入力してください。 実行時から見て相対的に日付を指定したい場合などは、カスタム変数を設定することで、日付を動的に設定することも可能です。 |
Money フィールドの値について
Google Adsから取得した金額のフィールドは1,000,000倍されています。(公式サイト参考)
例:123(円)=> 123,000,000.
troccoにおいて金額フィールドは1/1000000されて扱われ一般的な通貨の単位となります。
例:123(円)=> 123.
対象のフィールドは下記になります。
metrics.cost_micros
metrics.average_cpc
metrics.cost_per_all_conversions
metrics.active_view_cpm
metrics.active_view_measurable_cost_micros
metrics.average_cost
metrics.average_cpm
metrics.cost_per_conversion
metrics.benchmark_average_max_cpc
ad_group_criterion.effective_cpc_bid_micros
ad_group_criterion.effective_cpm_bid_micros
ad_group_criterion.position_estimates.estimated_add_cost_at_first_position_cpc
ad_group.cpv_bid_micros
ad_group.effective_target_cpa_micros
bidding_strategy.target_cpa.cpc_bid_ceiling_micros
bidding_strategy.target_cpa.cpc_bid_floor_micros
bidding_strategy.target_roas.cpc_bid_ceiling_micros
bidding_strategy.target_roas.cpc_bid_floor_micros
bidding_strategy.target_spend.cpc_bid_ceiling_micros
bidding_strategy.target_spend.target_spend_micros
campaign_budget.amount_micros
campaign_budget.recommended_budget_amount_micros
Google Ads Query Builderを利用したフィールド指定可能値の検証方法
- Google Ads Query Builderの「List of all resources」から、リソースタイプに指定したい項目をクリックします。
- Choose a Clause to Select FromのSELECTタブで、
Attribute Resource Fields
,Segments
,Metrics
,Attributed Resource Fields
から、フィールドに指定したい項目にチェックマークを入れます。 - チェックマークを入れた値と互換性のない値は取り消し線が表示されます。
以下のキャプチャは、リソースタイプad_group
でsegments.ad_destination_type
にチェックマークを入れた場合のものです。
補足
Google Adwordsからの切り替え対応を行う場合は、以下Webページも合わせてご参照ください。
Migrating Report Fields | Google Ads API | Google Developers
https://developers.google.com/google-ads/api/docs/migration/reports