Google Advertisements has released an replace it the Google Advertisements API, version 18. Model 18 contains updates throughout account administration, advert teams, adverts, property, campaigns, lodge/journey, native, PMax, reporting and extra. This can be a main launch replace of the Google Advertisements API.
Here’s a video from the Google Advertisements API group on some highlights on what’s new:
Earlier than this launch was model 17.1 in August after which earlier than that was version 17.0 in June 2024 after which earlier than that was version 16.1 after which Version 16 in February 2024. Earlier than that was model 15 again in October 2023. Then earlier than that was version 14.1 which was launched in August. Version 13.1 preceded this new model, which was launched in April 2023. Version 12.0 was launched in October 2022, Version 11.0 of the Google Advertisements API was launched in June, and version 11.1 was in August. Additionally Version 10.1 was launched on April 27, 2022 and version 10.0 was launched on February 9, 2022. And Google has sunset the AdWords API on April twenty seventh which is able to fully cease working on the end of July.
Right here is the full change log:
Account Administration:
- (For allowlisted accounts solely) Added DataLinkService.CreateDataLink, which permits linking a Google Advertisements account to creator movies hosted on the creator’s YouTube channel. Video linking permits the Google Advertisements account to run partnership adverts utilizing creator movies.
Advert Teams:
- Added AdGroup.exclude_demographic_expansion which helps you to exclude demographics from being expanded when optimized_targeting_enabled is true, a characteristic that was beforehand solely supported for Demand Gen.
Advertisements:
- Added AdGroupAd.ad_group_ad_asset_automation_settings, which permits opting adverts into or out of automated asset era.
- Added the next values to AssetAutomationType:
- GENERATE_VERTICAL_YOUTUBE_VIDEOS
- GENERATE_SHORTER_YOUTUBE_VIDEOS
- Added AdNetworkType.GOOGLE_OWNED_CHANNELS, which is utilized by adverts that serve on Google-owned channels comparable to YouTube, Gmail, and the Uncover feed.
Property:
- Renamed AssetType.DISCOVERY_CAROUSEL_CARD to AssetType.DEMAND_GEN_CAROUSEL_CARD.
Campaigns:
- Added metrics.store_visits_last_click_model_attributed_conversions, which returns the variety of retailer visits attributed by the final click on mannequin of a marketing campaign.
- Added the next video view-related metrics for a marketing campaign:
- metrics.video_view_rate_in_feed
- metrics.video_view_rate_in_stream
- metrics.video_view_rate_shorts
- Added metrics.results_conversions_purchase, which returns conversion purchases for the unified targets outcomes of a marketing campaign.
- Modified the default worth of DemandGenCampaignSettings.upgraded_targeting from false to true.
Criterion:
- Added content_criterion_view which returns efficiency metrics of focused contents, comparable to key phrases, placements and subjects, for Show, Demand Gen and Video campaigns.
Resort & Journey:
- Assist for Journey Feeds in Search Advertisements
- Added ClickType.TRAVEL_ASSETS to permit segmentation of metrics of Journey Feeds in Search Advertisements.
- Added AssetSetType.TRAVEL_FEED which can be utilized to opt-in and opt-out of utilizing Journey Feed in Search Advertisements.
- (For allowlisted accounts solely) Added journey itinerary as a brand new conversion worth rule with the next new fields and values:
- ConversionValueRule.itinerary_condition with ValueRuleItineraryCondition, which permits for specifying an advance reserving window, an itinerary size, and a journey begin days of week
- ConversionValueRulePrimaryDimensionEnum.ITINERARY
- ValueRuleSetDimension.ITINERARY
- Added the next segments for marketing campaign and ad_group reviews to permit for segmenting efficiency information based mostly on particular locations (cities, nations and areas) for Resort and Search campaigns:
- segments.travel_destination_city
- segments.travel_destination_country
- segments.travel_destination_region
Native Companies:
- PhoneCallDetails.call_recording_url will probably be empty, as an alternative of offering an invalid URL if the decision recording does not exist for the given Native Companies lead dialog.
- Added CategoryBid.target_cpa_bid_micro which permits for setting goal CPA for a class by Marketing campaign.local_services_campaign_settings.
Efficiency Max:
- PSupport for model pointers
- Added Marketing campaign.brand_guidelines_enabled which exhibits whether or not model pointers are enabled for a given Efficiency Max marketing campaign. If enabled, property with field_type set to BUSINESS_NAME, LOGO, LANDSCAPE_LOGO have to be linked as CampaignAsset sources as an alternative of AssetGroupAsset sources.
- Added CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED and CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED errors, which point out that Efficiency Max campaigns with model pointers enabled haven’t got the required CampaignAsset sources linked to the marketing campaign.
- When model pointers are enabled, at the very least one asset with field_type set to BUSINESS_NAME and at the very least one with LOGO have to be linked to the marketing campaign as CampaignAsset sources. Efficiency Max campaigns for on-line gross sales with a product feed should meet this requirement solely when there are property which can be linked to the marketing campaign’s asset teams.
- Added the next values to AssetLinkError:
- BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, which is thrown when trying to hyperlink model property to campaigns as CampaignAsset sources as an alternative of AssetGroupAsset sources in Efficiency Max campaigns with model pointers not enabled.
- BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL error, which is thrown when trying to hyperlink model property to campaigns as AssetGroupAsset sources as an alternative of CampaignAsset sources in Efficiency Max campaigns with model pointers enabled.
- Added performance_max_placement_view which returns impressions of the placements the place Efficiency Max adverts served.
- Added AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION
Planning:
- (For allowlisted accounts solely) Added a brand new service with the tactic ContentCreatorInsightsService.GenerateCreatorInsights, which permits customers to discover insights about prime YouTube Creators. This enables clients to seek for creators given an viewers focusing on and content material focusing on mixture or creator insights given an inventory of YouTube Channel IDs.
- Updates to AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Moved viewers, baseline_audience and data_month into audience_definition.
- Added audience_description to generate focusing on options from a free kind textual content description utilizing Gen AI.
- Added AudienceInsightsService.GenerateTargetingSuggestionMetrics which returns potential attain metrics for given viewers focusing on combos.
Suggestions:
- RecommendationService.GenerateRecommendations can now be used to generate suggestions about optimized finances options throughout marketing campaign development, by together with the CAMPAIGN_BUDGET advice sort in GenerateRecommendationsRequest.recommendation_types[]. This works for Efficiency Max and Search campaigns.
Reporting:
- Changed the summary_row_setting and return_total_results_count fields of SearchGoogleAdsRequest with the search_settings subject, whose sort is SearchSettings with the next fields:
- omit_results
- return_summary_row
- return_total_results_count
- Added the next new metrics about common invalid clicks, comparable to these generated by bots or crawlers, these having irregular patterns. They are often queried with the marketing campaign report.
- metrics.general_invalid_clicks
- metrics.general_invalid_click_rate
- Added the next values to QuotaError:
- EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
- EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
That’s all people.
Discussion board dialogue at X.