How to request ad/group/campaign data by region through Google Ads API

[秦润辉]

How to request ad/group/campaign data by region through Google Ads API

[秦润辉]

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team. 

Based on the information provided, I understand that you are looking for guidance to retrieve the ad_group and campaign data segmented by region using the Google Ads API. I would recommend you to use the user_location_view or geographic_view resources to fetch the adgroup and campaign level data segmented by region through the Google Ads API. You need to make sure from where you are trying to retrieve the data before using any of the resources. 

1. I would recommend you to use the user_location_view resource if you are trying to fetch the data from your Google Ads account > Campaigns tab > Audiences, keywords and content > Locations. However, I am sharing with you the sample GAQL query and the Google Ads UI screenshot for your reference. 

SELECT user_location_view.country_criterion_id, user_location_view.resource_name, user_location_view.targeting_location, 
campaign.id, ad_group.id, campaign.name, ad_group.name, metrics.clicks, metrics.impressions, metrics.cost_micros, 
metrics.conversions, segments.geo_target_county FROM user_location_view

2. I would recommend you to use the geographic_view report if you are trying to fetch the data from your Google Ads account > Campaigns Tab > Insights and reports > When and where ads showed > Matched locations. However, I am sharing with you the sample GAQL query and the Google Ads UI screenshot for your reference. 

SELECT geographic_view.country_criterion_id, geographic_view.location_type, geographic_view.resource_name, 
segments.geo_target_region, campaign.id, ad_group.id, ad_group.name, campaign.name, metrics.clicks, metrics.impressions, 
metrics.cost_micros, metrics.conversions FROM geographic_view

You can use the search or searchStream methods in making the API calls while retrieving the data. Additionally, you can utilize the Google Ads Query Builder and Query Validator to build and validate the queries for retrieving the data from the Google Ads API.

I hope this clarifies. 
 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-05-12 16:39:24Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qWd48:ref" (ADR-00305158)