Google Ads Developer Blog: reporting

Product reporting changes for Google Ads starting June 15, 2026

2026 m. balandžio 30 d., ketvirtadienis

Starting June 15, 2026, the Google Ads API will begin transitioning product reporting to include data from all Performance Max networks. This update also provides comprehensive performance metrics across all campaign types and channels, including Performance Max, Shopping, Video, App, and Demand Gen. What is changing? Previously, reporting for products in Video, Demand Gen, and App campaigns was limited to high-level metrics like impressions and clicks. Also for Performance Max campaigns, only some networks were reported. This update introduces:

Expanded metrics for shopping_product: Cost and Conversion metrics will start returning data for Video, Demand Gen, and App campaigns, not just Shopping and Performance Max.

Consistent campaign reporting with shopping_performance_view: All campaign types that use Google Merchant Center (GMC) will have results returned with shopping_performance_view.

Network transparency for Performance Max: All networks will start being returned for Performance Max campaigns when querying for shopping_performance_view, so you may notice a one-time increase in all product reporting metrics for these campaigns. Note that data for these new metrics and expanded campaign coverage will only be available starting from June 15 2026. Historical API requests for dates prior to the launch will not contain this expanded data.

If you have any questions or want to discuss this post, please reach out to us on our “Google Advertising and Measurement Community” Discord server.

- Dora Sun - Google Ads API Team

Introducing lower confidence reach data in the Bid Manager API

2024 m. lapkričio 20 d., trečiadienis

Starting today, you can populate reports in the Bid Manager API with data that had been previously omitted due to lower statistical significance by using a new filter, FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID, and setting the value to “0”. This filter setting only impacts reach metrics with the following Metric prefixes as defined in the Bid Manager API:

METRIC_UNIQUE_REACH_

METRIC_VIRTUAL_PEOPLE_DUPLICATE_

METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_

METRIC_VIRTUAL_PEOPLE_OVERLAP_

queries.create requests with queries that filter by FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID but don’t include impacted metrics will return a 400 error. On February 4, 2025, Display & Video 360 will include unique reach data with lower statistical confidence by default. If you want to ensure that your reports continue to only return high-confidence data, we recommend that you update your integration to use the new filter value to filter to "1" when creating reports with any of the impacted metrics. Read more about these changes in our release notes. If you run into issues or have questions about these changes, please contact us using our new Bid Manager API Technical support contact form.

- Trevor Mulchay, Bid Manager API Team

Performance Max Campaign in Detail Placement View

2024 m. spalio 2 d., trečiadienis

The detail_placement_view can be used to query metrics aggregated by ad group and URL or YouTube video in the Google Ads API. The detail_placement_view is not intended to be used for campaigns with an advertising_channel_type of PERFORMANCE_MAX, as this view is only intended to be used with campaigns containing ad groups, and Performance Max campaigns are constructed with asset groups rather than ad groups. However, this view is currently returning impression data for Performance Max campaigns. The impression metrics returned from the detail_placement_view may not be accurate and should not be relied upon for campaigns with advertising_channel_type of PERFORMANCE_MAX. In the next release of the Google Ads API, v18, we will be adding a new resource called performance_max_placement_view, which can be used to query placement impression data for Performance Max campaigns, and in a subsequent release, we will stop returning impression data from the detail_placement_view for campaigns with advertising_channel_type of PERFORMANCE_MAX. Once performance_max_placement_view is released, use the data returned from that view for Performance Max campaigns rather than the data returned from the detail_placement_view. If you have any questions or need help, check out the Google Ads API support page for options.

- Devin Chasanoff, on behalf of the Google Ads API Team

Upcoming changes to search and display campaign reporting in the Google Ads API

2024 m. rugsėjo 23 d., pirmadienis

Starting on October 16, 2024, we will start rolling out changes to search and display reporting. As a result of this change, Google Ads Query Language (GAQL) queries for campaigns with an advertising_channel_type of SEARCH or DISPLAY will return a value of 0 for any metrics in that GAQL query when you include the fields segments.asset_interaction_target.asset or segments.asset_interaction_target.interaction_on_this_asset in the query. We are making this change now to ensure the accuracy of reporting data in preparation for future launches. If you have any questions or need help, check out the Google Ads API support page for options.

- Devin Chasanoff, on behalf of the Google Ads API Team

Announcing New Reporting Script for Performance Max

2023 m. liepos 17 d., pirmadienis

