AdWords API v201509 sunset reminder
We've prepared various resources to help you with the migration: As always, if you have any questions about this migration, please contact us via the forum or the Ads Developers Plus Page.
Did you know that you can reach past website visitors and app users? Let's say you’re a travel brand. You can now reach people who have joined your rewards program as they plan their next trip. For example, when these rewards members search for “non-stop flights to new york” on Google.com, you can show relevant ads at the top of their search results on any device right when they’re looking to fly to New York. And when those members are watching their favorite videos on YouTube or catching up on Gmail, you can show ads that inspire them to plan their next trip.
Behind the scenes, this works by adding people to a UserList.Prior to v201509 there were four different types:
A SimilarUserList
is automatically created by Google for each UserList
based on a variety of factors, such as the number of people on the original list, how recently these people joined the original list, the types of sites that these people browsed and whether the original list is your own. This process may take up to 4 days once the seed list is created.
You can target or exclude user lists at the ad group level, but you can only exclude them at the campaign level.
As a reminder, please have a look at the policy for advertising based on interests and location and the policy for remarketing lists for search ads.
v201509 introduced a new user list type: CrmBasedUserList. It enables you to create a user list using your customers’ email addresses.
Suppose you have an existing database of email addresses of your newsletter subscribers for “people who love shoes”. With a CrmBasedUserList
you can reach these subscribers and adjust your bidding accordingly, present different ads, and more. You can use a SimilarUserList
of your subscribers list to potentially find new customers who share similar behaviors and interests.
Each CrmBasedUserList
must have an optOutLink to provide a link to the page where people can manage their preferences for receiving email messages from the advertiser, including opting out of the advertiser email messages.
Before using this targeting strategy, please take the time to read our policy page.
A CrmBasedUserList
can be used for targeting on the Search network, YouTube and Gmail, whereas a SimilarUserList
of a CrmBasedUserList
can only be used for targeting on YouTube and Gmail.
Keep the following points in mind when using a CrmBasedUserList
:
If you want to read more about CrmBasedUserList
, have a look at our guide and code examples.
As always, feel free to visit us or ask questions on the AdWords API Forum or our Google+ page.
VideoViews
, which have previously been unavailable via API reporting. AdWords API version v201509 has updated its reporting to match these changes.Interactions
field, available in API performance reports, can be thought of as the main action a user takes with the ad format: clicks for text ads, engagements for Lightbox ads, and views for video ads. Previously, views for video ads were not returned in API reporting, so having access to this data is new.Clicks
field always included both clicks and engagements. Starting in v201509, the Clicks
field includes only click actions, like clickthroughs to a landing page or clicks to call. This means that clicks on video ads, which are unpaid, will be included in this field. However, engagements for Lightbox ads will not be counted.Interactions
to view the total number of primary user actions on ads, all in the same column. Clicks
, Engagements
, and VideoViews
are available as well for more fine-grained reporting by ad format.Field |
v201506 |
v201509 |
Clicks |
Text ads: clickthrough to a landing page Lightbox ads: hover to expanded ad format |
Text ads: clickthrough to a landing page or clicks to call Lightbox ads: clickthrough to a landing page Video ads: clickthrough to a landing page |
Engagements |
N/A
|
Lightbox ads: hover to expanded ad format
|
VideoViews |
N/A
|
Video ads: view
|
Interactions |
N/A
|
Text ads: clickthrough to a landing page or clicks to call Lightbox ads: hover to expanded ad format Video ads: views |
Clicks
column in v201506 will match the Interactions
column from v201509 if you subtract out video interactions.Today we’re announcing the release of AdWords API v201509. Here are the highlights:
If you’re using v201502 of the AdWords API, please note that it’s being sunset on November 12th, 2015. We encourage you to skip v201506 and migrate straight to v201509. If you’re using v201506, be aware it’s now marked deprecated and will be sunset on April 11th, 2016.
As with every new version of the AdWords API, we encourage you to carefully review all changes in the release notes and the v201509 migration guide. The updated client libraries and code examples will be published shortly. With this release, we’ve also updated the Required Minimum Functionality document to include some of the newly added features. If you have any questions or need help with migration, please post on the forum or the Ads Developers Plus Page.
- Josh Radcliff, AdWords API Team