SEARCHENGINES

Google Ads API Version 12.0 Now Out

Published

1 year ago

October 28, 2022

Google has released version 12.0 of the Google Ads API. Version 11.0 of the Google Ads API was released in June, and version 11.1 was in August. Version 12.0 is a major update.

Also Version 10.1 was released on April 27, 2022 and version 10.0 was released on February 9, 2022. And Google has sunset the AdWords API on April 27th which will completely stop working at the end of July.

Google published a video of the mahor changes in 12.0:

Here is everything announced in version 12.0:

Account Management

Added a new account link type, ADVERTISING_PARTNER for linking a customer account to another one. This is preparation for an upcoming feature in a following release.

Added AccountLinkError.PERMISSION_DENIED for the case where a non-admin user tries to create an account link.

Ads

Removed support for creating a new Gmail ad. Use Discovery campaigns instead.

Assets

Added support for retrieving CustomLeadFormSubmissionField through LeadFormSubmissionData using GoogleAdsService.SearchStream or GoogleAdsService.Search.

Added support for adding, updating, and removing CampaignAsset and AdGroupAsset with the field_type as AD_IMAGE (for allowlisted customers only).

You can retrieve stats for Image assets (asset_field_type_view.field_type = AD_IMAGE) using the asset_field_type_view report.

The asset_set_asset report now supports metrics and segments.

Added ad_group_ad_asset_view.pinned_field to allow filtering by a pinned asset.

Added support for segment.conversion_action to the ad_group_ad_asset_view report.

Added support for linking customers and ad groups with asset sets for test accounts only.

CustomerAssetSetService for adding/updating/removing CustomerAssetSet, which represents a link between a Customer and an AssetSet.

AdGroupAssetSetService for adding/updating/removing AdGroupAssetSet, which represents a link between an AdGroup and an AssetSet.

Added support for mutating and fetching location assets for test accounts only.

Fields:

Added Asset.location_asset whose type is LocationAsset.

Added the following fields to AssetSet:

location_group_parent_asset_set_id

asset_set_source (oneof field)

location_set (use with CustomerAssetSet)

business_profile_location_group (use with CampaignAssetSet and AdGroupAssetSet)

chain_location_group (use with CampaignAssetSet and AdGroupAssetSet)

Added excluded_parent_asset_set_types to Campaign and AdGroup.

Enums:

Added AssetType.LOCATION.

Added the following values to AssetSetType:

LOCATION_SYNC

BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP

CHAIN_DYNAMIC_LOCATION_GROUP

STATIC_LOCATION_GROUP

Reports (available for all accounts):

per_store_view returns stats at the place ID level.

asset_set_type_view returns stats at the AssetSetType level, which currently only supports location asset set.

Audiences

Added the following values to OfflineUserDataJobFailureReason: HIGH_AVERAGE_TRANSACTION_VALUE, LOW_AVERAGE_TRANSACTION_VALUE, NEWLY_OBSERVED_CURRENCY_CODE

Bidding

Added support for linked portfolio bidding strategies and campaign budget. Bidding strategies and campaign budgets can modify these links using bulk mutates:

BiddingStrategy.aligned_campaign_budget_id

CampaignBudget.aligned_bidding_strategy_id

Billing

Added AccountSummary as Invoice.account_summaries[] for reporting reconciliation (for allowlisted customers only).

Added BillingSetupError.TOO_MANY_BILLING_SETUPS_FOR_PAYMENTS_ACCOUNT.

Added AccountBudgetProposalError.INVALID_MASTER_SERVICE_AGREEMENT.

Campaigns

Changes in Smart campaigns:

Updated SmartCampaignSuggestService.SuggestKeywordThemes to generate more keyword theme suggestions for Smart campaigns and can suggest free-form keyword themes in some cases.

Improved error handling and added more user-facing error codes for SmartCampaignSuggestService.SuggestKeywordThemes.

Removed support for creating new Smart Display campaigns. Existing Smart Display campaigns still serve as usual.

OperationAccessDeniedError.CREATE_OPERATION_NOT_PERMITTED is thrown if you try to create a new Smart Display campaign.

Added the following fields to Campaign:

