Tag Archives: adwords_scripts

Preserving and renewing your AdWords scripts

To help streamline management of your AdWords scripts, we’ve made it easier to preserve scripts created in your AdWords account even after the original author becomes inactive.

In the past, a script in an AdWords account would become unavailable if the script’s original author was no longer associated with the AdWords account. Other users on the AdWords account would need to recreate the script on their own or else risk losing it entirely.

With the new changes we’re launching, scripts from an inactive user will continue to be available in the AdWords account where they were created. To keep these scripts running, the remaining users in the AdWords account will need to log into AdWords and reauthorize the script.

We’ll e-mail the administrators on the AdWords account if the author of a scheduled script goes inactive and here’s what you’ll need to do to get the script running again:
  1. Log in to your AdWords account, and navigate to the Scripts section under Bulk Operations (or the Scripts section of your MCC account).
  2. In the “Script” column, find the relevant script.
  3. Click the "Edit" link.
  4. Click the "Authorize now" button in the yellow bar at the top of the script editor.
  5. Click the “Accept” button.
We are applying this change with an effective date of March 15, 2014. If an author went inactive before that date, his or her scripts will continue to be unavailable. Scripts created in your AdWords account after March 15 will remain available as long as the AdWords account remains open.

Anash P. Oommen, AdWords Scripts Team

New features in AdWords scripts

We have added a couple of new features in AdWords scripts. We hope you like these new features. Try them out and let us know on the forum!

- Anash P. Oommen, AdWords scripts team

Introducing MCC Scripts: Efficient Management across Accounts

MCC scripts is a powerful new way to manage your AdWords accounts at scale through simple JavaScript code. You can make cross-account changes, create customized reports to save time, and even pull data from Google Spreadsheets. In March, we announced that MCC scripts are available for Beta signup. Today, we are excited to make this feature available for all users.

To get started with MCC scripts, log in to your My Client Center account, and navigate to My Client Center->Scripts.
Here are some of the ways you can save time with MCC scripts:
  • High quality cross-account reports: Generate well-formatted custom reports in HTML, PDF or Google Spreadsheets for all your client accounts. You can save these reports to Google Drive, to an external server, or include them as an email attachment.
  • Cross-account optimization: Analyze performance and adjust bids in all your client accounts at scale.
  • Troubleshooting and maintenance tools: Scan your client accounts for potential issues like paused campaigns, broken URLs, capped budgets, conflicting negative keywords, etc.
We have put together several resources to get you started:
  • Getting started guide: Our getting started guide provides a technical overview of MCC scripts and how to use it.
  • Reference docs: Refer to the technical reference for MccApp at https://developers.google.com/adwords/scripts/docs/reference/mccapp/index
  • Code snippets: Not sure how to use a particular feature? You can click the “Show examples” button on the Scripts editor or refer to our code snippets page to view a list of code snippets for the most common use cases in AdWords scripts. We have expanded this section to include snippets that shows various features of MCC Scripts.
  • Solutions: Looking for some ready-to-use scripts? Check out our solutions section, which we've just expanded to include solutions specifically tailored to MCC.
Don't be shy with questions if you're just getting started with AdWords scripts--our forum is here to help! You can also provide feedback via the Google Ads Developers Google+ page.

Anash P. Oommen, AdWords Scripts Team

AdWords scripts – New code snippets are now available!

We have added new code snippets to cover the new services released over the last year. You can view these code snippets by either clicking the Code examples button on the Scripts Editor window in the AdWords UI, or through the examples page on AdWords scripts documentation.



We hope you find these new code snippets useful. If you wish to see more code snippets or have feedback about the new ones, let us know on our developer forum. You can also follow our Google+ page for updates about AdWords scripts.

Anash P. Oommen, AdWords Scripts Team

Changes to AdWords scripts execution logs

As part of our ongoing efforts to improve the performance of AdWords scripts, we are making some changes to the way we provide execution logs for scripts.

Starting May 15, 2014, we will only retain detailed execution logs for scripts that ran during the last 90 days. If you need to retrieve changes made by scripts from an earlier date, you can refer to your account’s change history.

If you have any questions about this change, let us know on the forum or on our Google Ads Developers Google+ page.

Anash P. Oommen, AdWords Scripts Team

Change to ClickType value in AdWords API reports

We are making a minor change to the values returned in the ClickType column in AdWords API reports. Starting the week of May 26th, 2014, AdWords API reports will return "Product listing ad" instead of "Offer" as the display value for click types corresponding to Product Listing Ads.

If you depend on the ClickType field, verify that your applications won't be negatively affected by the change in value.

If you have questions or feedback about this change, let us know on our forum or via the Google Ads Developers Google+ page.

Anash P. Oommen, AdWords API Team

Support for v201402 Reports in AdWords Scripts

We are announcing support for AdWords API v201402 reports in AdWords scripts. The following new reports are available for use:
  • BID_GOAL_PERFORMANCE_REPORT
  • PAID_ORGANIC_QUERY_REPORT
  • PRODUCT_PARTITION_REPORT
  • SHOPPING_PERFORMANCE_REPORT
You can refer to https://developers.google.com/adwords/api/docs/appendix/reports for the list of supported columns and other details for these new reports.

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


var report = AdWordsApp.report(query, {
   apiVersion: 'v201402'
});
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

Changes to conversion counting in AdWords scripts

We recently announced changes to conversion counting and column names in AdWords. We are making the following changes to AdWords scripts to match the updated naming conventions:
  • We have deprecated the getConversions and getConversionRate methods in the Stats class. These methods will work for now, and will return the “converted clicks” and “converted click rate” values as per the new naming conventions.
  • We have introduced two new methods, namely getConvertedClicks and getClickConversionRate to replace the deprecated methods. Please use these methods in your new scripts.
  • We are keeping the column names unchanged in reports available through AdWordsApp.reports(). However, the meaning of values returned by these columns will reflect the new methods of counting conversions.
    • The following columns refer to “converted click” columns under the new naming convention.
      • Conversions
      • ConversionRate
      • CostPerConversion
      • ValuePerConv
      • ValuePerConversion
      • ConversionSignificance
      • ConversionRateSignificance
      • CostPerConversionSignificance
    • The following columns in AdWords scripts reports refer to the “conversion” columns under the new naming conventions. These columns will either return “All Conversions” or “Unique Conversions” values depending on the user preference for counting conversions. By default, this preference defaults to “All Conversions”, so these reporting columns will continue returning the same values as they do today, unless the user changes this preference to “Unique Conversions”.
      • ConversionManyPerClick
      • ConversionRateManyPerClick
      • CostPerConversionManyPerClick
      • ValuePerConvManyPerClick
      • ValuePerConversionManyPerClick
      • ConversionManyPerClickSignificance
      • ConversionRateManyPerClickSignificance
      • CostPerConversionManyPerClickSignificance
If you have questions or feedback about this change, let us know on our forum or via the Google Ads Developers Google+ page.

Anash P. Oommen, AdWords Scripts Team

Upcoming changes to call conversion settings in AdWords scripts

We recently announced the following changes to call metrics with call extensions in AdWords:
  • Call conversion tracking will be disabled by default starting March 3, 2014
  • Call conversion duration threshold will be sunset on April 7, 2014
Since these changes are incompatible with AdWords scripts, we have deprecated the following methods related to these features in AdWords scripts: These methods will be sunset on April 7, 2014. To make sure your scripts work properly, check any code that uses these methods, and fix them before April 7, 2014.

If you have questions or feedback about this change, let us know on our forum. You can also follow our Google+ page for updates about the AdWords scripts.

Anash P. Oommen, AdWords scripts Team