Скрипты 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.
Если вам нужна помощь, обратитесь в службу технической поддержки скриптов.