Supermetrics brings all your Google Ads data into Google Sheets, Google Data Studio, Excel, BigQuery, Snowflake, Redshift, Azure

Google Ads Updates

Updates on the Google Ads data source, including new metrics, dimensions, and other features.

August 2022

2022-08-09

New field added:

  • Postal code

June 2022

2022-06-03

Shopping report now supports these fields:

  • Advertising channel type
  • Advertising channel sub-type

March 2022

2022-03-21

Migrated Age range report to Google Ads API.

2022-03-23

Migrated Gender report to Google Ads API.

2022-03-24

Migrated Budget report to Google Ads API.

Feb. 2022

2022-02-15

Updated data source to use Google Ads API for account discovery. This means SA360 search engine accounts will no longer be reportable by the data source.

2022-02-18

Migrated Campaign report to Google Ads API.

These fields are now deprecated, please remove them from your reporting: * Average frequency * Average position * Bidding strategy source * Click assisted conversions * Click assisted conversion value * Impression assisted conversions * Impression assisted conversion value * Impression reach * Max CPA

2022-02-22

Migrated Ad group report to Google Ads API.

2022-02-24

Migrated Ad report to Google Ads API.

2022-02-25

Migrated Account report to Google Ads API.

Dec. 2021

2021-12-16

Support for Performance Max Campaigns added. Special steps are needed to fetch these until we can migrate certain reports to the new Google Ads API. Please see our support portal for more information.

2021-12-14

The data source has been updated to use Google Ads API v9.

Sept. 2021

2021-09-16

New dimensions added:

  • Changed campaign name
  • Changed campaign ID
  • Changed ad group name
  • Changed ad group ID
  • Changed ad ID

August 2021

2021-08-24 -

The following report types have been migrated to use Google Ads API:

  • URL Performance Report
  • Automatic Placements Performance Report

