Google Advertisements has released an replace it the Google Advertisements API, version 18. Model 18 contains updates throughout account administration, advert teams, advertisements, belongings, campaigns, resort/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 crew 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 utterly 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 advertisements 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 function that was beforehand solely supported for Demand Gen.
Advertisements:
- Added AdGroupAd.ad_group_ad_asset_automation_settings, which permits opting advertisements 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 advertisements that serve on Google-owned channels corresponding to YouTube, Gmail, and the Uncover feed.
Belongings:
- 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 objectives 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, corresponding to key phrases, placements and matters, for Show, Demand Gen and Video campaigns.
Lodge & 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 studies to permit for segmenting efficiency knowledge primarily based on particular locations (cities, international locations and areas) for Lodge and Search campaigns:
- segments.travel_destination_city
- segments.travel_destination_country
- segments.travel_destination_region
Native Providers:
- PhoneCallDetails.call_recording_url shall be empty, as an alternative of offering an invalid URL if the decision recording would not exist for the given Native Providers 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 tips
- Added Marketing campaign.brand_guidelines_enabled which reveals whether or not model tips are enabled for a given Efficiency Max marketing campaign. If enabled, belongings with field_type set to BUSINESS_NAME, LOGO, LANDSCAPE_LOGO should 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 tips enabled do not have the required CampaignAsset sources linked to the marketing campaign.
- When model tips are enabled, no less than one asset with field_type set to BUSINESS_NAME and no less than one with LOGO should 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 belongings 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 belongings to campaigns as CampaignAsset sources as an alternative of AssetGroupAsset sources in Efficiency Max campaigns with model tips not enabled.
- BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL error, which is thrown when trying to hyperlink model belongings to campaigns as AssetGroupAsset sources as an alternative of CampaignAsset sources in Efficiency Max campaigns with model tips enabled.
- Added performance_max_placement_view which returns impressions of the placements the place Efficiency Max advertisements served.
- Added AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION
Planning:
- (For allowlisted accounts solely) Added a brand new service with the strategy ContentCreatorInsightsService.GenerateCreatorInsights, which permits customers to discover insights about prime YouTube Creators. This permits clients to seek for creators given an viewers concentrating on and content material concentrating on mixture or creator insights given a listing of YouTube Channel IDs.
- Updates to AudienceInsightsService.GenerateSuggestedTargetingInsights:
- Moved viewers, baseline_audience and data_month into audience_definition.
- Added audience_description to generate concentrating on solutions from a free kind textual content description utilizing Gen AI.
- Added AudienceInsightsService.GenerateTargetingSuggestionMetrics which returns potential attain metrics for given viewers concentrating on combos.
Suggestions:
- RecommendationService.GenerateRecommendations can now be used to generate suggestions about optimized price range solutions throughout marketing campaign development, by together with the CAMPAIGN_BUDGET suggestion 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 discipline, 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, corresponding 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 of us.
Discussion board dialogue at X.