Скрипты Google Ads

Скрипты Google Ads — это фрагменты кода на JavaScript, которые выполняются прямо в интерфейсе Google Ads и автоматически управляют рекламными кампаниями: регулируют ставки, приостанавливают объявления, формируют отчеты и синхронизируют данные с внешними таблицами и сервисами без участия специалиста.

Что такое скрипты Google Ads

Скрипты Google Ads — инструмент автоматизации, встроенный в рекламный кабинет Google. Маркетолог пишет код на JavaScript в специальном редакторе и задает расписание: скрипт запускается каждый час, раз в день или раз в неделю. Внутри кода доступны объекты Google Ads API — кампании, группы объявлений, ключевые слова, объявления, расширения, — которые можно читать и изменять напрямую. Дополнительно скрипт умеет обращаться к внешним источникам: Google Таблицам, сторонним REST API, базам данных через HTTP-запросы. Это превращает разрозненные рекламные сигналы и бизнес-логику в единый автоматизированный процесс. Для запуска скриптов не нужно настраивать серверы, арендовать хостинг или управлять OAuth-токенами вручную — Google берет всю инфраструктуру на себя.

Инструмент появился в 2012 году, когда Google открыл программный доступ к управлению аккаунтом прямо через интерфейс кабинета. До этого автоматизация была доступна только через полноценный Google Ads API, который требовал серьезного опыта разработки, регистрации приложения и настройки потоков аутентификации. Скрипты стали промежуточным решением: маркетолог с базовым знанием JavaScript получил возможность писать автоматику без привлечения разработчика. С 2018 года появились MCC-скрипты, которые запускаются одновременно на сотнях дочерних аккаунтов менеджерского уровня. Сегодня официальная библиотека Google и материалы сообщества насчитывают тысячи готовых решений. Инструмент регулярно обновляется — современные версии поддерживают работу с Performance Max и Demand Gen кампаниями.

В digital-маркетинге скрипты закрывают задачи, недоступные для стандартных автоматических правил Google Ads. Правила работают по простой схеме «если A, то B» и не умеют обращаться к внешним источникам. Скрипт, в отличие от правила, может прочитать погоду через API, сравнить результат с вчерашними продажами в таблице и скорректировать ставки сразу по тысяче ключевых слов — все за один запуск. Агентства используют скрипты для мониторинга аномалий: скрипт обнаруживает падение CTR ниже порога и отправляет уведомление в Slack задолго до того, как менеджер откроет кабинет. На крупных аккаунтах с тысячами кампаний ручное управление физически невозможно — скрипты закрывают этот разрыв без затрат на разработку полноценного приложения. По официальным оценкам Google, автоматизация через скрипты позволяет специалисту обслуживать аккаунт в 5-10 раз большего масштаба по сравнению с чисто ручным подходом.

Маркетологу важно понимать скрипты не как технический инструмент разработчика, а как инструмент управления эффективностью рекламы. Умение прочитать и адаптировать готовый скрипт под конкретный аккаунт повышает ценность специалиста и напрямую влияет на результат кампаний. Бизнес выигрывает иначе: скрипты снижают стоимость обслуживания, потому что часть работы, за которую раньше платили агентству, выполняет автоматика. Компании, которые активно используют скрипты, быстрее реагируют на изменения аукциона и теряют меньше бюджета на неэффективные периоды. Специалисты, которые игнорируют этот инструмент, проигрывают конкурентам в скорости реакции и масштабируемости управления. Освоить базовый сценарий — от написания до первого запуска — можно за один рабочий день, используя официальную документацию и готовые примеры от Google.

Как работают скрипты Google Ads

