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

Google Ads Updates

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

May 2024

2024-05-30

The following field has been deprecated:

  • Sales country

April 2023

2023-04-25

New fields added:

  • Ad group excluded parent asset set types
  • Aligned bidding strategy ID
  • All conversions from location asset click to call
  • All conversions from location asset directions
  • All conversions from location asset menu
  • All conversions from location asset order
  • All conversions from location asset other engagement
  • All conversions from location asset store visits
  • All conversions from location asset websites
  • Asset location ownership type
  • Asset place ID
  • Bidding strategy aligned campaign budget ID
  • Campaign excluded parent asset set types
  • Campaign primary status
  • Campaign primary status reasons
  • Eligible impressions from location asset store reach
  • Enable customer level location asset set
  • Publisher organic clicks
  • Publisher purchased clicks
  • Publisher unknown clicks
  • View through conversions from location asset click to call
  • View through conversions from location asset directions
  • View through conversions from location asset menu
  • View through conversions from location asset order
  • View through conversions from location asset other engagement
  • View through conversions from location asset store visits
  • View through conversions from location asset website

2023-04-12

New dimensions added:

  • Business name
  • Call to action text
  • Headline 1 (Multi asset)
  • Headline 2 (Multi asset)
  • Headline 3 (Multi asset)
  • Headline 4 (Multi asset)
  • Headline 5 (Multi asset)
  • Headline 6 (Multi asset)
  • Headline 7 (Multi asset)
  • Headline 8 (Multi asset)
  • Headline 9 (Multi asset)
  • Headline 10 (Multi asset)
  • Headline 11 (Multi asset)
  • Headline 12 (Multi asset)
  • Headline 13 (Multi asset)
  • Headline 14 (Multi asset)
  • Headline 15 (Multi asset)
  • Description 1 (Multi asset)
  • Description 2 (Multi asset)
  • Description 3 (Multi asset)
  • Description 4 (Multi asset)
  • Description 5 (Multi asset)

January 2023

2023-01-26

New fields added:

  • All conversions (by conv. time)
  • All conversions value (by conv. time)
  • Conversions (by conv. time)
  • Conversions value (by conv. time)
  • Value / all conversions (by conv. time)
  • Value / conversions (by conv. time)

December 2022

2022-12-22

New fields added:

  • Ad strength
  • Bid strategy status
  • Campaign priority
  • Conversions from click-to-call
  • Conversions from directions
  • Conversions from menu
  • Conversions from order
  • Conversions from other engagement
  • Conversions from store visit
  • Conversions from store website
  • Enable local
  • Feed label
  • Optimization score
  • Sales country
  • Vehicle inventory

2022-12-20

New dimensions added:

Assets

  • Approval status
  • Asset field type
  • Asset ID
  • Asset name
  • Asset source
  • Asset status
  • Asset type
  • Book on Google Asset
  • Final mobile URL
  • Final URL
  • Final URL suffix
  • Policy topic entries
  • Resource name
  • Review status
  • Tracking URL template
  • URL custom parameters

Call assets

  • Ad schedule targets
  • Call conversion action
  • Call conversion reporting state
  • Phone number's country code
  • Phone number

Call to action

  • Call to action

Callout assets

  • Ad schedule targets
  • Callout text
  • End date
  • Start date

Discovery carousel card assets

  • Call to action text
  • Carousel card headline
  • Marketing image asset
  • Portrait marketing image asset
  • Square marketing image asset

Dynamic custom assets

  • Android deep link
  • Contextual keywords
  • Formatted price
  • Formatted sale price
  • Dynamic custom asset ID
  • Dynamic custom asset ID2
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Item address
  • Item category
  • Item description
  • Item subtitle
  • Item title
  • Price
  • Sale price
  • Similar IDs

Dynamic education assets

  • School address
  • Android deep link
  • Contextual keywords
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Location ID
  • Program description
  • Program ID
  • Program name
  • School name
  • Similar program IDs
  • Subject
  • Thumbnail image URL

