Скрипты Google Рекламы – это бессерверная платформа автоматизации, которая позволяет программно управлять данными Google Рекламы и запрашивать их с помощью современного JavaScript (ES6+) в IDE на основе браузера. С помощью скриптов Google Рекламы можно автоматизировать рутинные рабочие процессы управления аккаунтом, создавать специальные отчеты и интегрировать Google Рекламу с внешними источниками данных (в одном или тысячах аккаунтов) без необходимости настраивать серверы или управлять учетными данными разработчика.
Большинство функций Google Рекламы доступны в скриптах Google Рекламы через вызовы mutate и search. С помощью скриптов можно:
- Управление кампаниями, группами объявлений, ключевыми словами и объявлениями.
- Корректируйте ставки, бюджеты и статусы на основе данных об эффективности в реальном времени или внешних данных.
- Выполняйте запросы с помощью языка запросов Google Рекламы (GAQL), чтобы создавать специальные отчеты и сводки.
- Настройте автоматическое выполнение каждый час, день, неделю, месяц или по запросу.
- Координируйте операции в нескольких дочерних аккаунтах с помощью скриптов управляющего аккаунта.
- Подключайтесь к сервисам Google Workspace (например, Таблицам и Диску), сервисам Google Cloud (например, BigQuery) и сторонним API.
В скриптах также есть встроенные селекторы объектов и отчеты.
Основные технические характеристики
Ниже приведены технические требования к среде выполнения и ограничения для скриптов Google Рекламы.
| Спецификация | Скрипт для одного аккаунта | Скрипт управляющего аккаунта |
|---|---|---|
| Тайм-аут выполнения | Максимум 30 минут |
До 60 минут с executeInParallel и обратным звонком (стандартное время – 30 минут)
|
| Исполняющая среда | Среда выполнения JavaScript V8 (ECMAScript 6+) | Среда выполнения JavaScript V8 (ECMAScript 6 и более поздние версии) |
| Ограничение на количество итераций объекта | 50 000 объектов по умолчанию на итератор (исключение составляют отчеты и поисковые запросы) | 50 000 объектов на дочерний аккаунт (отчеты и поисковые запросы не учитываются). |
| Параллельные аккаунты | — (1 аккаунт) | До 50 аккаунтов одновременно |
| Ограничение на массовую загрузку | 50 МБ, 1 000 000 строк | 50 МБ, 1 000 000 строк |
| Авторизованные скрипты | До 250 авторизованных скриптов на пользователя. | До 250 авторизованных скриптов на пользователя |
| Хостинг и инфраструктура | Полностью управляется Google (бессерверная архитектура) | Полностью управляется Google (бессерверная архитектура) |
Подробнее об ограничениях…
Подходят ли мне скрипты Google Рекламы?
Google предлагает несколько продуктов, которые помогают автоматизировать аккаунты Google Рекламы. В таблице ниже приведены распространенные сценарии и рекомендации, которые помогут вам выбрать подходящий продукт.
| Сценарий | Рекомендация | Основные характеристики |
|---|---|---|
| Я разработчик и хочу создать собственный программный продукт или интегрировать свое ПО с Google Ads API. Я умею писать код и управлять инфраструктурой программного обеспечения, включая серверы и базы данных. | Используйте Google Ads API. | Полный контроль над API, более высокая пропускная способность, выделенный хостинг и управление OAuth. |
| Я разработчик, который умеет писать код, но не хочет управлять собственной инфраструктурой ПО. | Используйте скрипты Google Рекламы. | Бессерверное выполнение в Google Рекламе, автоматическое планирование, браузерная интегрированная среда разработки. |
| Я не разработчик, но хочу научиться программировать, чтобы автоматизировать работу с Google Рекламой. | Используйте скрипты Google Рекламы. | Простой синтаксис JavaScript, готовые шаблоны скриптов, автозаполнение и подсветка синтаксиса в IDE. |
| Я хочу управлять видеокампаниями с помощью алгоритмической продажи. | Используйте скрипты Google Рекламы. |
Прямое управление видеокампаниями с помощью AdsApp.videoCampaigns().
|
| Я хочу запланировать выполнение задач без активного сеанса пользователя. | Используйте скрипты Google Рекламы. | Фоновая авторизация OAuth2 с автоматическим ежечасным, ежедневным, еженедельным или ежемесячным планированием. |
| Я хочу получать доступ к вложенным аккаунтам Google Рекламы программным способом. | Используйте скрипты управляющего аккаунта, чтобы получить доступ к дочерним аккаунтам с помощью одного скрипта. |
Последовательное выполнение для дочерних аккаунтов или параллельное выполнение для 50 дочерних аккаунтов с помощью executeInParallel.
|
| Я хочу интегрировать API Google или сторонних разработчиков в систему управления Google Рекламой. | Используйте API Google или сторонние API со скриптами Google Рекламы. |
Встроенные сервисы Google Workspace (Таблицы, Диск, Почта), расширенные API Google (BigQuery, Аналитика, YouTube) и UrlFetchApp для внешних REST API.
|
| Я аналитик данных (или выполняю похожую роль) и хочу скачать отчеты Google Рекламы для дальнейшего анализа. | Используйте сервис BigQuery Data Transfer для Google Рекламы. | Автоматизированный конвейер для передачи данных Google Рекламы в BigQuery по расписанию без использования кода. |
| Я хочу управлять Google Рекламой массово и не против писать код. | Используйте массовую загрузку со скриптами Google Рекламы. | Программная загрузка CSV-файлов или таблиц, поддерживающая до 1 000 000 строк. |
| Я хочу управлять аккаунтом Google Рекламы в массовом режиме, но не хочу писать код. | Используйте автоматизированные правила, массовую загрузку или Редактор Google Рекламы. | Инструменты для массового обновления и запланированных правил, не требующие написания кода. |
Требования
Достаточно базовых знаний JavaScript, поскольку в IDE есть подсветка синтаксиса, автозаполнение и предварительный просмотр. Чтобы написать первый скрипт, вам понадобится только аккаунт Google Рекламы.
Часто задаваемые вопросы
Здесь вы найдете ответы на часто задаваемые вопросы об архитектуре скриптов Google Рекламы, ограничениях на их выполнение и интеграции.
Что такое скрипты Google Рекламы?
Скрипты Google Рекламы – это бессерверная среда автоматизации в Google Рекламе. Они позволяют рекламодателям и разработчикам писать код JavaScript для запроса показателей эффективности, создания и изменения кампаний, обновления ставок и бюджетов, а также подключения к внешним API без настройки серверов, управления токенами OAuth и оплаты инфраструктуры.
Чем скрипты Google Рекламы отличаются от Google Ads API?
Скрипты Google Рекламы выполняются непосредственно в аккаунте Google Рекламы с помощью JavaScript, не требуют серверной инфраструктуры и автоматически обрабатывают авторизацию в браузере. Google Ads API – это REST и gRPC API, предназначенный для крупных корпоративных приложений, сторонних инструментов и конвейеров данных с большим объемом трафика, которые работают на ваших собственных серверах и требуют специальных токенов разработчика и учетных данных OAuth.
Нужен ли сервер для запуска скриптов Google Рекламы?
Нет. Скрипты Google Рекламы выполняются в облачной инфраструктуре Google без дополнительной платы. Вы можете создавать скрипты, тестировать их в режиме предварительного просмотра и планировать их выполнение прямо в веб-интерфейсе Google Рекламы.
Каковы ограничения на выполнение скриптов Google Рекламы?
Стандартные скрипты в индивидуальных аккаунтах могут выполняться до 30 минут. Скрипты управляющего аккаунта, в которых используется executeInParallel, могут выполняться до 60 минут в 50 дочерних аккаунтах (если указана функция обратного вызова). Если время выполнения скрипта истекло, Google Реклама все равно применит изменения, внесенные до отмены. Подробную информацию об ограничениях на время ожидания, квоты и массовую загрузку можно найти в разделе Ограничения.
Можно ли подключить скрипты Google Рекламы к внешним API?
Да. Скрипты Google Рекламы включают встроенные сервисы, такие как SpreadsheetApp для чтения и записи Google Таблиц, UrlFetchApp для отправки HTTP-запросов к внешним REST API и расширенные API Google для интеграции с такими сервисами, как BigQuery и YouTube. Подробнее о сторонних API и расширенных API Google…
Как оставить отзыв
Если у вас есть отзывы о скриптах Google Рекламы, мы будем рады их услышать. Свяжитесь с нами в Discord.
Если вам нужна помощь, обратитесь в службу технической поддержки скриптов.