1. Написание кода в редакторе Google Ads. Маркетолог открывает раздел «Инструменты и настройки» — «Массовые операции» — «Скрипты» и создает новый скрипт. Редактор поддерживает синтаксис современного JavaScript (ES6+) и подсвечивает ошибки в реальном времени прямо в интерфейсе. Здесь же доступна встроенная документация по объектам Google Ads API и кнопка «Предварительный просмотр», которая запускает скрипт в режиме симуляции: видно, какие изменения произошли бы, но реальных действий не выполняется — это позволяет безопасно тестировать логику перед боевым запуском.
2. Получение доступа к объектам аккаунта. При запуске скрипт автоматически получает авторизованный доступ через внутренний OAuth — никаких ключей и токенов вводить вручную не нужно. Через глобальный объект AdsApp скрипт получает коллекции кампаний, групп объявлений, ключевых слов и объявлений. Каждый объект можно прочитать — получить ставку, статус, накопленные показатели — или изменить: поставить новую ставку, добавить метку, приостановить. Итерация по коллекциям работает через метод .get(), который возвращает итератор — так скрипт перебирает даже аккаунты с миллионом ключевых слов без зависания интерфейса.
3. Подключение внешних источников. Скрипт читает Google Таблицы через объект SpreadsheetApp — это стандартный способ хранить пороговые значения и правила: в таблице задаются целевые показатели, скрипт загружает их при каждом запуске и принимает решения на основе актуальных данных. Для работы со сторонними сервисами используется метод UrlFetchApp.fetch(), который делает HTTP-запросы к любым REST API: курс валют, данные о погоде, остатки на складе из CRM. Такая интеграция позволяет, например, автоматически поднимать ставки в регионах с плохой погодой, если бизнес продает товары для дома или доставку еды.
4. Применение изменений и запись результатов. После расчетов скрипт применяет изменения через методы объектов: .setBid() задает новую ставку, .pause()/.enable() переключают статус, .applyLabel() навешивает метку. Профессиональная практика — записывать лог каждого изменения в Google Таблицу с временной меткой: так можно восстановить полную историю действий скрипта и в случае аномалии быстро понять, что именно произошло. Скрипт может отправить email-уведомление через MailApp или HTTP-запрос в Telegram-бот при наступлении заданного условия — например, при обнаружении кампании с расходом выше лимита.
5. Настройка расписания запуска. После сохранения скрипта маркетолог настраивает частоту: каждый час, раз в день, раз в неделю или раз в месяц. Часовой запуск подходит для мониторинга аномалий и корректировки ставок в течение рабочего дня, ежедневный — для отчетов и изменений, которые не требуют мгновенной реакции. Скрипт можно запустить вручную в любой момент — это удобно при тестировании или внеплановой корректировке. Максимальное время работы одного скрипта ограничено 30 минутами — для аккаунтов с очень большим числом объектов эту особенность нужно учитывать при проектировании логики.
6. Обработка ошибок и отладка. Если скрипт завершился с ошибкой, Google отправляет уведомление на почту администратора аккаунта. В истории выполнения отображается статус каждого запуска, время работы и сообщения, которые код передал через функцию Logger.log(). При написании скрипта важно добавлять проверки на пустые коллекции: если скрипт ищет кампанию по названию и не находит ее, без явной проверки он завершится с необработанной ошибкой. Режим предварительного просмотра позволяет обнаружить большинство проблем до первого боевого запуска и избежать непреднамеренных изменений в аккаунте.

Виды скриптов Google Ads

