Google has launched model 10.0 of the Google Adverts API. Consider, the AdWords API will sundown on April 27, 2022, which is developing quickly. So what’s new in model 10 of the Google Adverts API? Rather a lot, together with sensible campaigns, efficiency max marketing campaign upgrades, native service advertisements adjustments and far more.

Google additionally added this new diff web page that reveals the protos that have been added, eliminated, and adjusted within the newest Google Adverts API launch. You’ll be able to click on the hyperlinks to view the protos in our GitHub repository after they’re launched. You’ll be able to view fast and full-context diffs within the Modified tab.

Google has a brief video of the larger adjustments within the model 10.0 launch of the Google Adverts API:

Account Administration

• Added Buyer.standing and CustomerClient.standing, whose sort is CustomerStatus to indicate the standing of the account.
• Now you can retrieve all kinds of accounts when utilizing CustomerService.ListAccessibleCustomers, GoogleAdsService.Search and GoogleAdsService.SearchStream. Beforehand, they returned solely ENABLED accounts and check accounts.

Adverts

• Renamed Video TrueView Discovery Advert format to In-Feed Video Advert:
• VideoTrueViewDiscoveryAdInfo is renamed to InFeedVideoAdInfo.
• AdType.VIDEO_TRUEVIEW_DISCOVERY_AD is renamed to AdType.IN_FEED_VIDEO_AD.
• Renamed MutateOperation.customizer_customizer_operation to MutateOperation.customer_customizer_operation.

Property

• Added help for ad_group_ad_asset_combination_view for responsive search advertisements.
• Added help for reporting the efficiency of App pre registration advertisements in ad_group_ad_asset_view.
• For Picture and Media Bundle property (Asset that has image_asset and media_bundle_asset set, respectively):
• Made title required.
• Added help for auto-renaming the asset names on creation. If an asset exists with the identical title however completely different content material, it’s renamed by appending the required title with a timestamp and a counter.
• For the next asset sorts, if an asset with a distinct title having the identical content material already exists then the asset uploaded shall be silently dropped. Picture, Media Bundle, Textual content, Name to Motion abd E-book on Google
• Added the next values associated to asset units to ResourceLimitType: PAGE_FEED_ASSET_SETS_PER_CUSTOMER, DYNAMIC_EDUCATION_FEED_ASSET_SETS_PER_CUSTOMER, ASSET_PER_PAGE_FEED_ASSET_SET, ASSET_PER_DYNAMIC_EDUCATION_FEED_ASSET_SET
• Added the next values to AssetError: MOBILE_APP_INVALID_APP_ID, MOBILE_APP_INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL, NAME_REQUIRED_FOR_ASSET_TYPE

Audiences

• Added help for Viewers used to create a concentrating on based mostly on created dimensions, comparable to demographics or memberships in consumer lists and consumer pursuits:
• Useful resource: Viewers
• Service: AudienceService
• Fields in different assets: GoogleAdsRow.viewers, Marketing campaign.audience_setting, AdGroup.audience_setting, AdGroupCriterion.viewers
• Enums: AudienceError and CriterionType.AUDIENCE

Bidding

• Eliminated help for creating seasonality changes on supervisor accounts.
• Added the next values to BiddingError: BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ATTACHED_TO_THE_SAME_CAMPAIGNS_TO_ALIGN, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_REMOVED_TOGETHER

Campaigns

• Good campaigns have exited open beta and entered normal availability.
• Added help for Native Providers Adverts campaigns as open beta.
• They’ve AdvertisingChannelType as LOCAL_SERVICES.
• Added help for retrieving these campaigns utilizing Search and SearchStream.
• Added help for updating their standing and amount_micros of their . related CampaignBudget objects.
• Efficiency Max Campaigns now help asset group indicators which advertisers can use to inform the marketing campaign who’s almost definitely to transform.
• Added Marketing campaign.use_vehicle_inventory for Good Buying campaigns.

Conversions

• Added the next fields to the conversion_tracking_setting attribute of Buyer:
• conversion_tracking_status signifies whether or not the shopper is utilizing conversion monitoring, and who’s the conversion monitoring proprietor.
• accepted_customer_data_terms signifies if the conversion monitoring proprietor has accepted the shopper knowledge phrases.
• enhanced_conversions_for_leads_enabled signifies if the shopper has opted into enhanced conversions for leads.
• Made ConversionAction.primary_for_goal optionally available to help setting the worth to false throughout create operations.
• Made ConversionValueRuleSet.attachment_type immutable.
• Added ConversionValueRuleSet.conversion_action_categories and ValueRuleSetDimension.NO_CONDITION to help conversion worth guidelines for retailer visits and retailer gross sales.
• Added the next values to ConversionValueRuleSetError: INELIGIBLE_CONVERSION_ACTION_CATEGORIES, DIMENSION_NO_CONDITION_USED_WITH_OTHER_DIMENSIONS, DIMENSION_NO_CONDITION_NOT_ALLOWED
• Eliminated LEAD from the ConversionActionCategory enum and changed with the next new values: QUALIFIED_LEAD and CONVERTED_LEAD
• Added ExternalConversionSource.DISPLAY_AND_VIDEO_360_FLOODLIGHT.

Experiments

• Added a brand new ExperimentService with a set of recent assets, which is a substitute for marketing campaign experiments.

Lodge Adverts

• Added hotel_reconciliation.marketing campaign and added help for the next metrics: metrics.hotel_commission_rate_micros and metrics.hotel_expected_commission_cost

Suggestions

• Added help for returning ResponsiveSearchAdAssetRecommendation.
• Added help for returning UseBroadMatchKeywordRecommendation.

Reporting

• Fastened inconsistencies the place rows with zero metrics have been returned when segments have been chosen in some stories. All stories will now comply with the anticipated habits of ignoring zero-metric rows in stories that choose metrics and segments.
• Added a brand new meta parameter omit_unselected_resource_names. When set to true, the response from GoogleAdsService will solely return useful resource title fields that you simply explicitly request within the SELECT clause of your question.
• When retrieving Marketing campaign.start_date and Marketing campaign.end_date, the date returned will at all times be formatted based mostly on the time zone of the shopper specified as customer_id of SearchGoogleAdsRequest or SearchGoogleAdsStreamRequest. Beforehand, the returned date may range based mostly on the time zone of the supervisor account laid out in login-customer-id.
• Added help for metrics.absolute_top_impression_percentage and metrics.top_impression_percentage; in geographic_view and with segments.hour
• Added help for the next segments for metrics.sk_ad_network_conversions (SKAdNetwork conversions), which is offered when fetching the info of buyer or marketing campaign: segments.sk_ad_network_user_type, segments.sk_ad_network_ad_event_type, segments.sk_ad_network_source_app.sk_ad_network_source_app_id
• Added metrics.biddable_app_install_conversions and metrics.biddable_app_post_install_conversions.

RMF

• Added new necessities for Efficiency Max and Good campaigns. We’re additionally documenting the required minimal performance for different developer instruments comparable to procuring, resort and app campaigns, and simplifying normal procuring campaigns to align with full service campaigns.

Discussion board dialogue at Twitter.