Tag Archives: adwords_scripts

Sunsetting promotionLine in AdWords Scripts

We are sunsetting support for the promotion line field of Product Ads in AdWords Scripts, since this feature has been retired in AdWords in favor of automated extensions.

As part of this change, we have marked the getPromotionLine() method of ProductAd and the withPromotionLine() method of ProductAdBuilder as deprecated. These methods will start throwing errors on September 15, 2016. If your script uses these methods, then make sure you review them and make necessary changes to ensure they continue to work as expected.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

Anash P. Oommen, AdWords Scripts Team

Register now for the AdWords Scripts workshops!

We’re pleased to announce the final round of workshops for AdWords scripts in 2016. The workshops will be held at the following locations:
  • London, UK: 30 August 2016 (register)
  • Hamburg, Germany: 5 September 2016 (register)
This round of workshops will cater to both novice and experienced scripters. We'll have code labs where you’ll build your own scripts from scratch with help from the Scripts team. Bring your laptop and some scripting ideas, and we’ll turn them into reality!

Whether you’re an advertiser who wants to learn about how scripts can automate your account management tasks, a developer who wants to polish your scripting skills, or a scripts enthusiast who wants to bounce around some ideas, you can find it all in these workshops.

Visit our website to check out the full agenda and sign up.

If you have any questions about the workshops, you can post them on our forums. Check out our Google+ page for AdWords Scripts updates.

Anash P. Oommen, AdWords Scripts Team

Support for v201605 reports in AdWords Scripts

We have added support for AdWords API v201605 reports in AdWords Scripts. The major changes in this release are:

See the AdWords API release notes for more details.

v201603 will remain the default version of the reports until July 20, 2016. This gives you enough time to verify your scripts and make sure it works with the latest report version.

If you use API versioning in your reports, you need to modify your code to use v201605: 


  var report = AdWordsApp.report(query, {
    apiVersion: 'v201605'
  });

If you don’t use API versioning, no code changes are required. Your reports will continue using v201603 for now, and switch to v201605 when we make v201605 the default version on July 20, 2016.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

 - , AdWords Scripts Team

Support for v201603 reports in AdWords Scripts

We have added support for AdWords API v201603 reports in AdWords scripts. The major changes in this release are: See the AdWords API release notes for more details.

Starting from this release, we will not switch to the latest reporting version on the day of the release by default. Instead, we will keep the previous report version as the default version for a while before switching to the latest reports version. This will give you enough time to verify your scripts and make sure it works with the latest report version.

If you use API versioning in your reports, you need to modify your code to use v201603 as shown below. 

var report = AdWordsApp.report(query, {
   apiVersion: 'v201603'
});
If you don’t use API versioning, no code changes are required. Your reports will continue using v201601 for now, and switch to v201603 when we make v201603 the default version on May 17, 2016.

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

 - , AdWords Scripts Team

Register now for the AdWords Scripts workshops!

We’re pleased to announce the second round of workshops for AdWords scripts in 2016. The workshops will be held at the following locations: This round of workshops will cater to both novice and experienced scripters. We'll have code labs where you’ll build your own scripts from scratch with help from the Scripts team. Bring your laptop and some scripting ideas, and we’ll turn them into reality!

Whether you’re an advertiser who wants to learn about how scripts can automate your account management tasks, a developer who wants to polish your scripting skills, or a scripts enthusiast who wants to bounce around some ideas, you can find it all in these workshops.

Visit our website to check out the full agenda and sign up.

If you have any questions about the workshops, you can post them on our forums. Check out our Google+ page for AdWords Scripts updates.

Anash P. Oommen, AdWords Scripts Team

Support for v201601 reports in AdWords Scripts

We have added support for AdWords API v201601 reports in AdWords scripts. The major changes in this release are:

The release also introduces some improvements to several reports in existing versions (v201506, v201509).

See our release notes for more details.

If you use API versioning in your reports, you need to modify your code to use v201601 as shown below. If you don’t use API versioning, no code changes are required.


var report = AdWordsApp.report(query, {
   apiVersion: 'v201601'
});

If you have any questions about these changes or AdWords scripts in general, you can post them on our developer forum.

 - , AdWords Scripts Team

Reminder: Upgrade your AdWords destination URLs by March 25th, 2016

We would like to remind you to upgrade destination URLs for ads, criteria, and sitelinks by March 25, 2016.