How can I get started?Find the script hereforumDavid Stevens, Google Ads Scripts Product Manager

Google Ads API Video Roundup

2022 m. spalio 24 d., pirmadienis

subscribe to our channelGoogle Ads API Best Practices - Error Handling and DebuggingGoogle Ads API Best Practices SeriesMeet the Team with David Wihl[Live Demo] Building a Google Ads API Web AppLogging & Monitoring

Introduction

Logging and Monitoring in the Cloud

Sending Client Logs to Google Cloud

Creating and Monitoring Custom Metrics

Google Ads Query Language (GAQL)

Getting Started with GAQL

Using the GoogleAdsFieldService

Retrieving Field Metadata
GAQL Fields and Clauses

Query Validation

Understanding Field Compatibility
The SELECT Requirement
Date Range Validation
Constructing Filtering Conditions in the WHERE Clause
Validating GAQL Queries

Authentication and AuthorizationWorking with RESTGoogle Ads API Developer SeriesGoogle Ads API forumgoogleadsapi-support@google.com

- Devin Chasanoff, on behalf of the Google Ads API Team

Important changes to placement reporting for App Campaigns

2022 m. vasario 28 d., pirmadienis

Google Ads API

Group Placement View

Detail Placement View

AdWords API / Google Ads scripts

Automatic Placements Performance Report

Placement Performance Report

App Campaigns Brand Safety Placement reportAPI forumgoogleadsapi-support@google.comscripts forum

Ian Ballantyne, Google Ads API Team

Search Terms Report Improvements

2021 m. rugsėjo 9 d., ketvirtadienis

With the updates listed below, we're improving the search term reports returned from both the Google Ads API and the AdWords API across all active versions.

Starting Sep 9, 2021, you'll be able to see more queries that meet our privacy standards in the search terms report for Search and Dynamic Search Ads campaigns. This new data will return for all searches on or after February 1st, 2021 when using the following reports and resources:

Google Ads API - search_term_view Resource
AdWords API - Keywordless Query Report
AdWords API - Search Query Performance Report

This update can help you identify more relevant keyword themes, making it easier to optimize your ads, landing pages, and more. Metric totals from search terms reports will now be consistent with other reports, such as campaign, ad group, and ad reports in Google Ads.

As part of our ongoing commitment to privacy, we’re working to make our privacy thresholds consistent across Google. Over the next few months, you’ll see more changes across our other tools–including how we handle historical data. In Google Ads, this means that historical query data in your account that was collected prior to September 1st, 2020 will be available until February 1st, 2022. At that point, any historical queries that no longer meet our current privacy thresholds will be removed from your search terms report.

If you have any questions about this change or any other API feature, please contact us via the forum.

- Cory Liseno, Google Ads API Team

Filtering Non-video Resources from Video Reports in the Google Ads API

2021 m. birželio 23 d., trečiadienis

August 4advertising_channel_typeVIDEOvideosupportedcampaignad_groupad_group_adforum

- Ben Karl, on behalf of the Google Ads API Team

Changes to Hotel Ads pricing buckets in the Google Ads API

2021 m. sausio 25 d., pirmadienis

hotel_price_bucket segmentExample:ONLY_PARTER_SHOWNLOWEST_UNIQUELOWEST_TIED

LOWEST_TIED

ONLY_PARTER_SHOWNLOWEST_UNIQUE

LOWEST_UNIQUE

ONLY_PARTER_SHOWN

LOWEST_TIED

UNKNOWN

LOWEST_TIED

forum

- Cory Liseno, Google Ads API Team

Live Webinar: Intro to Reporting & the Google Ads Query Language

2020 m. lapkričio 18 d., trečiadienis

Intro to Reporting & the Google Ads Query LanguageMark your calendarAgenda

Reporting in the Google Ads API vs. the AdWords API

Types of search requests you can perform with the Google Ads API

The syntax and structure of Google Ads Query Language queries

How to discover available fields to construct Google Ads Query Language queries

PrerequisitesAPI Overview documentationGoogle Ads API Overview workshopthis guideRemindersadd the event to your calendarYouTube event pageforum

- Devin Chasanoff, on behalf of the Google Ads API Team

Changes to stats retrieval for Search campaigns with Display Expansion

2020 m. sausio 13 d., pirmadienis

What’s changing?

We are changing how stats for Search campaigns with Display Expansion (previously known as Search campaigns with Display Select) are reported by the AdWords API, the Google Ads API, and Google Ads scripts.