This means that data for placements will be obtained through the Google Ads API instead of AdWords API. This may mean that same field values will be different as they have changed in the newer API and may not align with data still obtained through the AdWords API (which the majority of the data source's requests will still use).

May 2021

2021-05-05 -

Additional functionality added to support "Local campaigns". Instructions for how to use this is here.

New fields added:

  • Location source type
  • Target impression share (location)
  • Target impression share % (location)

March 2021

2021-03-29 -

Added fields for supporting "App Campaigns for Engagement":

  • App campaign app ID
  • App campaign app store
  • App campaign bidding strategy goal type

For more info on how to request these, see https://support.supermetrics.com/support/solutions/articles/19000124601-google-ads-querying-for-app-campaign-for-engagement-data.

Jan. 2021

2021-01-12 - 

Added new dimensions to get the Final URL dimensions specifically from the FINAL_URL_REPORT:

  •     Effective final URL
  •     Effective tracking URL template

2021-01-19 -

Behavior of "Top of page CPC" is now to show as currency value instead of micros.

Added new metrics for search click share:

  • Search click share
  • Eligible search clicks
  • Lost search clicks

2021-01-21 -

Added new field:

  • Week (Sun-Sat)

Updated field header:

Week -> Year & Week (Sun-Sat)

Oct. 2020

2020-10-29:

The following fields were deprecated, please use "Final URL" as a replacement.

Deprecated field Replace with...
Destination URL Final URL
Keyword destination URL Final URL
Placement destination URL Final URL

June 2020

2020-06-17 - 

These metrics will have their values change to numerical values:

  • Historical search predicted CTR
  • Historical landing page quality score
  • Historical creative quality score

The current text values will change as follows:

Old text value New numeric value
Unknown 0
Below average -1
Average 1
Above Average 2

In addition, these new dimensions will be added that retain the text values:

  • Historical search predicted CTR (text)
  • Historical landing page quality score (text)
  • Historical creative quality score (text)

2020-06-30 -

Added the following new fields:

  • Target ROAS (Maximize Conversion Value)
  • Final URL suffix

April 2020

2020-04-23 -

Due to some internal adjustments, the following fields are now listed under a different category than before. This does not change or break any existing queries, the fields are the same as before. Just when building queries they may be in a different place in the field list now.

Field display name Old category New category
Enhanced CPC AD GROUP CAMPAIGN
Max CPC KEYWORD AD GROUP
Max CPM PLACEMENT AD GROUP
Quality score PLACEMENT KEYWORD
Is negative PLACEMENT KEYWORD
First page CPC PLACEMENT KEYWORD
Preferred position PLACEMENT KEYWORD
Creative destination URL AD As "Destination URL" under AD
Bidding strategy type BID GOAL PERFORMANCE CAMPAIGN
Cost per estimated total conversions BID GOAL PERFORMANCE CONVERSION
Estimated value per all conversion BID GOAL PERFORMANCE CONVERSION

In Data Studio, the typo'd field name "Bidding stategy type" was corrected to "Bidding strategy type". 

March 2020

2020-03-23 -

New field added:

  • Configured budget amount

2020-03-31 -

Support added for the "Bid Goal Performance" report type, which added these new fields:

  • External customer ID
  • Page one promoted bid ceiling
  • Page one promoted bid changes for raises only
  • Page one promoted bid modifier
  • Page one promoted raise bid when budget constrained
  • Page one promoted raise bid when quality score is low
  • Page one promoted strategy goal
  • Bidding strategy status
  • Target CPA
  • Target CPA max CPC bid ceiling
  • Target CPA max CPC bid floor
  • Target outrank share
  • Target outrank share bid changes for raises only
  • Target outrank share competitor domain
  • Target outrank share max cpc bid ceiling
  • Target outrank share raise bid when quality score is low
  • Target ROAS
  • Target ROAS bid ceiling
  • Target ROAS bid floor
  • Target spend bid ceiling
  • Target spend spend target
  • Bidding strategy type
  • Ad group count
  • Ad group criteria count
  • Estimated total conversion rate
  • Campaign count
  • Cost per estimated total conversions
  • Non-removed ad group count
  • Non-removed ad group criteria count
  • Non-removed campaign count
  • Estimated value per all conversions

Feb. 2020

2020-02-18:

New report type added for Campaign Location Target, along with the new dimension that support the main functionality of that report "Target location".

The following fields have been marked as deprecated as Google no longer returns data for these:

  • Average frequency
  • Unique cookies

Sadly, the replacement fields for these are not supported in the AdWords API at this time. Please remove them from your reporting.

Jan. 2020

2020-01-29 - new feature added to support "user locations" when pulling location data from the Geo Performance report.

Aug. 2019

2019-08-28:

Due to Google deprecating the "Average Position" metric later this year (end of September 2019), the following new metrics have been added to help replace that functionality:

  • Top impression percentage
  • Search top impression share
  • Search budget lost top impression share
  • Search rank lost top impression share
  • Search absolute top Impression share
  • Search budget lost absolute Top Impression share
  • Search Rank Lost Absolute Top Impression share

Then on September 30th, the following fields will be deprecated in our system and you should remove or replace them as appropriate.

  • Average position
  • Organic average position

June 2019

2019-06-03:

New dimensions have been added which allows users to click through to view more details about the campaign/account or edit the details. The user clicking the link must have access to the ad account as normal to view the information.

  • Account edit link
  • Campaign edit link
  • Ad group edit link

May 2019

2019-05-07 - new dimension added:

  • All networks keywords

Feb. 2019

2019-02-27 - Support added for Multi Asset Responsive Ads. The following fields have been added for that:

  • Headline 1 (multi asset responsive display)
  • Headline 2 (multi asset responsive display)
  • Headline 3 (multi asset responsive display)
  • Headline 4 (multi asset responsive display)
  • Headline 5 (multi asset responsive display)
  • Long headline (multi asset responsive display)
  • Description 1 (multi asset responsive display)
  • Description 2 (multi asset responsive display)
  • Description 3 (multi asset responsive display)
  • Description 4 (multi asset responsive display)
  • Description 5 (multi asset responsive display)
  • Business name (multi asset responsive display)
  • Call to action text (multi asset responsive display)
  • Promotion text (multi asset responsive display)
  • Ad format preference (multi asset responsive display)
  • Main color (multi asset responsive display)
  • Accent color (multi asset responsive display)
  • Allow flexible color (multi asset responsive display)
  • Logo URL 1 (multi asset responsive display)
  • Logo URL 2 (multi asset responsive display)
  • Logo URL 3 (multi asset responsive display)
  • Logo URL 4 (multi asset responsive display)
  • Logo URL 5 (multi asset responsive display)
  • Landscape logo URL 1 (multi asset responsive display)
  • Landscape logo URL 2 (multi asset responsive display)
  • Landscape logo URL 3 (multi asset responsive display)
  • Landscape logo URL 4 (multi asset responsive display)
  • Landscape logo URL 5 (multi asset responsive display)
  • Image URL 1 (multi asset responsive display)
  • Image URL 2 (multi asset responsive display)
  • Image URL 3 (multi asset responsive display)
  • Image URL 4 (multi asset responsive display)
  • Image URL 5 (multi asset responsive display)
  • Image URL 6 (multi asset responsive display)
  • Image URL 7 (multi asset responsive display)
  • Image URL 8 (multi asset responsive display)
  • Image URL 9 (multi asset responsive display)
  • Image URL 10 (multi asset responsive display)
  • Image URL 11 (multi asset responsive display)
  • Image URL 12 (multi asset responsive display)
  • Image URL 13 (multi asset responsive display)
  • Image URL 14 (multi asset responsive display)
  • Image URL 15 (multi asset responsive display)
  • Square image URL 1 (multi asset responsive display)
  • Square image URL 2 (multi asset responsive display)
  • Square image URL 3 (multi asset responsive display)
  • Square image URL 4 (multi asset responsive display)
  • Square image URL 5 (multi asset responsive display)
  • Square image URL 6 (multi asset responsive display)
  • Square image URL 7 (multi asset responsive display)
  • Square image URL 8 (multi asset responsive display)
  • Square image URL 9 (multi asset responsive display)
  • Square image URL 10 (multi asset responsive display)
  • Square image URL 11 (multi asset responsive display)
  • Square image URL 12 (multi asset responsive display)
  • Square image URL 13 (multi asset responsive display)
  • Square image URL 14 (multi asset responsive display)
  • Square image URL 15 (multi asset responsive display)
  • YouTube video URL 1 (multi asset responsive display)
  • YouTube video URL 2 (multi asset responsive display)
  • YouTube video URL 3 (multi asset responsive display)
  • YouTube video URL 4 (multi asset responsive display)
  • YouTube video URL 5 (multi asset responsive display)

2019-03-02 - New dimension added:

  • Branded vs. non-branded search queries

Jan. 2019

2019-01-03:

The following fields have been marked as 'deprecated' and will return no values, as they have been deprecated in the Google Ads APIsince September 2018:

  • Click assisted conversions (deprecated)
  • Click assisted conversion value (deprecated)
  • Impression assisted conversions (deprecated)
  • Impression assisted conversion value (deprecated)

Oct. 2018

New dimension has been added 2018-10-05:

  • Ad group type

Google Ads connectors have been updated to now use the AdWords API version v201806 - 2018-10-11.

New metric has been added added 2018-10-16:

  • Search impression share (raw)

Google Ads connectors have been updated to now use the AdWords API version v201809 - 2018-10-23.

New fields has been added 2018-10-24:

  • Headline part 3
  • Expanded text ad description 2
  • Mobile speed score
  • Mobile-friendly click rate
  • Valid AMP click rate

Sept. 2018

New dimensions added 2018-09-17:

  • Product title
  • Automated

Added support for getting the "Final URL" from the Keyword Report in Google Ads so you can now those URLS for keywords in addition to the other supported objects.

April 2018

New dimension added to Keywords set 2018-04-23:

  • Query targeting status

March 2018

New metrics added 2018-03-01:

  • Percent of budget used
  • Conversions per impression rate