Dynamic flight assets

  • Android deep link
  • Custom mapping
  • Destination ID
  • Destination name
  • Flight description
  • Flight price
  • Flight sale price
  • Formatted price
  • Formatted sale price
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Origin ID
  • Origin name
  • Similar destination IDs

Dynamic travel assets

  • Android deep link
  • Category
  • Contextual keywords
  • Destination address
  • Destination ID
  • Destination name
  • Formatted price
  • Formatted sale price
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Origin ID
  • Origin name
  • Price
  • Sale price
  • Similar destination IDs
  • Title

Hotel callout assets

  • Language code (Hotel callout assets)
  • Text (Hotel callout assets)

Image assets

  • File size
  • Image height
  • Full size image URL
  • Image width
  • MIME type

Lead form assets

  • Background image asset
  • Business name
  • Call to action description
  • Call to action type
  • Custom disclosure
  • Custom question fields
  • Delivery methods
  • Description (Lead form assets)
  • Desired intent
  • Fields
  • Headline (Lead form assets)
  • Post submit call to action type
  • Post submit description
  • Post submit headline
  • Privacy policy URL

Dynamic hotels and rentals assets

  • Address
  • Android deep link
  • Category
  • Contextual keywords
  • Description
  • Destination name
  • Formatted price
  • Formatted sale price
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Price
  • Property ID
  • Property name
  • Sale price
  • Similar property IDs
  • Star rating

Dynamic jobs assets

  • Address (Dynamic jobs assets)
  • Android deep link (Dynamic jobs assets)
  • Contextual keywords (Dynamic jobs assets)
  • Description (Dynamic jobs assets)
  • Image URL (Dynamic jobs assets)
  • iOS deep link (Dynamic jobs assets)
  • iOS app store ID (Dynamic jobs assets)
  • Job category
  • Job ID
  • Job subtitle
  • Job title
  • Location ID (Dynamic jobs assets)
  • Salary
  • Similar job IDs

Dynamic local assets

  • Address
  • Android deep link
  • Category
  • Contextual keywords
  • Deal ID
  • Deal name
  • Description
  • Formatted price
  • Formatted sale price
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Price
  • Sale price
  • Similar deal IDs
  • Subtitle

Dynamic real estate assets

  • Address
  • Android deep link
  • City name
  • Contextual keywords
  • Description
  • Formatted price
  • Image URL
  • iOS deep link
  • iOS app store ID
  • Listing ID
  • Listing name
  • Listing type
  • Price
  • Property type
  • Similar listing IDs

Mobile app assets

  • App ID
  • App store
  • End date
  • Link text
  • Start date

Page feed assets

  • Labels
  • Page URL

Price assets

  • Language code (Price assets)
  • Price offerings
  • Price qualifier
  • Price asset type

Promotion assets

  • Ad schedule targets
  • Discount modifier
  • End date
  • Language code (Promotion assets)
  • Amount (Money amount off)
  • Currency code (Money amount off)
  • Occasion
  • Amount (Orders over amount)
  • Currency code (Orders over amount)
  • Percent off
  • Promotion code
  • Promotion target
  • Redemption end date
  • Redemption start date
  • Start date

Sitelink assets

  • Ad schedule targets
  • Description 1
  • Description 2
  • End date
  • Link text
  • Start date

Structured snippet assets

  • Snippet header
  • Snippet values

Text assets

  • Text

YouTube video assets

  • YouTube video ID
  • YouTube video URL

August 2022

2022-08-09

New field added:

  • Postal code

July 2022

2022-07-19

New dimensions added:

  • Responsive search ad headline 11

  • Responsive search ad headline 12

  • Responsive search ad headline 13

  • Responsive search ad headline 14

  • Responsive search ad headline 15

June 2022

2022-06-03

Shopping report now supports these fields:

  • Advertising channel type
  • Advertising channel sub-type

May 2022

Updated data source to Google Ads API v10.1.

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".

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