primary_status to provide insight into why a campaign is not serving or not serving optimally.

primary_status_reasons to provide reasons into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine primary_status.

Enabled adding and removing location targeting to Local Services campaigns except for proximity targeting.

Added the following errors to CampaignCriterionError for the Local service campaigns:

AT_LEAST_ONE_POSITIVE_LOCATION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN

CANNOT_ADD_OR_REMOVE_LOCATION_FOR_LOCAL_SERVICES_CAMPAIGN

CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN

LOCATION_INVALID_FOR_LOCAL_SERVICES_CAMPAIGN

LOCATION_NOT_IN_HOME_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN

LOCATION_NOT_LAUNCHED_FOR_LOCAL_SERVICES_CAMPAIGN

Conversions

conversion_tracking_id will always be > 0 for all customers. Previously, this field could be 0 for customers who hadn’t created any conversion actions before.

Added debug_enabled for performing all checks and returning errors if found when uploading enhanced conversions.

Criteria

Added the following asset set fields to LocationGroupInfo for test accounts:

enable_customer_level_location_asset_set

location_group_asset_sets

Added the following values to CriterionError:

CANNOT_SET_ASSET_SET_FIELD_FOR_CUSTOMER

CANNOT_SET_ASSET_SETS_WITH_FEED_ITEM_SETS

CANNOT_SET_BOTH_ASSET_SET_AND_FEED

CANNOT_SET_FEED_OR_FEED_ITEM_SETS_FOR_CUSTOMER

CANNOT_SET_GEO_TARGET_CONSTANTS_WITH_ASSET_SETS

INVALID_LOCATION_GROUP_ASSET_SETS

Errors

Error codes returned for some invalid operations have changed for the following fields.
BiddingStrategy.currency_code
BiddingStrategy.scheme
BiddingStrategy.type
TargetCpa.target_cpa_micros
TargetImpressionShare.cpc_bid_ceiling_micros
TargetSpend.target_spend_micros (deprecated)

Experiments

Removed CampaignExperimentService in favor of the previously added new experiments.
Renamed ExperimentArm.trial to ExperimentArm.experiment.

When you create a new experiment arm using MutateExperimentArms and set response_content_type of your mutate request toMUTABLE_RESOURCE, it now also populates values in ExperimentArm.in_design_campaigns.

Feeds

Added LEGACY_FEED_TYPE_READ_ONLY to the following enums: CampaignFeedError, FeedItemError, FeedMappingError

Planning

AudienceInsightsService.ListAudienceInsightsAttributes now accepts AudienceInsightsDimension.GEO_TARGET_COUNTRY and AudienceInsightsDimension.SUB_COUNTRY_LOCATION, enabling clients to discover the location criteria that can be used in AudienceInsightsService.

Added AudienceInsightsService.ListInsightsEligibleDates (available to allowlisted accounts only), enabling clients to discover the set of date ranges that can be used in AudienceInsightsService.

Removed GenerateProductMixIdeas from ReachPlanService.

Added Targeting.plannable_location_ids, which supports targeting multiple geo locations within the same parent location in a single reach forecast.

Recommendations

Added RaiseTargetCpaBidTooLowRecommendation which identifies target CPA adjustments to help campaigns start serving.

Added ForecastingSetTargetRoasRecommendation which identifies target ROAS adjustments to capture additional conversion value from expected traffic increases.

Reporting

Added support for returning the number of clicks for sitelinks (when segments.click_type = SITELINKS) in the landing_page_view report.

Added the following purchased traffic metrics: metrics.publisher_purchased_clicks,
metrics.publisher_organic_clicks, metrics.publisher_unknown_clicks

Forum discussion at Twitter.

Source: www.seroundtable.com

Share on Facebook

Post on X

Save

SEARCHENGINES

Daily Search Forum Recap: April 17, 2024

Published

3 hours ago

April 18, 2024

Entireweb News Bot

Here is a recap of what happened in the search forums today, through the eyes of the Search Engine Roundtable and other search forums on the web.