Starting the week of Feb 17, 2020, we will no longer return display keyword stats for Search campaigns with Display Expansion in

Display Keyword Performance Report in the AdWords API and Google Ads scripts
Display_keyword_view in the Google Ads API.

Why is this changing?

Search campaigns with Display Expansion historically used keywords to perform Display Expansion. As we strive to improve targeting for Display Expansion, it is no longer possible to meaningfully and consistently attribute stats to keywords. As a result, this view has been removed from the Google Ads UI. The changes in this announcement aim to create parity between APIs and UI.

What should I do?

Before the sunset date, we recommend switching to alternate reports for fetching stats for Search campaigns with Display Expansion.

Automatic Placement Performance reports and Display Topics Performance report can be used in the AdWords API and Google Ads scripts to get granular performance data about these campaigns in the Display Network. If you use the Google Ads API, you can use group_placement_view and topic_view instead.
Reports such as Campaign Performance report or Ad Group Performance report can be used in the AdWords API and Google Ads scripts to fetch aggregate performance stats for these campaigns. You need to filter by AdNetworkType2 = CONTENT for Display Network stats. If you use the Google Ads API, you can use the campaign or ad_group view instead.

If you have any questions or need help, please contact us via the Google Ads scripts forum or the AdWords API and Google Ads API forum. - Anash P. Oommen, Google Ads API Team

Conversion reporting issues for November 11 through November 20

2019 m. lapkričio 21 d., ketvirtadienis

Update (Nov 27, 2019 15:00 PST): An issue that impacted Google Ads reporting for conversions occurring between Nov 11 and Nov 20 (Pacific Time) for advertisers using non-last click attribution models has been fixed and the data is now correct in all reports, including the Search Query Performance, Geo Performance, Keywordless Query, and Keywordless Category reports.

An issue that impacted Google Ads reporting for conversions occurring between Nov 11 and Nov 20 (Pacific Time) for advertisers using non-last click attribution models has been fixed and the data is now correct.

If you downloaded any of the fields in the table below or any derivative custom columns using the AdWords API, Google Ads API or Google Ads scripts since November 20th 9:00 PM PST, you may have incorrect data in your systems. Please re-download the affected fields to ensure accurate conversions reporting.

We appreciate your patience as we worked to resolve this issue.

AdWords API

Google Ads API beta

Conversions
ConversionValue
ConversionRate
ValuePerConversion
CostPerConversion
AllConversions
AllConversionValue
AllConversionRate
ValuePerAllConversion
CostPerAllConversion
CurrentModelAttributedConversions
CurrentModelAttributedConversionValue
ValuePerCurrentModelAttributedConversion
CostPerCurrentModelAttributedConversion

metrics.all_conversions
metrics.all_conversions_from_click_to_call
metrics.all_conversions_from_interactions_rate
metrics.all_conversions_from_interactions_value_per_interaction
metrics.all_conversions_value
metrics.all_conversions_value_per_cost
metrics.conversions
metrics.conversions_from_interactions_rate
metrics.conversions_from_interactions_value_per_interaction
metrics.conversions_value
metrics.conversions_value_per_cost
metrics.cost_per_all_conversions
metrics.cost_per_conversion
metrics.cost_per_current_model_attributed_conversion
metrics.cross_device_conversions
metrics.current_model_attributed_conversions
metrics.current_model_attributed_conversions_from_interactions_rate
metrics.current_model_attributed_conversions_from_interactions_value_per_interaction
metrics.current_model_attributed_conversions_value
metrics.current_model_attributed_conversions_value_per_cost
metrics.value_per_all_conversions
metrics.value_per_conversion
metrics.value_per_current_model_attributed_conversion

--Stan Grinberg, Google Ads API Team

Sunset of the Average Position Metric in AdWords and Google Ads APIs

2019 m. liepos 25 d., ketvirtadienis

Update (Jul 30, 2019): clarified the sunset schedule.

Starting the week of September 30, 2019, the average position metric will be sunset. This change was announced this past February in the Google Ads Help Center. The new alternatives were described in this November 2018 blog post. Once the sunset occurs, requests for the average position (AdWords API, Google Ads API) will return NULL values.

In the AdWords API v201809, NULL values are returned as two dashes. In the Google Ads API, NULL values are returned as NullValues.

If you use ValueTrack parameters, we encourage you to remove the ValueTrack parameter {adposition} from your tracking templates. When average position is sunset, the ValueTrack parameter {adposition} will begin returning the empty string.