• Скрипты управления ставками. Самая распространенная категория: скрипт читает показатели ключевых слов за последние 7 или 30 дней и корректирует ставки на основе заданных правил. Если ключевое слово дает CPA выше целевого на 30%, ставка автоматически снижается на 10%; если конверсий нет за 14 дней и расход превысил порог, ключевое слово получает метку для проверки. Такой подход дает маркетологу полный контроль над логикой без зависимости от «черного ящика» Smart Bidding — особенно ценно в нишах с нерегулярной статистикой и длинным циклом конверсии.
• Скрипты мониторинга и алертов. Проверяют критические показатели и сигнализируют об аномалиях: резкое падение CTR, рост цены клика выше порога, остановка кампании из-за исчерпания дневного бюджета. Google публикует официальный скрипт мониторинга статистики, который сравнивает показатели текущего периода с предыдущим и отправляет письмо при отклонении более чем на заданный процент. Такой скрипт настраивается за 20-30 минут и заменяет ежечасное ручное отслеживание — специалист получает уведомление первым, а не узнает о проблеме от клиента.
• Скрипты автоматической отчетности. Забирают данные из аккаунта и записывают в Google Таблицы в удобном для клиента или руководителя формате. Вместо ручного экспорта и форматирования раз в неделю скрипт сам обновляет сводку показателей по кампаниям, рассчитывает дельту к прошлому периоду и при необходимости рассылает ссылку на таблицу заинтересованным получателям. Агентства используют такие скрипты для автоматической отчетности по десяткам клиентов одновременно — без участия специалиста в процессе сборки.
• Скрипты управления контентом объявлений. Помогают обслуживать объявления в масштабе: добавляют к заголовкам актуальные акционные предложения из таблицы, приостанавливают объявления с устаревшим контентом, проверяют корректность UTM-меток в URL. Один из самых популярных готовых скриптов — проверка битых ссылок: он обходит все финальные URL в аккаунте, проверяет HTTP-статус каждой страницы и записывает в таблицу список ссылок, которые вернули ошибку 404 или 500. Google публикует эту версию как официальный пример в документации.
• Скрипты интеграции с внешними системами. Синхронизируют состояние кампаний с данными из CRM, склада или сторонних аналитических платформ. Классический пример — скрипт, который каждые 2 часа запрашивает наличие товаров через API интернет-магазина и приостанавливает кампании по артикулам, которых нет в наличии. Такая автоматика предотвращает расход бюджета на показы по товарам, которые покупатель все равно не сможет купить, — без скрипта это требовало бы ручной сверки несколько раз в день.
• MCC-скрипты для управляющих аккаунтов. Запускаются на уровне менеджерского аккаунта (MCC) и выполняют одно действие сразу во всех дочерних аккаунтах. Агентство с 50 клиентами может одним MCC-скриптом обновить ставки по единому правилу или собрать сводный отчет по всем кампаниям в одну таблицу за один запуск. Это принципиальное отличие от обычных скриптов, привязанных к конкретному аккаунту, — именно MCC-скрипты дают агентствам возможность масштабировать автоматизацию без линейного роста трудозатрат.

Сравнение скриптов Google Ads с автоматическими правилами

Пример использования

Интернет-магазин спортивного оборудования с ежемесячным бюджетом на Google Ads 180 000 рублей столкнулся с типичной проблемой: 28% бюджета уходило в ночные часы (с 23:00 до 7:00), когда конверсий почти не было. Вручную отслеживать эту закономерность специалист не успевал — кабинет проверялся раз в день. Средний CPA по аккаунту составлял 3 200 рублей при целевом значении 2 000 рублей, и основной вклад в этот разрыв давали ночные клики. Параллельно 15 ключевых слов с CPA выше 6 000 рублей продолжали получать бюджет, потому что менеджер не успевал отслеживать каждое из них еженедельно.

Специалист написал два скрипта: первый каждые два часа проверял часовые показатели и снижал ставки на 70% в нерабочие часы, восстанавливая их с 8:00. Второй скрипт ежедневно сканировал ключевые слова с CPA выше 5 000 рублей за последние 14 дней, добавлял им метку «pause_candidate», и специалист тратил 5 минут в день на просмотр списка и принятие решения. Через 45 дней CPA снизился с 3 200 до 1 980 рублей, уложившись в целевой показатель. Ночной слив бюджета сократился с 28% до 4%. При том же бюджете 180 000 рублей аккаунт начал генерировать на 62% больше конверсий.

Частые вопросы