The Google March core update still is causing volatility and it is deepening. Google may make changes to the crawl stats report in Search Console. Google Search Console now shows unused ownership tokens. Google Maps will drop the review drafts. Google Add added generative AI for image generate for Demand Gen campaigns. Google Search is testing more sitelinks designs.

Search Engine Roundtable Stories:

Deepening Google Core Ranking Volatility Hits Yesterday & Today

I know we just reported on more volatility this Monday, possibly related to the Google March 2024 core update, but we are seeing even more volatility over the past 24 hours related to this update. This volatility shows deepening movement for those who were hit, which is incredibly sad in many cases.

Google Search Console Adds Unused Ownership Tokens

Google Search Console has a new security feature under user and permission management to help you manage your unused ownership tokens. Basically, it helps you manage who has permissions to your Search Console profiles and who should not, maybe some legacy verifications.

Google: Should We Explain The Crawl Stats Report in Search Console

Martin Splitt from Google posted a one-line question asking, “Should we do something to explain the crawl stats report in GSC?” This was posted on Mastodon, which has a small audience, but the responses were pretty good.

New Google Ads AI Generated Image Tool For Demand Gen Campaigns

Google Ads announced that Demand Gen campaigns are getting generative AI tools to create image assets. This is rolling out to advertisers around the world in English with more languages to come later this year, Google said.

Google Tests Horizontal Lines For Sitelinks & People Also Ask

Google Search is testing horizontal lines under the sitelinks and the people also ask elements in the search results. This is a long horizontal line that goes across the while search result snippet.

Google Maps No Longer Will Support Draft Reviews

Google Maps will soon stop supporting drafting reviews for local business listings and Google Business Profiles. Google said that starting July 16, 2024, review drafts will no longer be supported.

Doogler In Google Play Area

Some of you love photos of dogs, so here is another one of a Doogler, a Google dog, in a play area, at the Google office. This was shared by the Life at Google Twitter account.

Other Great Search Threads:

Search Engine Land Stories:

Feedback:

Have feedback on this daily recap; let me know on Twitter @rustybrick or @seroundtable, on Threads, Mastodon and Bluesky and you can follow us on Facebook and on Google News and make sure to subscribe to the YouTube channel, Apple Podcasts, Spotify, Google Podcasts or just contact us the old fashion way.

SEARCHENGINES

Daily Search Forum Recap: April 16, 2024

Published

1 day ago

April 17, 2024

Entireweb News Bot

Here is a recap of what happened in the search forums today, through the eyes of the Search Engine Roundtable and other search forums on the web.

Google will fight the site reputation abuse spam both algorithmically and with manual actions. Google is testing thumbs-up and down in product carousels. Google Ads similar product carousel is being tested. Google Search updated its image documentation. Google AdSense has a new ad format named ad intents.

Search Engine Roundtable Stories:

Google Will Fight Site Reputation Abuse Spam Both With Manual Actions & Algorithms

Google’s new spam algorithm update also introduced new spam policies including the upcoming site reputation abuse policy that won’t go into effect until May 2024. Google has confirmed it will fight site reputation abuse spam using both manual actions (humans) and algorithms (machines).

Google Search Tests Thumbs Up/Down Buttons In Product Grid Results

Google launched the style recommendations with thumbs up and down buttons not long ago after testing it in January. Now Google is showing this thumbs up and down buttons in the product grid search results, so Google can see what you like or dislike and then show you more products that you do like.

Google Ads “Similar Product” Carousel

Google has a similar products section and carousel for Google Ads sponsored listings. We have seen similar products and similar shopping related results from the organic / free listings but now I am seeing examples of a search ad carousel for “similar products.”

Clarification: Google Search Supports Images Referenced From src Attribute

Google has clarified in its image search help documentation that images are only extracted from the src attribute of img tags in Google Search. This is not new, but Google decided to update its documentation based on some questions it received about the topic.

Google AdSense New Ad Intents Formats – Links & Anchors In Content

Google AdSense announced a new auto ads format named “Ad intents.” Ad intents places links and anchors showing organic search results with ads into existing text and pages on your site related to your content. Yea, it takes your content, and hyperlinks it to the Google search results.

3-Wheel Tricycle At Google

