{"id":5627,"date":"2022-08-18T16:00:38","date_gmt":"2022-08-18T16:00:38","guid":{"rendered":"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/"},"modified":"2022-08-18T16:00:38","modified_gmt":"2022-08-18T16:00:38","slug":"google-releases-ads-api-version-11","status":"publish","type":"post","link":"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/","title":{"rendered":"Google releases Ads API version 11"},"content":{"rendered":"<p>Google has just released the newest version of the Ads API, version v11_1.\u00a0<\/p>\n<p><strong>What\u2019s changed. <\/strong>Here are the major changes according to Google\u2019s <a href=\"https:\/\/developers.google.com\/google-ads\/api\/docs\/release-notes\" target=\"_blank\" rel=\"noreferrer noopener\">release notes<\/a>.<\/p>\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_81 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Assets\" >Assets<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Audiences\" >Audiences<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Bidding\" >Bidding<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Campaigns\" >Campaigns<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Experiments\" >Experiments<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Planning\" >Planning<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/craighordlow.com\/index.php\/2022\/08\/18\/google-releases-ads-api-version-11\/#Recommendations\" >Recommendations<\/a><\/li><\/ul><\/nav><\/div>\n<h2><span class=\"ez-toc-section\" id=\"Assets\"><\/span>Assets<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/AssetGroup#ad_strength\" target=\"_blank\" rel=\"noreferrer noopener\"><code>AssetGroup.ad_strength<\/code><\/a>\u00a0to represent the overall quality of the asset group.\n<ul>\n<li>When advertisers mutate asset groups or assets associated with the asset groups, this field is recalculated. Until the recalculation is finished, the value is\u00a0<code>PENDING<\/code>.<\/li>\n<\/ul>\n<\/li>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/AssetLinkErrorEnum.AssetLinkError#excluded_parent_field_type\" target=\"_blank\" rel=\"noreferrer noopener\"><code>AssetLinkError.EXCLUDED_PARENT_FIELD_TYPE<\/code><\/a>.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Audiences\"><\/span>Audiences<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/FlexibleRuleUserListInfo\" target=\"_blank\" rel=\"noreferrer noopener\"><code>FlexibleRuleUserListInfo<\/code><\/a>\u00a0and\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/RuleBasedUserListInfo#flexible_rule_user_list\" target=\"_blank\" rel=\"noreferrer noopener\"><code>RuleBasedUserListInfo.flexible_rule_user_list<\/code><\/a>.<\/li>\n<li>Added more values to the\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/LeadFormFieldUserInputTypeEnum.LeadFormFieldUserInputType\" target=\"_blank\" rel=\"noreferrer noopener\"><code>LeadFormFieldUserInputType<\/code><\/a>\u00a0enum (used as predefined questions for lead form extensions).<\/li>\n<li>Added the following fields to\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/UserAttribute\" target=\"_blank\" rel=\"noreferrer noopener\"><code>UserAttribute<\/code><\/a>:\n<ul>\n<li><code>lifecycle_stage<\/code><\/li>\n<li><code>first_purchase_date_time<\/code><\/li>\n<li><code>event_attribute<\/code><\/li>\n<\/ul>\n<\/li>\n<li>Added the following errors to\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/OfflineUserDataJobErrorEnum.OfflineUserDataJobError\" target=\"_blank\" rel=\"noopener\"><code>OfflineUserDataJobError<\/code><\/a>:\n<ul>\n<li><code>FIRST_PURCHASE_TIME_GREATER_THAN_LAST_PURCHASE_TIME<\/code><\/li>\n<li><code>INVALID_LIFECYCLE_STAGE<\/code><\/li>\n<li><code>INVALID_EVENT_VALUE<\/code><\/li>\n<li><code>EVENT_ATTRIBUTE_ALL_FIELDS_ARE_REQUIRED<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Bidding\"><\/span>Bidding<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/Campaign#bidding_strategy_system_status\" target=\"_blank\" rel=\"noreferrer noopener\"><code>Campaign.bidding_strategy_system_status<\/code><\/a>\u00a0to show the system status of the bidding strategy, such as whether it is learning, limited, or misconfigured.\u00a0<a href=\"https:\/\/support.google.com\/google-ads\/answer\/6263057\" target=\"_blank\" rel=\"noreferrer noopener\">Learn more<\/a>.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Campaigns\"><\/span>Campaigns<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added support for the following metrics in the\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/fields\/v11\/campaign\" target=\"_blank\" rel=\"noopener\">campaign<\/a>\u00a0report:\n<ul>\n<li><code>all_conversions_from_click_to_call<\/code><\/li>\n<li><code>all_conversions_from_directions<\/code><\/li>\n<li><code>all_conversions_from_menu<\/code><\/li>\n<li><code>all_conversions_from_order<\/code><\/li>\n<li><code>all_conversions_from_other_engagement<\/code><\/li>\n<li><code>all_conversions_from_store_visit<\/code><\/li>\n<li><code>all_conversions_from_store_website<\/code><\/li>\n<\/ul>\n<\/li>\n<li>Made\u00a0<code>metrics.phone_call<\/code>\u00a0compatible with\u00a0<code>segments.hour<\/code>\u00a0in the\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/fields\/v11\/campaign\" target=\"_blank\" rel=\"noreferrer noopener\">campaign<\/a>\u00a0report.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Experiments\"><\/span>Experiments<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>You can now create\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/docs\/experiments\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">experiments<\/a>\u00a0using\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/GoogleAdsService#mutate\" target=\"_blank\" rel=\"noreferrer noopener\"><code>GoogleAdsService.Mutate()<\/code><\/a>. Previously, it was possible only when using<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/ExperimentService\" target=\"_blank\" rel=\"noreferrer noopener\"><code>ExperimentService<\/code><\/a>.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Planning\"><\/span>Planning<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/Targeting#audience_targeting\" target=\"_blank\" rel=\"noreferrer noopener\"><code>Targeting.audience_targeting<\/code><\/a>, which allows for specifying\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/data\/codes-formats\" target=\"_blank\" rel=\"noreferrer noopener\">affinity and in-market categories<\/a>\u00a0to generate a reach forecast using\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/ReachPlanService#generatereachforecast\" target=\"_blank\" rel=\"noreferrer noopener\"><code>ReachPlanService.GenerateReachForecast<\/code><\/a>.<\/li>\n<li>Added support for YouTube Select:\n<ul>\n<li>Added support for returning\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/YouTubeSelectLineUp\" target=\"_blank\" rel=\"noreferrer noopener\"><code>YouTubeSelectLineUp<\/code><\/a>\u00a0as product metadata when calling<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/ReachPlanService#listplannableproducts\" target=\"_blank\" rel=\"noreferrer noopener\"><code>ReachPlanService.ListPlannableProducts<\/code><\/a>.<\/li>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/PlannedProduct#advanced_product_targeting\" target=\"_blank\" rel=\"noreferrer noopener\"><code>PlannedProduct.advanced_product_targeting<\/code><\/a>, which allows for specifying<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/YouTubeSelectSettings\" target=\"_blank\" rel=\"noreferrer noopener\"><code>YouTubeSelectSettings<\/code><\/a>\u00a0to generate a reach forecast using\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/ReachPlanService#generatereachforecast\" target=\"_blank\" rel=\"noreferrer noopener\"><code>ReachPlanService.GenerateReachForecast<\/code><\/a>.<\/li>\n<\/ul>\n<\/li>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/AudienceInsightsService#generateaudiencecompositioninsights\" target=\"_blank\" rel=\"noreferrer noopener\"><code>AudienceInsightsService.GenerateAudienceCompositionInsights<\/code><\/a>\u00a0(available to allowlisted accounts only), used to find attributes strongly associated with a particular audience, similar to\u00a0<a href=\"https:\/\/support.google.com\/google-ads\/answer\/11161206\" target=\"_blank\" rel=\"noreferrer noopener\">Insights Finder<\/a>.<\/li>\n<\/ul>\n<h2><span class=\"ez-toc-section\" id=\"Recommendations\"><\/span>Recommendations<span class=\"ez-toc-section-end\"><\/span><\/h2>\n<ul>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/Recommendation.UpgradeLocalCampaignToPerformanceMaxRecommendation\" target=\"_blank\" rel=\"noreferrer noopener\"><code>UpgradeLocalCampaignToPerformanceMaxRecommendation<\/code><\/a>.\u00a0<a href=\"https:\/\/ads-developers.googleblog.com\/2022\/07\/performance-max-upgrade-has-started.html\" target=\"_blank\" rel=\"noopener\">Learn more<\/a>.<\/li>\n<li>Added\u00a0<a href=\"https:\/\/developers.google.com\/google-ads\/api\/reference\/rpc\/v11\/Recommendation.DisplayExpansionOptInRecommendation\" target=\"_blank\" rel=\"noreferrer noopener\"><code>DisplayExpansionOptInRecommendation<\/code><\/a>.<\/li>\n<\/ul>\n<hr class=\"wp-block-separator has-text-color has-background has-cyan-bluish-gray-background-color has-cyan-bluish-gray-color\">\n<p><!-- START INLINE FORM --><\/p>\n<div class=\"nl-inline-form border py-2 px-1 my-2\">\n<div class=\"row align-items-center\">\n<div class=\"col-12 col-lg-3 col-xl-4 pe-md-0 pb-2 pb-lg-0\">\n<p class=\"inline-form-text text-center mb-0\">Get the daily newsletter search marketers rely on.<\/p>\n<\/p><\/div>\n<div class=\"col-12 col-lg-7 col-xl-6  pe-lg-0\">\n<div class=\"form-nl-inline\">\n<div class=\"row g-0\">\n<div class=\"form-group col-12 col-lg-8 mb-0\"><\/div>\n<div class=\"col-12 col-lg-4 col-xl-4 mb-0\">\n<div class=\"d-none\">\n<p>Processing&#8230;Please wait.<\/p>\n<\/div>\n<p>\t\t\t\t\t\t\t<button class=\"btn btn-dark inlineButton w-100 rounded-0 font-weight-bold\" type=\"submit\" name=\"submit_button\">SUBSCRIBE<\/button>\n\t\t\t\t\t\t<\/div>\n<\/p><\/div>\n<\/p><\/div>\n<\/p><\/div>\n<div class=\"col-12 col-lg-2 col-xl-2 ps-1\">\n<p class=\"text-center mb-0\"><a class=\"nl-terms\" href=\"https:\/\/searchengineland.com\/termsofuse\" target=\"_blank\" rel=\"noopener noreferrer\">See terms.<\/a><\/p>\n<\/p><\/div>\n<\/p><\/div>\n<\/div>\n<p><!-- END INLINE FORM --><\/p>\n<hr class=\"wp-block-separator has-text-color has-background has-cyan-bluish-gray-background-color has-cyan-bluish-gray-color\">\n<p><strong>What is the Google API. <\/strong>The Google API allows developers to interact directly with the ads platform, making large or robust accounts and campaigns easier to manage. With the ads API, you can:<\/p>\n<ul>\n<li>Automate account management<\/li>\n<li>Create custom reports<\/li>\n<li>Manage inventory<\/li>\n<li>Manage smart bidding strategies<\/li>\n<\/ul>\n<p><strong>Why we care.<\/strong> Developers who use the Google Ads API should make note of the new updates and plan management of their accounts accordingly. <\/p>\n<p>The post <a rel=\"nofollow noopener\" href=\"https:\/\/searchengineland.com\/google-releases-ads-api-version-11-387286\" target=\"_blank\">Google releases Ads API version 11<\/a> appeared first on <a rel=\"nofollow noopener\" href=\"https:\/\/searchengineland.com\/\" target=\"_blank\">Search Engine Land<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Google has just released the newest version of the Ads API, version v11_1.\u00a0 What\u2019s changed. Here are the major changes according to Google\u2019s release notes. Assets Added\u00a0AssetGroup.ad_strength\u00a0to represent the overall quality of the asset group. When advertisers mutate asset groups or assets associated with the asset groups, this field is recalculated. Until the recalculation is finished, the value is\u00a0PENDING. Added\u00a0AssetLinkError.EXCLUDED_PARENT_FIELD_TYPE. Audiences Added\u00a0FlexibleRuleUserListInfo\u00a0and\u00a0RuleBasedUserListInfo.flexible_rule_user_list. Added more values to the\u00a0LeadFormFieldUserInputType\u00a0enum (used as predefined questions for lead form extensions). Added the following fields to\u00a0UserAttribute: lifecycle_stage first_purchase_date_time event_attribute Added the following [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"h5ap_radio_sources":[],"cybocfi_hide_featured_image":"","footnotes":""},"categories":[1],"tags":[],"class_list":["post-5627","post","type-post","status-publish","format-standard","hentry","category-best-seo-blogs"],"featured_image_src":null,"featured_image_src_square":null,"author_info":{"display_name":false,"author_link":"https:\/\/craighordlow.com\/author\/"},"_links":{"self":[{"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/posts\/5627","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/comments?post=5627"}],"version-history":[{"count":0,"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/posts\/5627\/revisions"}],"wp:attachment":[{"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/media?parent=5627"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/categories?post=5627"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/craighordlow.com\/index.php\/wp-json\/wp\/v2\/tags?post=5627"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}