Shortly after March 25, 2016, we will apply the following changes to the ads, criteria, and extensions in your account that have not been upgraded:
  • Ads and sitelinks will be permanently designated as “Removed” and will stop serving. In rare cases, destination URLs for ads may be upgraded for you, which may impact how your ads run.
  • Destination URLs for your keywords will be removed. Clicks on your ads for these keywords will go to the ad's landing page. You'll need to set up new landing page URLs and tracking parameters.

    Note: Dynamic Display Ads, Gmail Sponsored Promotion, and Lightbox ads are not impacted by this change and will continue to serve.
How to upgrade your remaining destination URLs
To ensure your existing ads continue to run and your URL tracking works as expected, you'll need to: What if I can’t upgrade in time?
If you do not plan to upgrade destination URLs by March 25, 2016 or wish to keep the destination URL details for future use, then we advise you to download the ads, criteria and extensions that are not upgraded using an appropriate AdWords API service. Destination URL data is accessible for now via AdWords API reports and services, but this field will be removed in a future version of the AdWords API.

If you have any questions or need help with migration, please post on our developer forum or the Ads Developers Plus Page.

Anash P. Oommen, AdWords API Team

Register now for the AdWords Scripts workshops!

We’re pleased to announce the first round of workshops for AdWords scripts in 2016. The workshops will be held at the following locations: This round of workshops will cater to both novice and experienced scripters. We'll have code labs where you’ll build your own scripts from scratch with help from the Scripts team. Bring your laptop and some scripting ideas, and we’ll turn them into reality!

Whether you’re an advertiser who wants to learn about how scripts can automate your account management tasks, a developer who wants to polish your scripting skills, or a scripts enthusiast who wants to bounce around some ideas, you can find it all in these workshops.

Visit our website to check out the full agenda and sign up.

If you have any questions about the workshops, you can post them on our forums. Check out our Google+ page for AdWords Scripts updates.

Anash P. Oommen, AdWords Scripts Team

New solutions in AdWords Scripts

Three new solutions are now available in AdWords scripts!

Large Manager Hierarchy Template

The new Large Manager Hierarchy Template solution is a manager account script that helps you run script logic on large manager account hierarchies.

If you have a large number of accounts in your manager hierarchy, then you know that running a script across all of them can be challenging. Working on them in parallel using executeInParallel limits a script to a maximum of 50 accounts per execution, while iterating through them sequentially can cause a script to time out if you have too many accounts.

The new Large Manager Hierarchy Template solution helps address this challenge by processing a different subset of accounts each time it executes, keeping track of its work in a temporary file on Google Drive. You can fill in a section of the template with the actual processing logic you want to perform on your accounts.

BigQuery Exporter

The new BigQuery Exporter solution helps you export your AdWords reports to BigQuery. Separate versions are available for AdWords accounts and AdWords manager accounts.

If you want to run big data analytics on your AdWords accounts, you can leverage Google’s infrastructure using BigQuery, which provides a low-cost solution for querying massive datasets. Export your AdWords data daily and then run queries to find trends and optimize your results.

The new BigQuery Exporter solution creates a BigQuery dataset and tables, downloads AdWords reports and loads the data into BigQuery. You can define which reports and fields to upload in the config section of the script. Take a look at the manager account version to run across multiple accounts.

TV Schedule Bid Coordination

The TV Schedule Bid Coordination script coordinates campaign bid modifiers in an AdWords account with an arbitrary schedule as specified in a Google Sheet.

A typical use case of this script is to coordinate an increase in bids on your AdWords campaigns to coincide with your existing TV campaigns. However, other similar use cases are possible, such as coordinating your campaign bid modifiers with a series of sporting events.

If you have any questions or feedback about these solutions or AdWords scripts in general, you can post them in our developer forum.

Anash P. Oommen, AdWords Scripts Team

Support for v201506 reports in AdWords Scripts

We have added support for AdWords API v201506 reports in AdWords Scripts. This version adds support for FINAL_URL_REPORT, the Upgraded URLs-compatible replacement for the DESTINATION_URL_REPORT.

This version also introduces several changes to the reporting columns
If you use API versioning in your reports, then you need to modify your code to use v201506 as shown below. If you don’t use API versioning, no code changes are required. 

var report = AdWordsApp.report(query, {
   apiVersion: 'v201506'
});
If you have any questions about this feature or AdWords scripts in general, you can post them on our developer forum.

Anash P. Oommen, AdWords Scripts Team