Google’s Ann Arbor office has this 3-wheel tricycle that some Googlers have used over the years to get around the office. This one looks like the hot pink Huffy brand. I spotted this recently on Instagram but the photo is from 2016.

Other Great Search Threads:

I don’t have an update to share at this time, but you should continue to use classic GMC for rules and supplemental feed support. Here’s how to switch back if needed, AdsLiaison on X

In this case, I’ve been introducing a new metric; “likelihood to get search traffic” to see what we should add to XML sitemaps. Some pages might do incredibly well on other metrics, but simply, Joost de Valk on X

It does have a title, and it loads a HTML page – so this seems normal. The JavaScript doesn’t seem to be loading well, so if you’re the site owner, I’d suggest reading ou, John Mueller on X

News! Google Ads removed in some accounts the possibility to hover over a daily budget to edit it. You need to hover now and then click on “Edit budget”. Why changing things to less user-friendly ones, Thomas Eccel on X

The time has come! Registration for the Zürich Product Experts Summit has now opened for eligible PEs in Europe. Virtual registration will follow in May. Check your inboxes and the KB for more details., Google’s Product Experts Program on X

When I want to add positive search terms as exact match, I first add them quickly as broad, then bulk switch them over to exact match. lately I’ve been getting this error and the only way I can switch the keywords is by using Ads Editor., Greg on X

Yeah, quantity says nothing about quality and even less about user value or business value. Sometimes the solution to a “crawl budget problem” is not to make the server faster & search engines, John Mueller on X

Which the best method to link to the alternative language of a website, WebmasterWorld

Search Engine Land Stories:

Feedback:

SEARCHENGINES

Daily Search Forum Recap: April 15, 2024

Published

2 days ago

April 16, 2024

Entireweb News Bot

Here is a recap of what happened in the search forums today, through the eyes of the Search Engine Roundtable and other search forums on the web.

There was more Google core update volatility over the weekend. Google defended its statements about forums ranking for almost everything. Google responded to The Verge’s printer article mocking its search results. Google AdSense publishers are seeing really big earnings drops. Google crawl budget is allocated on the hostname level. Google threatened California over its new proposed link tax bill with pulling investments and its news results from the state.

Search Engine Roundtable Stories:

Weekend Google Core Ranking Volatility Taxing Site Owners

As I mentioned briefly in my Friday video recap, I was starting to see renewed chatter on Friday morning around more Google search ranking volatility. I spotted some renewed chatter that lead through Friday, into Saturday and today. So I figured I’d cover it and share some of what SEOs are saying over the weekend.

Google Responds To The Verge Mocking Its Search Rankings For Best Printer

Nilay Patel, editor-in-chief of the Verge posted a new article with the intent to both rank for [best printer] in Google Search, as well as mock Google for how he can game Google’s search rankings using AI-generated content, while throwing in some affiliate links. Google’s John Mueller responded saying, “People seem to really enjoy it.”

Google Goes On Defensive On Its Search Quality & Forum Results Statements

Recently, we covered some of Google’s rationale for ranking forums like Reddit and Quora so well in the Discussion and Forums box for many queries. Just a few days ago, we covered how I was sad to see Google ranking some dangerous and potentially harmful forum threads for health-related queries.

Google Threatens California: Tests Removing Links To Publishers & Pauses Investments

On Friday, Google responded to a pending bill in the California state legislature, the California Journalism Preservation Act (CJPA), that would require Google to pay a link tax to publishers by testing removing links to California based publishers and pausing investments in news publishers within the state.

Google Crawl Budget Is Allocated By Hostname

Google gives every hostname its own allocated crawl budget. So that means each domain, subdomain, etc has its own unique crawl budget.

Google AdSense Publishers Reporting Huge RPM Earnings Drops

Many Google AdSense publishers have been reporting massive declines in their earnings and RPMs (page revenue per thousand impressions) since late February. This comes a couple of weeks after we reported the switch from CPC to CPM bidding in AdSense did not have a negative revenue result for publishers.

Google Android Figurine Display Case

At the Google Chicago office they have dozens of Android figurines on display in this glass display case. I guess they all have a name and are labeled with details. I found this image on Instagram.