Google has launched model 10.0 of the Google Adverts API. Take into accout, the AdWords API will sundown on April 27, 2022, which is arising quickly. So what’s new in model 10 of the Google Adverts API? Lots, together with good campaigns, efficiency max marketing campaign upgrades, native service advertisements adjustments and way more.
Google additionally added this new diff web page that exhibits the protos that have been added, eliminated, and altered within the newest Google Adverts API launch. You may click on the hyperlinks to view the protos in our GitHub repository after they’re launched. You may 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 varieties 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 assist for ad_group_ad_asset_combination_view for responsive search advertisements.
- Added assist 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 identify required.
- Added assist for auto-renaming the asset names on creation. If an asset exists with the identical identify however completely different content material, it’s renamed by appending the required identify with a timestamp and a counter.
- For the next asset varieties, if an asset with a unique identify having the identical content material already exists then the asset uploaded might be silently dropped. Picture, Media Bundle, Textual content, Name to Motion abd Ebook 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 assist for Viewers used to create a concentrating on based mostly on created dimensions, reminiscent of demographics or memberships in person lists and person 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 assist 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
- Sensible campaigns have exited open beta and entered basic availability.
- Added assist for Native Companies Adverts campaigns as open beta.
- They’ve AdvertisingChannelType as LOCAL_SERVICES.
- Added assist for retrieving these campaigns utilizing Search and SearchStream.
- Added assist for updating their standing and amount_micros of their . related CampaignBudget objects.
- Efficiency Max Campaigns now assist asset group alerts which advertisers can use to inform the marketing campaign who’s most definitely to transform.
- Added Marketing campaign.use_vehicle_inventory for Sensible 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 elective to assist setting the worth to false throughout create operations.
- Made ConversionValueRuleSet.attachment_type immutable.
- Added ConversionValueRuleSet.conversion_action_categories and ValueRuleSetDimension.NO_CONDITION to assist 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.
Resort Adverts
- Added hotel_reconciliation.marketing campaign and added assist for the next metrics: metrics.hotel_commission_rate_micros and metrics.hotel_expected_commission_cost
Suggestions
- Added assist for returning ResponsiveSearchAdAssetRecommendation.
- Added assist for returning UseBroadMatchKeywordRecommendation.
Reporting
- Mounted 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 identify 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 all the time be formatted based mostly on the time zone of the shopper specified as customer_id of SearchGoogleAdsRequest or SearchGoogleAdsStreamRequest. Beforehand, the returned date might differ based mostly on the time zone of the supervisor account laid out in login-customer-id.
- Added assist for metrics.absolute_top_impression_percentage and metrics.top_impression_percentage; in geographic_view and with segments.hour
- Added assist for the next segments for metrics.sk_ad_network_conversions (SKAdNetwork conversions), which is accessible 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 Sensible campaigns. We’re additionally documenting the required minimal performance for different developer instruments reminiscent of buying, resort and app campaigns, and simplifying normal buying campaigns to align with full service campaigns.
Discussion board dialogue at Twitter.