Note that average position has already been removed from the current beta version of the Google Ads API, but is accessible in the earlier V1_x versions.

In lieu of average position, we recommend you use the new metrics of Impression (Absolute Top) %" and "Impression (Top) %. These are the new metrics:

Absolute Top Metrics
AdWords API	Google Ads API
AbsoluteTopImpressionPercentage	absolute_top_impression_percentage
SearchAbsoluteTopImpressionShare	search_absolute_top_impression_share
SearchBudgetLostAbsoluteTopImpressionShare	search_budget_lost_absolute_top_impression_share
SearchRankLostAbsoluteTopImpressionShare	search_rank_lost_absolute_top_impression_share

Top Metrics
AdWords API	Google Ads API
TopImpressionPercentage	top_impression_percentage
SearchTopImpressionShare	search_top_impression_share
SearchBudgetLostTopImpressionShare	search_budget_lost_top_impression_share
SearchRankLostTopImpressionShare	search_rank_lost_top_impression_share

As always, don't hesitate to reach out to us on the developer forum with any questions.
David Wihl, Google Ads API Team

Sunsetting the creation of target spend field for Maximize Clicks strategies in Google Ads API

2019 m. birželio 3 d., pirmadienis

On July 31st, 2019 we will begin to sunset the target spend field for Maximize Clicks bidding strategies in the API. This will affect all versions of both the AdWords API and Google Ads API. The following behaviors will be blocked:

Populating the target spend field on existing standard and portfolio strategies.
Attaching portfolio strategies that have the deprecated field set to campaigns.

Later this year, our systems will start ignoring the target spend field and instead use your daily budget to manage spend. In order to prepare for this change, you should start using your budgets to specify how much you’d like to spend for Maximize Clicks bidding strategies and migrate your campaigns off this field today.

Read on to see how this will affect your API usage.

	Affected Target Spend Fields
Google Ads API	`campaign.target_spend.target_spend_micros` `bidding_strategy.target_spend.target_spend_micros`
AdWords API	`Campaign.BiddingStrategyConfiguration.TargetSpendBiddingScheme.spendTarget` `SharedBiddingStrategy.TargetSpendBiddingScheme.spendTarget`

Change Description
Any mutate operations that set a target spend field for the first time will return an error. You will be able to update a target spend field that currently contain a value, but you cannot set previously empty fields to a new value. Additionally, any operation attaching a bidding strategy to a campaign, where that bidding strategy has a value set for a target spend field, will throw an error. To manage Target Spend on any new campaigns, we recommend using a campaign budget. In each of these disallowed cases an error will be thrown.

Performing any of the disallowed actions above will generate one of the following errors:

OPERATION_NOT_PERMITTED_FOR_CONTEXT
UNSUPPORTED_FIELD_IS_SET

If you have any questions about this change or any other API feature, please contact us via the forum.

- Cory Liseno, Google Ads API Team

Introducing the Google Ads Query Builder tool

2019 m. kovo 11 d., pirmadienis

Today we are excited to announce that the Google Ads Query Builder tool is now available on the Google Ads API Developer Site.

The Google Ads API has a robust reporting system that utilizes our new Google Ads Query Language. The language’s syntax allows you to select from all the resources that are available for reporting, and also filter or sort the result set on the server before they are returned to your application.

This tool provides a friendly web interface for you to explore our API’s reporting capabilities, and generate queries that you can copy and paste right into your applications. You can visit the site and try out the tool today!

Example usage of the Google Ads Query Builder: A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

A screenshot showing a sample usage of the Google Ads Query Builder UI, including both filtering and ordering.

Happy reporting!

- Cory Liseno, Google Ads API Team

Change to the Google Ads API and the AdWords API Showcase Ads Clicks Reporting

2019 m. vasario 21 d., ketvirtadienis

Update (Feb 21, 2019): clarified wording of the Clicks impact.
On February 27, 2019, the data returned in the Clicks metric for Showcase ads will change in order to more accurately show you the interactions with products via Showcase ads in reporting.

In the AdWords API and the Google Ads API, the Clicks metric (clicks for Google Ads API) will change for the Shopping Performance Report and the Product Partition Report (product_group_view for Google Ads API) as follows:

Current reporting: Clicks only include charged clicks.
New reporting: Clicks will report all clicks, including free clicks. As a result, you may see a change in the number of reported clicks.

If you have questions, please reach out to us on the forum.

Nadine Sundquist, Google Ads API Team

