Through the new Google Ads API, there is different formatting of values being returned by most dimensions where the most noticeable differences are values in ALL_CAPS with an underscore filling in the spaces. In some cases, the entire value may differ from what was previously returned from the old Google Adwords API. A good example of this being: 'Display' result from the Network dimension is now returned as 'Content'
These formatting and result differences could affect any existing filters that are set up in your widgets. Below, the first four charts call out specific dimensions that are more common to be filtered by. In the left column of each is the full list of expected values that could populate under this dimensions with that formatting applied. In the right column is the description of that value as defined by Google.
For a more complete list of values which could be returned from a dimension through the new Google Ads API, you may view the the possible results and the way they're formatted via the following API Documentation link, with your dimension options on the left-hand side of the screen under "enums:" https://developers.google.com/google-ads/api/reference/rpc/v10/AccessInvitationStatusEnum.AccessInvitationStatus
Past our four examples of dimensions, you will find additional examples in the fifth chart of new formatting / results compared against the result from Google Adwords API. The most complete list will be found in the above link. If you're having trouble with your filters, please reach out to our Customer Advocacy Team.
Dimension: Ad Group Type
| EXPECTED RESULT | DESCRIPTION |
| UNSPECIFIED | The type has not been specified. |
| UNKNOWN | The received value is not known in this version. This is a response-only value. |
| SEARCH_STANDARD | The default ad group type for Search campaigns. |
| DISPLAY_STANDARD | The default ad group type for Display campaigns. |
| SHOPPING_PRODUCT_ADS | The ad group type for Shopping campaigns serving standard product ads. |
| HOTEL_ADS | The default ad group type for Hotel campaigns. |
| SHOPPING_SMART_ADS | The type for ad groups in Smart Shopping campaigns. |
| VIDEO_BUMPER | Short unskippable in-stream video ads. |
| VIDEO_TRUE_VIEW_IN_STREAM | TrueView (skippable) in-stream video ads. |
| VIDEO_TRUE_VIEW_IN_DISPLAY | TrueView in-display video ads. |
| VIDEO_NON_SKIPPABLE_IN_STREAM | Unskippable in-stream video ads. |
| VIDEO_OUTSTREAM | Outstream video ads. |
| SEARCH_DYNAMIC_ADS | Ad group type for Dynamic Search Ads ad groups. |
| SHOPPING_COMPARISON_LISTING_ADS | The type for ad groups in Shopping Comparison Listing campaigns. |
| PROMOTED_HOTEL_ADS | The ad group type for Promoted Hotel ad groups. |
| VIDEO_RESPONSIVE | Video responsive ad groups. |
| VIDEO_EFFICIENT_REACH | Video efficient reach ad groups. |
| SMART_CAMPAIGN_ADS | Ad group type for Smart campaigns. |
Dimension: Ad Network Type (Network)
| EXPECTED RESULT | DESCRIPTION |
| UNSPECIFIED | Not specified. |
| UNKNOWN | The value is unknown in this version. |
| SEARCH | Google search. |
| SEARCH_PARTNERS | Search partners. |
| CONTENT (previously 'Display') | Display Network. |
| YOUTUBE_SEARCH | YouTube Search. |
| YOUTUBE_WATCH | YouTube Videos |
| MIXED | Cross-network. |
Dimension: Ad Type
| EXPECTED RESULT | DESCRIPTION |
| UNSPECIFIED | No value has been specified. |
| UNKNOWN | The received value is not known in this version. This is a response-only value. |
| TEXT_AD | The ad is a text ad. |
| EXPANDED_TEXT_AD | The ad is an expanded text ad. |
| EXPANDED_DYNAMIC_SEARCH_AD | The ad is an expanded dynamic search ad. |
| HOTEL_AD | The ad is a hotel ad. |
| SHOPPING_SMART_AD | The ad is a Smart Shopping ad. |
| SHOPPING_PRODUCT_AD | The ad is a standard Shopping ad. |
| VIDEO_AD | The ad is a video ad. |
| GMAIL_AD | This ad is a Gmail ad. |
| IMAGE_AD | This ad is an Image ad. |
| RESPONSIVE_SEARCH_AD | The ad is a responsive search ad. |
| LEGACY_RESPONSIVE_DISPLAY_AD | The ad is a legacy responsive display ad. |
| APP_AD | The ad is an app ad. |
| LEGACY_APP_INSTALL_AD | The ad is a legacy app install ad. |
| RESPONSIVE_DISPLAY_AD | The ad is a responsive display ad. |
| LOCAL_AD | The ad is a local ad. |
| HTML5_UPLOAD_AD | The ad is a display upload ad with the HTML5_UPLOAD_AD product type. |
| DYNAMIC_HTML5_AD |
The ad is a display upload ad with one of the DYNAMIC_HTML5_* product types.
|
| APP_ENGAGEMENT_AD | The ad is an app engagement ad. |
| SHOPPING_COMPARISON_LISTING_AD | The ad is a Shopping Comparison Listing ad. |
| VIDEO_BUMPER_AD | Video bumper ad. |
| VIDEO_NON_SKIPPABLE_IN_STREAM_AD | Video non-skippable in-stream ad. |
| VIDEO_OUTSTREAM_AD | Video outstream ad. |
| VIDEO_TRUEVIEW_IN_STREAM_AD | Video TrueView in-stream ad. |
| VIDEO_RESPONSIVE_AD | Video responsive ad. |
| SMART_CAMPAIGN_AD | Smart campaign ad. |
| CALL_AD | Call ad. |
| APP_PRE_REGISTRATION_AD | Universal app pre-registration ad. |
| IN_FEED_VIDEO_AD | In-feed video ad. |
Dimension: Conversion Action Type (Conversion Name)
| EXPECTED RESULT | DESCRIPTION |
| UNSPECIFIED | Not specified. |
| UNKNOWN | Used for return value only. Represents value unknown in this version. |
| AD_CALL | Conversions that occur when a user clicks on an ad's call extension. |
| CLICK_TO_CALL |
Conversions that occur when a user on a mobile device clicks a phone number.
|
| GOOGLE_PLAY_DOWNLOAD |
Conversions that occur when a user downloads a mobile app from the Google Play Store.
|
| GOOGLE_PLAY_IN_APP_PURCHASE |
Conversions that occur when a user makes a purchase in an app through Android billing.
|
| UPLOAD_CALLS | Call conversions that are tracked by the advertiser and uploaded. |
| UPLOAD_CLICKS |
Conversions that are tracked by the advertiser and uploaded with attributed clicks.
|
| WEBPAGE | Conversions that occur on a webpage. |
| WEBSITE_CALL |
Conversions that occur when a user calls a dynamically-generated phone number from an advertiser's website.
|
| STORE_SALES_DIRECT_UPLOAD |
Store Sales conversion based on first-party or third-party merchant data uploads. Only customers on the allowlist can use store sales direct upload types.
|
| STORE_SALES |
Store Sales conversion based on first-party or third-party merchant data uploads and/or from in-store purchases using cards from payment networks. Only customers on the allowlist can use store sales types. Read only.
|
| FIREBASE_ANDROID_FIRST_OPEN | Android app first open conversions tracked via Firebase. |
| FIREBASE_ANDROID_IN_APP_PURCHASE | Android app in app purchase conversions tracked via Firebase. |
| FIREBASE_ANDROID_CUSTOM | Android app custom conversions tracked via Firebase. |
| FIREBASE_IOS_FIRST_OPEN | iOS app first open conversions tracked via Firebase. |
| FIREBASE_IOS_IN_APP_PURCHASE | iOS app in app purchase conversions tracked via Firebase. |
| FIREBASE_IOS_CUSTOM | iOS app custom conversions tracked via Firebase. |
| THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN | Android app first open conversions tracked via Third Party App Analytics. |
| THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Android app in app purchase conversions tracked via Third Party App Analytics.
|
| THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM | Android app custom conversions tracked via Third Party App Analytics. |
| THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN | iOS app first open conversions tracked via Third Party App Analytics. |
| THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
iOS app in app purchase conversions tracked via Third Party App Analytics.
|
| THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM | iOS app custom conversions tracked via Third Party App Analytics. |
| ANDROID_APP_PRE_REGISTRATION |
Conversions that occur when a user pre-registers a mobile app from the Google Play Store. Read only.
|
| ANDROID_INSTALLS_ALL_OTHER_APPS |
Conversions that track all Google Play downloads which aren't tracked by an app-specific type. Read only.
|
| FLOODLIGHT_ACTION |
Floodlight activity that counts the number of times that users have visited a particular webpage after seeing or clicking on one of an advertiser's ads. Read only.
|
| FLOODLIGHT_TRANSACTION |
Floodlight activity that tracks the number of sales made or the number of items purchased. Can also capture the total value of each sale. Read only.
|
| GOOGLE_HOSTED |
Conversions that track local actions from Google's products and services after interacting with an ad. Read only.
|
| LEAD_FORM_SUBMIT | Conversions reported when a user submits a lead form. Read only. |
| SALESFORCE | Conversions that come from Salesforce. Read only. |
| SEARCH_ADS_360 | Conversions imported from Search Ads 360 Floodlight data. Read only. |
| SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
Call conversions that occur on Smart campaign Ads without call tracking setup, using Smart campaign custom criteria. Read only.
|
| SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
The user clicks on a call element within Google Maps. Smart campaign only. Read only.
|
| SMART_CAMPAIGN_MAP_DIRECTIONS |
The user requests directions to a business location within Google Maps. Smart campaign only. Read only.
|
| SMART_CAMPAIGN_TRACKED_CALLS |
Call conversions that occur on Smart campaign Ads with call tracking setup, using Smart campaign custom criteria. Read only.
|
| STORE_VISITS |
Conversions that occur when a user visits an advertiser's retail store. Read only.
|
The following chart includes other known examples of formatting differences between Previous Text (Google Adwords API) and Current Text (new Google Ads API):
|
Name |
Previous Text |
Current Text |
|
Ad Group Name |
enabled |
ENABLED |
|
Ad group state |
paused |
PAUSED |
|
Ad group type |
Standard |
SEARCH_STANDARD |
|
Ad ID |
customers/8049649538/adGroups/111395918637 |
111395918637 |
|
Ad state |
paused |
PAUSED |
|
Ad state |
enabled |
ENABLED |
|
Ad Type |
Responsive search ad |
RESPONSIVE_SEARCH_AD |
|
Ad Type |
Expanded text ad |
EXPANDED_TEXT_AD |
|
Advertising Channel |
Search |
SEARCH |
|
Advertising sub channel |
-- |
null |
|
Age Range state |
removed |
REMOVED |
|
Auto tagging enabled |
true |
1 |
|
Base Ad Group ID |
customers/8049649538/adGroups/111395918637 |
111395918637 |
|
Base Campaign ID |
customers/8049649538/Campaigns/111395918637 |
111395918637 |
|
Bidding Strategy Type |
Target CPA |
TARGET_CPA |
|
Bidding Strategy Type |
Maximize Conversions |
MAXIMIZE_CONVERSIONS |
|
Bidding Strategy Type |
-- |
MANUAL_CPC |
|
Bidding Strategy Type |
-- |
TARGET_IMPRESSION_SHARE |
|
Budget - Campaign |
enabled |
ENABLED |
|
Budget Campaign state |
paused |
PAUSED |
|
Budget Campaign state |
enabled |
ENABLED |
|
Budget ID |
customers/8049649538/CampaignBudget/111395918637 |
111395918637 |
|
Budget Period |
day |
DAILY |
|
Budget State |
Enabled |
ENABLED |
|
Call Status |
Received |
RECEIVED |
|
Call Type |
Mobile click-to-call |
HIGH_END_MOBILE_SEARCH |
|
Campaign serving status |
eligible |
SERVING |
|
Campaign serving status |
ended |
ENDED |
|
Campaign State |
enabled |
ENABLED |
|
Campaign Trial Type |
base campaign |
BASE |
|
Can manage clients |
false |
null |
|
Click type |
sitelink |
SITELINKS |
|
Click type |
Headline |
URL_CLICKS |
|
Conversion Category |
Lead |
SUBMIT_LEAD_FORM |
|
Conversion Source |
Website |
WEBPAGE |
|
Conversion Tracker ID |
244435422 |
customers/8049649538/conversionActions/244435422 |
|
Criterion serving status |
eligible |
ELIGIBLE |
|
Delivery method |
Standard |
STAND |
|
Distance from location extensions |
Beyond 40 miles |
BEYOND_40MILES |
|
Enhanced CPC enabled |
false |
null |
|
Enhanced CPC enabled |
true |
null |
|
Expected clickthrough rate |
Below average |
BELOW_AVERAGE |
|
Expected clickthrough rate |
Average |
AVERAGE |
|
Expected clickthrough rate |
Above average |
ABOVE_AVERAGE |
|
Extension placeholder type |
numeric |
CALLOUT |
|
Extension placeholder type |
numeric |
IMAGE |
|
Extension placeholder type |
numeric |
SITELINK |
|
Extension placeholder type |
numeric |
STRUCTURED_SNIPPET |
|
Gender |
Male |
MALE |
|
Gender |
Undetermined |
UNDETERMINED |
|
Gender |
Female |
FEMALE |
|
Gender state |
removed |
REMOVED |
|
IsRestricting |
false |
[{"targetingDimension":"AUDIENCE","bidONLY":"true"},{"targetingDimension":"AGE_RANGE","bidOnly":"true"........ |
|
Keyword ID |
244435422 |
customers/8049649538/AdGroupCriteria/114377225751~244435422 |
|
Keyword Match Type |
Broad |
BROAD |
|
Keyword Match Type |
Exact |
EXACT |
|
Keyword State |
removed |
REMOVED |
|
Keyword State |
paused |
PAUSED |
|
Keyword State |
enabled |
ENABLED |
|
Max CPC Source |
ad groups |
AD_GROUP |
|
Network |
Search Partners |
Search_Partners |
|
Network |
Display |
Content |
|
Parental status |
Not a parent |
NOT-A-PARENT |
|
Parental status |
Parent |
PARENT |
|
Parental status |
Undetermined |
UNKNOWN |
|
Parental status state |
removed |
REMOVED |
|
Search Result Type |
Ads shown only |
ADS_ONLY |
|
Search Result Type |
Both shown |
ADS_AND_ORGANIC |
|
Target adgroup ID |
Organic shown only |
? |
|
Test account |
false |
null |
|
TimeZone |
(GMT -05:00) Eastern Time |
America/New York |
|
Top Vs. Other |
Google Search: Other |
SEARCH_OTHER |
|
Top Vs. Other |
Google search: Top |
SEARCH_TOP |
|
Top Vs. Other |
Search partners: Other |
SEARCH_PARTNER_OTHER |
|
Validation Details |
Approved |
VALID |
Comments
0 comments
Article is closed for comments.