Общие сведения о продукте

Скрипты 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, Merchant API, 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.

Если вам нужна помощь, обратитесь в службу технической поддержки скриптов.