Скрипты Google Рекламы – это бессерверная платформа автоматизации, которая позволяет программно управлять данными Google Рекламы и запрашивать их с помощью современного JavaScript (ES6+) в IDE на основе браузера. Скрипты Google Рекламы позволяют автоматизировать рутинные задачи по управлению аккаунтом, создавать специальные отчеты и интегрировать Google Рекламу с внешними источниками данных. При этом не имеет значения, сколько у вас аккаунтов – один или тысячи. Вам не нужно настраивать серверы или управлять учетными данными разработчика.
Большинство функций Google Рекламы доступны в скриптах Google Рекламы через вызовы mutate и search. С помощью скриптов можно:
- Управлять кампаниями, группами объявлений, ключевыми словами и объявлениями.
- Корректируйте ставки, бюджеты и статусы на основе данных об эффективности в реальном времени или внешних данных.
- Выполняйте запросы с помощью языка запросов Google Рекламы (GAQL), чтобы создавать собственные отчеты и сводки.
- Запланируйте автоматическое выполнение каждый час, день, неделю, месяц или по запросу.
- Координировать операции с несколькими аккаунтами в дочерних аккаунтах с помощью скриптов управляющего аккаунта.
- Подключайтесь к сервисам Google Workspace (например, Таблицам и Диску), сервисам Google Cloud (например, BigQuery) и сторонним API.
В скриптах также есть встроенные селекторы объектов и отчеты.
Основные технические характеристики
Ниже приведены технические требования к среде выполнения и ограничения для скриптов Google Рекламы.
| Спецификация | Скрипт для одного аккаунта | Скрипт управляющего аккаунта |
|---|---|---|
| Тайм-аут выполнения | Максимальная продолжительность – 30 минут. |
До 60 минут с executeInParallel и обратным звонком (стандартное время – 30 минут)
|
| Среда выполнения | Среда выполнения V8 JavaScript (ECMAScript 6+) | Среда выполнения V8 JavaScript (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.
Если вам нужна помощь, обратитесь в службу технической поддержки скриптов.