Announcing v15 of the Google Ads API

Today, we’re announcing the v15 release of the Google Ads API. To use some of the v15 features, you will need to upgrade your client libraries and client code. The updated client libraries and code examples will be published next week.

Here are the highlights:

• Added RecommendationSubscriptionService which manages recommendation subscriptions and lets you automatically apply the recommendations.
• Added new recommendation types: FORECASTING_SET_TARGET_CPA, SET_TARGET_CPA, SET_TARGET_ROAS.
• Updates to Performance Max:
  • Added AssetGroupSignal.search_theme which lets you attach a search theme to asset groups for enhanced targeting.
  • Added a new asset_group_top_combination_view to report the top performing assets at the asset group level.
  • asset_group can now be queried with metric fields to support retrieving the performance of an asset group of a Performance Max campaign.
• Added UserList.lookalike_user_list to support creating a Lookalike segment, an audience created based on the provided existing seed audience. Lookalike segments can be used in a Demand Gen campaign only.
• Added support of reporting for Apple's SkAdNetwork 4 conversions, including web to app conversions on Google search. You can now segment by coarse conversion value, source domain, and postback sequence index.
• Improved offline conversion upload diagnostics in the offline_conversion_upload_client_summary report, with more useful details of the conversion upload status such as successful events, success rate, error percentage.
• Added support of sales and profit metrics such as revenue, gross profit, gross profit margin, and units sold. These metrics are available to all advertisers who implement conversions with cart data across Search, Shopping, and Performance Max campaigns.
• Added LocalServicesSettings and its fields to the customer report for returning a Local Services advertiser’s granular license and insurance statuses. We also added new reports for Local Services ads including local_services_lead, local_services_lead_conversation, and local_services_verification_artifact.
• Changes to linking accounts:
  • Added support for adding and removing a link between a Google Ads account and a Merchant Center account using ProductLink.merchant_center and removed MerchantCenterLinkService.
  • Added ProductLinkInvitationService to support updating a link invitation sent from other products, available for Hotel Center and Merchant Center accounts.
    • Removed AccountLink.hotel_center and support for updating link invitations from Hotel Center accounts via AccountLinkService.
• Changes to Shopping campaigns:
  • Removed ShoppingSetting.sales_country, whose values are now returned as ShoppingSetting.feed_label.
  • Removed support for adding Campaign.shopping_setting to Search campaigns.
  • Removed support for adding CampaignCriterion.listing_scope to Search campaigns.
• Added support for targeting Google TV and YouTube at the campaign level using NetworkSettings.
• Added CustomerLifecycleService.ConfigureCustomerLifecycleGoals and CampaignLifecycleService.ConfigureCampaignLifecycleGoals for configuring customer acquisition goals at the customer and campaign levels, respectively.
• Added consent to the below classes. No action is required at this time, but please follow our blog for updates in the coming months.
  • UserData
  • CustomerMatchUserListMetadata
  • CallConversion
  • ClickConversion
• Added BrandSuggestionService which can suggest brands based on the provided brand prefix and the excluded list of brands. These brands can be used to create a BRAND criterion, added to a BRANDS shared set, and then attached to a campaign by creating a CampaignCriterion with brand_list set to the shared set. These campaign criteria must have their negative field set to false in Search campaigns and true in Performance Max campaigns.

Where can I learn more?
The following resources can help you get started:

• Release Notes
• Guides
• Reference
• Diff between v14 and v15

If you have any questions or need additional help, contact us through the forum.
 - Thanet Knack Praneenararat, on behalf of the Google Ads API Team