Автоматизация Адвордса | Google AdWords scripting

Оказывается адвордс (Google AdWords) можно автоматизировать! Без всяких сложных SDK и компиляций - обычные джаваскрипты! Зачем это нужно? Ну например:

• найти и отрепортить не работающие ссылки в рекламных объявлениях, вы ж не хотите платить за клики которые ведут на страницы с ошибками 404, 500 и т.д.  http://www.freeadwordsscripts.com/2014/04/monitor-broken-links-using-mcc-level.html
• требования бизнеса устанавливают меняющийся бюджет (и биды) в зависимости от дня недели, дня месяца или даже в зависимости от события в городе? Не проблема это реализовать http://www.freeadwordsscripts.com/2013/10/disable-ads-and-keywords-for-out-of.html
• автоматическая пауза рекламных объявлений и ключевых слов для товаров которые закончились на складе http://www.freeadwordsscripts.com/2013/10/disable-ads-and-keywords-for-out-of.html
• создания гибридных отчетов включающих в себя данные из адвордса (стоимость) и из вашей СРМ (продажи, лиды)
• изменить тексты объявлений автоматически указывая количество дней (часов) до окончания рекламируемого события
• поиск аномалий - если неожиданно снизился клик рейт или кейворд(ы) ушли ниже окупаемости
• ваша идея?..

Сложно ли писать скрипты для адвордс? Не очень - необходимо очень базовое понимание джаваскрипта и более детальное объектной модели адвордс скриптинга.

Сложно ли использовать готовые скрипты? Абсолютно нет.

Вот пошаговая инструкция куда, что копировать и какие кнопки жать:

https://developers.google.com/adwords/scripts/docs/your-first-script

Самый простой скрипт состоит из функции main().
Нет, она не принимается параметры argv и argc.
Вообще никакие параметры не принимает - но выполнение скрипта начинается с нее. Нам доступен объект AdWordsApp с кучей полезных свойств и методов дающий доступ практически ко всему, что есть в адвордсе. Есть скрипт сервисы позволяющие создавать диаграммы, доступаться к гугл драйву, ходить в интернет, отправлять почту (email) и многое другое.

Скрипты могут вести логи вызывая функцию Logger.log() Логи затем доступны через интерфейс в адвордсе.

Скрипты работают от имени пользователя и имеют абсолютный максимум выполнения в 30 минут (что важно если скрипт ходит в интернет в цикле). Для МСС эккаунтов (скриптов) возможно выполнение в течении 60 минут. Если скрипт должен работать дольше - гугл рекомендует использовать так называемые инкрементальные скрипты: помечать обработанные объекты и при следующем запуске не начинать сначала.

Есть странное ограничение в 250 тысяч изменений инициализированных скриптом и итератор ограничен в 50 тысяч записей (почему не 64). Еще ограничения описаны здесь: https://developers.google.com/apps-script/guides/services/quotas

Вступление в скриптинг для адвордс (осторожно - английский): https://www.youtube.com/watch?v=M_dxVvJ5knM
и немного по русски https://www.youtube.com/watch?v=aYlwUhOzNYc

Дополнительные ресурсы по скриптингу для Адвордс от Гугл

• Google Developers – AdWords Scripts - Документация и примеры (готовые полезные скрипты), все что нужно чтобы начать (https://developers.google.com/adwords/scripts/)
• AdWords Scripts Community - Здесь можно задать вопрос, поделиться успехами и попросить гугл экспертов помочь со своим скриптом (https://developers.google.com/adwords/scripts/community)
• AdWords Services – Список адвордс сервисов доступных скрипту (https://developers.google.com/adwords/scripts/docs/reference/index)
• AdWords Scripts Limits - Ограничения адвордс скриптинга (https://developers.google.com/adwords/scripts/docs/limits)
• AdWords API – Полная документация по Адвордс АПИ (https://developers.google.com/adwords/api/)

Ниже небольшое вступление в адвордс скриптинг на примере. Для тех кто вчера еще не знал что такое JavaScript. 

Если код выше вызывает вопросы в стиле "кто здесь" - Просмотрите вступление в JavaScript - сразу станет легче:
http://blog.klimenko.kiev.ua/2015/02/javascript.html