Updates on the Google Ads data source, including new metrics, dimensions, and other features.
June 2025
2025-06-18
The following fields have been deprecated and return no value:
Extension type
Attribute values
Extension status
Feed ID
Feed item ID
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
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
2018-10-05
New dimension has been added:
Ad group type
2018-10-11
Google Ads connectors have been updated to now use the AdWords API version v201806.
2018-10-16
New metric has been added added:
Search impression share (raw)
2018-10-23
Google Ads connectors have been updated to now use the AdWords API version v201809.
2018-10-24
New fields has been added:
Headline part 3
Expanded text ad description 2
Mobile speed score
Mobile-friendly click rate
Valid AMP click rate
Sept. 2018
2018-09-17
New dimensions added:
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
2018-04-23
New dimension added to Keywords set:
Query targeting status
March 2018
2018-03-01
New metrics added:
Percent of budget used
Conversions per impression rate