Google Ads API Version 8.0 Now Available

Jun 10, 2021 - 8:01 am 0 by
Filed Under Google Ads

Google Ads Api

Google has released version 8.0 of the Google Ads API that includes a ton of new features including cross-account bidding strategies, label retrieval, CallAdInfo support, cart data support for conversions, smart campaign support and much more.

Version 7.0 of the Google Ads API was released on April 28, 2021, only 6 weeks ago. Google even released a highlight video of what is new in version 8 of the Google Ads API:

Here is everything new in version 8.0:

Account Management

  • Added CustomerClient.applied_labels to show the labels applied to customers managed by the requesting manager customer.
  • CallOnlyAdInfo is replaced with CallAdInfo.
  • Set response_content_type to MUTABLE_RESOURCE as a request parameter to return all the fields mutated in a mutate request for CustomerAssetService, CampaignAssetService and AdGroupAssetService.
  • Added support for the following metrics for CustomerAsset, CampaignAsset and AdGroupAsset: absolute_top_impression_percentage, all_conversions, all_conversions_from_interactions_rate, all_conversions_value, average_cost, average_cpc, average_cpe, average_cpm, average_cpv, clicks, conversions, conversions_from_interactions_rate, conversions_value, cost_micros, cost_per_all_conversions, cost_per_conversion, cross_device_conversions, ctr, engagement_rate, engagements, interactions, interaction_event_types, interaction_rate, impressions, top_impression_percentage, value_per_all_conversions, value_per_conversion, video_view_rate, video_views
  • Added segments.asset_interaction_target for CustomerAsset, CampaignAsset and AdGroupAsset to indicate if the interactions are on the asset itself.
  • Added AssetFieldTypeViewService to support retrieving metrics for each asset field type when the asset is used as extension.
  • Updated the following values of LeadFormFieldUserInputType: Replaced GIVEN_NAME with FIRST_NAME and Replaced FAMILY_NAME with LAST_NAME.
  • Asset-based extensions: SitelinkAsset, CalloutAsset, StructuredSnippetAsset, which were available for test accounts in v7, will be enabled for production accounts two weeks after this release.
  • Added TransactionAttribute.item_attribute to support associate information about a sold item with a transaction.
  • Added the following fields to UserAttribute: last_purchase_date_time, average_purchase_count, average_purchase_value_micros, acquisition_date_time
  • Added the following values to OfflineUserDataJobError: FUTURE_TIME_NOT_ALLOWED and LAST_PURCHASE_TIME_LESS_THAN_ACQUISITION_TIME
  • Updated Maximize_conversion_value.target_roas to support an optional Target ROAS setting on the Maximize Conversion Value portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Updated Maximize_conversions.target_cpa to support an optional Target CPA setting on the Maximize Conversions portfolio and standard bidding strategies for Search campaigns. This field will become mutable for all customers at a future date. We will post a notification on the Google Ads Developer blog when developers can update this field.
  • Added support for [creating and managing cross-account bidding strategies]/google-ads/api/docs/campaigns/bidding/cross-account-strategies) in manager accounts, and the ability to attach them to campaigns in customer accounts:
    • Added BiddingStrategy.currency_code for bidding strategies in manager customers, which can be set on creation and defaults to the manager customer's currency. For serving customers, this field cannot be set; all strategies in a serving customer implicitly use the serving customer's currency. In all cases the effective_currency_code field returns the currency used by the strategy.
    • Added AccessibleBiddingStrategy to represent a view of all BiddingStrategies owned by and shared with the customer.
    • Added AccessibleBiddingStrategyService to read accessible bidding strategies.
    • Added Campaign.accessible_bidding_strategy for retrieving the fields of the portfolio bidding strategy identified by bidding_strategy.When a campaign uses a cross-account bidding strategy, this will be a subset of the properties normally defined for a bidding strategy, since certain properties are only accessible by a bidding strategy’s owner.
    Replaced CampaignError.PAYMENT_MODE_NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION with CampaignError.NOT_COMPATIBLE_WITH_VIEW_THROUGH_CONVERSION_OPTIMIZATION. Reports incompatibilities with view through conversions setup.
  • Added support for Smart campaigns:
    • Added new enum values to support Smart campaigns: BudgetTypeEnum.SMART_CAMPAIGN AdGroupTypeEnum.SMART_CAMPAIGN_ADS and Added SmartCampaignSetting and SmartCampaignSettingService to configure Smart campaigns.
    • Added KeywordThemeConstantService and SmartCampaignSuggestService to retrieve suggestions for Smart campaign budgets and keyword themes.
    • Added smart_campaign_search_term_view to retrieve performance metrics for Smart campaigns.
  • Added ClickConversion.cart_data to support uploading conversions with shopping cart information.
  • Added DetailedDemographicService to retrieve UserInterest with DetailedDemographic as the TaxonomyType.
  • Added support for the following fields for Customer and Campaign resources. segments.recommendation_type, metrics.optimization_score_url and metrics.optimization_score_uplift

Forum discussion at Twitter.


Popular Categories

The Pulse of the search community


Search Video Recaps

Google Spam Update, Volatility & Indexing Bug, AI Overviews, Google Maps Exploit, Ads, Applebot - YouTube
Video Details More Videos Subscribe to Videos

Most Recent Articles

Search Forum Recap

Daily Search Forum Recap: June 21, 2024

Jun 21, 2024 - 10:00 am
Search Video Recaps

Search News Buzz Video Recap: Google Spam Update, Volatility & Indexing Bug, AI Overviews Tracking & FAQs, Google Maps Exploit, Google Ads, AppleBot & More

Jun 21, 2024 - 8:01 am
Google Updates

Google June 2024 Spam Update Takes Target

Jun 21, 2024 - 7:51 am
Google Search Engine Optimization

Google Search Images Go Missing? Might Be A Quality Issue.

Jun 21, 2024 - 7:41 am

Google Posts Safe Search FAQs

Jun 21, 2024 - 7:31 am

Google Tests Floating Search Bar In Google Discover

Jun 21, 2024 - 7:21 am
Previous Story: Google 2021 Search Central Unconference On June 21st