Top metrics, absolute top metrics, and average position in the AdWords API and Google Ads scripts

2018 m. lapkričio 7 d., trečiadienis

What's new
Starting November 12, 2018, the fields below will be available in AdWords API and Google Ads scripts reports.

Absolute top metrics:

AbsoluteTopImpressionPercentage
SearchAbsoluteTopImpressionShare
SearchBudgetLostAbsoluteTopImpressionShare
SearchRankLostAbsoluteTopImpressionShare

Top metrics:

TopImpressionPercentage
SearchTopImpressionShare
SearchBudgetLostTopImpressionShare
SearchRankLostTopImpressionShare

AbsoluteTopImpressionPercentage and TopImpressionPercentage are specific indicators of page location. You can use these metrics to determine when and where your impressions are showing above the organic search results.

SearchAbsoluteTopImpressionShare and SearchTopImpressionShare are your share of the eligible top impressions. They are the best indicators of the headroom available to show your ads in more prominent positions. If your goal is to bid on page location, you should use these metrics. Bidding by average position is not recommended since:

Average position doesn't actually describe position on the page but position in the auction.
Sometimes, average position may decrease as bids increase. This happens as higher bids sometimes allow you to enter more competitive auctions lower on the page.

See our post on the New features & announcements page for more details.

What you should do
Whenever you are using AveragePosition as a proxy to bid to a page location, switch to using the new SearchAbsoluteTopImpressionShare or SearchTopImpressionShare metrics in your bidding logic.

If you have any questions or need help, please contact us via the forum.

- Josh Radcliff, AdWords API Team

Changes to the URL Performance Report for YouTube video placements

2018 m. spalio 17 d., trečiadienis

What's changing?
The URL_PERFORMANCE_REPORT in the AdWords API will exclude information for YouTube video placements starting October 30, 2018, in keeping with our data retention policies. As a result, placements where the Url field has a domain of www.youtube.com will no longer appear in the report. New and improved placement reports will be available in one of the upcoming releases of the new Google Ads API.

What you should do
Review your application and workflows and make the necessary changes to ensure that the exclusion of video placements in this report will not cause problems. Watch this blog for updates regarding new placement reports in the Google Ads API.

If you have any questions or need help, please contact us via the forum.

- Josh Radcliff, AdWords API Team

Click measurement changes in AdWords

2018 m. gegužės 7 d., pirmadienis

Update (5/17): Starting October 30, 2018, parallel tracking will be required for all AdWords accounts. See the AdWords blog post for details.
AdWords now allows you to enable parallel tracking for all advertisers from frontend and API. People who click your ads will go directly to your landing page while their browser handles click measurement requests in the background. This helps reduce lost visits which can happen if a customer clicks on your ad but never sees your landing page because they navigate away before the redirect from your tracking URL completes.

All ads using third-party click measurement will begin using parallel tracking at a later date. However, you should start developing for compatibility as soon as possible to give yourself enough time for the migration. If you implement your own click measurement server or provide this service to your customers, refer to our newly published guide for help with implementation. If you are an advertiser who uses a third-party measurement solution, reach out to your service provider to prepare for the switch.

If you need additional support, please email us at ads-clicktracking-support@google.com.

- Anash P. Oommen, AdWords API Team

Ads Developer Blog

Product reporting changes for Google Ads starting June 15, 2026

Introducing lower confidence reach data in the Bid Manager API

Performance Max Campaign in Detail Placement View

Upcoming changes to search and display campaign reporting in the Google Ads API

Announcing New Reporting Script for Performance Max

Google Ads API Video Roundup

Important changes to placement reporting for App Campaigns

Search Terms Report Improvements

Filtering Non-video Resources from Video Reports in the Google Ads API

Changes to Hotel Ads pricing buckets in the Google Ads API

Live Webinar: Intro to Reporting & the Google Ads Query Language

Changes to stats retrieval for Search campaigns with Display Expansion

Conversion reporting issues for November 11 through November 20

Sunset of the Average Position Metric in AdWords and Google Ads APIs

Sunsetting the creation of target spend field for Maximize Clicks strategies in Google Ads API

Introducing the Google Ads Query Builder tool

Change to the Google Ads API and the AdWords API Showcase Ads Clicks Reporting

Top metrics, absolute top metrics, and average position in the AdWords API and Google Ads scripts

Changes to the URL Performance Report for YouTube video placements

Click measurement changes in AdWords

Etiketės

Archive