Основной Поток

Реклама на автопилоте: как связать Google Ads и Яндекс Директ через API в 2026 году

Контекстная реклама
Google Ads API · Yandex Direct API · BI
Реклама на автопилоте: как связать Google Ads и Яндекс Директ через API в 2026 году

Что действительно стоит автоматизировать: отчёты, контроль бюджета, алерты, offline conversions, управление аккаунтами и безопасные изменения — без скриптов, которые каждый час ломают Smart Bidding.

API рекламных систем действительно позволяет убрать большую часть ручной рутины.

Но идея «подключили API — и алгоритм сам управляет рекламой лучше специалиста» слишком упрощает задачу.

API — это интерфейс. Он позволяет читать данные и выполнять действия. Качество автоматизации определяется логикой, данными, ограничениями и контролем.

Хорошая рекламная автоматизация не пытается каждую минуту перехитрить алгоритмы Google и Яндекса. Она быстрее обнаруживает проблемы, переносит данные между системами и выполняет заранее разрешённые действия с понятными ограничениями.

Что можно автоматизировать

DATA
Отчётность
Кампании, расходы, клики, конверсии, поисковые запросы и другие рекламные данные автоматически попадают в хранилище и BI.
CONTROL
Контроль
Система отслеживает перерасход, падение конверсий, ошибки tracking и другие отклонения.
ACTION
Управление
При выполнении заранее определённых условий API может менять бюджеты, статусы, настройки и другие разрешённые параметры.

API особенно полезен не одному аккаунту, а системе аккаунтов

Если специалист ведёт одну небольшую кампанию, ручной интерфейс часто остаётся быстрее.

API начинает давать заметное преимущество, когда есть:

  • несколько рекламных аккаунтов;
  • десятки или сотни кампаний;
  • регулярная отчётность;
  • CRM;
  • BI;
  • offline conversions;
  • единые правила контроля.

Типичная архитектура

Google Ads / Direct
↓
API collector
↓
Data Warehouse
↓
BI dashboard
↓
Rules / Alerts / Approved Actions

Такой подход значительно безопаснее скрипта, который одновременно получает статистику, принимает решение и сразу меняет кампанию без истории действий.

Google Ads API в 2026 году

Google Ads API регулярно выпускает новые major и minor versions.

Поэтому номер API-версии нельзя зашивать в интеграцию «навсегда».

Нужно хранить:

  • используемую версию;
  • дату её sunset;
  • план обновления;
  • автоматические integration tests.

Почему старые интеграции внезапно ломаются

Major release может содержать:

  • удалённые поля;
  • изменённые enum;
  • новую структуру resources;
  • deprecated методы;
  • другую модель данных.

Поэтому обновление API — это не просто смена номера URL.

Что требуется для Google Ads API

Типичная конфигурация включает:

  • Google Cloud project;
  • включённый Google Ads API;
  • developer token;
  • OAuth 2.0;
  • доступ к нужным Google Ads accounts.

User OAuth или Service Account

Оба сценария могут использоваться.

User authentication

Подходит, когда приложение получает доступ от конкретного пользователя или нескольких пользователей.

Service account

Удобен для серверной автоматизации, если service account заранее получил доступ к рекламному аккаунту или manager account.

Service account нельзя считать «универсальным ключом Google Ads». Ему всё равно необходимо предоставить корректный доступ к рекламной структуре.

Developer Token

Одних OAuth credentials недостаточно.

Для вызовов Google Ads API требуется developer token и подходящий уровень API access.

Не храните credentials в коде

Client secrets, refresh tokens, service-account keys и другие секреты не должны находиться:

  • в публичном GitHub;
  • в исходном коде;
  • в обычной Google-таблице;
  • в Telegram-чате команды.

Используйте secrets manager или другое контролируемое хранилище.

Что читать из Google Ads API

Для отчётности обычно нужны:

  • campaign;
  • ad group;
  • keyword / search-term data;
  • cost;
  • clicks;
  • impressions;
  • conversions;
  • conversion value;
  • campaign status;
  • budgets;
  • различные segments.

В Google Ads API данные запрашиваются через Google Ads Query Language — GAQL.

Не выгружайте «всё за всё время» каждый час

Это одна из самых частых ошибок самописных интеграций.

Рациональнее:

исторический backfill один раз + регулярная incremental загрузка

BigQuery

Для Google Ads существует готовая интеграция BigQuery Data Transfer Service.

Она подходит, если нужна регулярная выгрузка стандартной рекламной статистики без самостоятельного написания каждого API collector.

Но BigQuery transfer — не настоящий real time

Если бизнесу нужен оперативный мониторинг каждые несколько минут или часов, обычно требуется отдельный API pipeline.

При этом даже прямой API не означает, что каждая рекламная метрика обновляется мгновенно.

Поэтому BI должен показывать время обновления

Полезно выводить:

Last successful sync: 10:35

Тогда пользователь понимает, насколько свежий dashboard.

Google Ads Scripts или API

Ads Scripts

Хороши для небольших задач внутри рекламной экосистемы.

Например:

  • проверить расходы;
  • создать простой alert;
  • поставить label;
  • выгрузить данные.

Ads API

Предпочтительнее, когда нужна внешняя инфраструктура:

  • CRM;
  • warehouse;
  • много аккаунтов;
  • собственная авторизация;
  • сложное логирование;
  • масштабируемая очередь задач.

Нужно ли через API управлять ставками

Можно. Но сначала нужно понять, какой bidding используется.

При Manual CPC одно поведение.

При Smart Bidding — другое.

Самая опасная идея — написать внешний алгоритм, который каждый час меняет target CPA или target ROAS только потому, что последние несколько часов оказались хуже цели.

Почему почасовое изменение tCPA опасно

Короткое окно может содержать мало данных.

Например:

4 часа → 1 конверсия → высокий CPA

Это ещё не доказывает, что стратегия работает плохо.

Дополнительно на конверсии влияют:

  • conversion delay;
  • день недели;
  • время суток;
  • объём;
  • изменение спроса;
  • атрибуция.

Что автоматизировать вместо этого

Например, API может обнаружить:

  • CPA значительно отклонился на достаточно большом объёме;
  • расход вырос, а primary conversions исчезли;
  • conversion value резко упал;
  • кампания ограничена бюджетом;
  • одна кампания забирает непропорциональную часть бюджета.

После этого система:

anomaly → alert → проверка → действие

или выполняет только заранее разрешённое изменение.

Budget pacing

Это один из самых полезных сценариев API.

Система может сравнивать:

  • бюджет периода;
  • фактические расходы;
  • прошедшую часть периода;
  • прогноз расхода.

И предупреждать о:

  • перерасходе;
  • недорасходе;
  • аномальном изменении темпа.

Не меняйте daily budget на каждый небольшой скачок

Для автоматического управления стоит использовать:

  • минимальный размер данных;
  • максимальный процент изменения;
  • cooldown;
  • верхнюю и нижнюю границу;
  • лог причины.

Пример guardrail

изменение разрешено
только если
достаточно данных + нет tracking error + изменение в допустимом диапазоне

Offline conversions

Одна из наиболее ценных API-интеграций для lead generation.

Google Ads может получить более глубокие статусы из CRM.

Например:

Lead → Qualified Lead → Deal

Это полезнее, чем оптимизировать рекламу только на каждую отправку формы.

Что нужно для такой интеграции

Минимально нужно сохранить связку между рекламным кликом и CRM-записью.

В зависимости от реализации используются доступные рекламные identifiers и корректная схема загрузки conversion data.

Не отправляйте продажи дважды

Pipeline должен быть idempotent.

Повторный запуск задачи после ошибки не должен создавать дубли conversion events.

Yandex Direct API

Direct API также позволяет:

  • читать рекламную статистику;
  • управлять кампаниями;
  • управлять объявлениями;
  • управлять ключевыми словами;
  • изменять ставки;
  • работать с bid modifiers;
  • создавать отчёты.

Direct API v5

Yandex Direct использует API version 5 и отдельные services для разных объектов.

Не нужно строить интеграцию вокруг старых примеров из прежних API-поколений.

Reports Service

Для статистики используется Reports Service.

Отчёт может генерироваться:

  • online;
  • offline;
  • в automatic mode.

Результат возвращается в TSV.

Offline mode не означает ошибку

Большой отчёт может быть поставлен в очередь.

Клиент должен корректно:

  • дождаться результата;
  • учесть retry interval;
  • не отправлять тысячи одинаковых запросов.

API points в Direct

У Яндекс Директ нет простого универсального правила вида:

«1000 запросов в минуту».

Система использует API points, а лимит зависит от аккаунта и его активности.

Также действует ограничение на количество одновременных запросов.

Поэтому collector должен понимать Units

И не просто повторять запрос до успеха.

Нужны:

  • очередь;
  • throttling;
  • retry;
  • backoff;
  • лог ошибок.

OAuth Yandex

Старое правило:

«токен всегда истекает ровно через год»

использовать нельзя.

Токен может перестать действовать по разным причинам, включая отзыв доступа, изменение настроек или истечение срока.

Поэтому система должна уметь распознавать authorization error и безопасно восстанавливать доступ.

Ставки Direct

Для manual bidding Direct API позволяет управлять bids.

Для автоматических стратегий логика может опираться на priorities и доступные adjustments.

Не нужно переносить один и тот же bid-controller между ручной и автоматической стратегией.

DataLens

DataLens удобно использовать как BI-слой, но архитектура должна иметь нормальный источник данных.

Например:

Direct API → database / warehouse → DataLens

или:

Object Storage → query layer → DataLens

Просто выгрузить произвольный JSON в bucket недостаточно для полноценной аналитической модели.

Унифицированная модель Google + Yandex

Самая сложная часть — не получить данные, а привести их к одной структуре.

Например:

  • date;
  • platform;
  • account;
  • campaign;
  • cost;
  • clicks;
  • conversions;
  • revenue;

Не смешивайте определения конверсий

В Google Ads «conversion» может означать одно действие.

В Direct — другое.

В CRM — третье.

Поэтому BI должен иметь бизнес-слой.

platform conversion ≠ CRM lead ≠ sale

Time zone и currency

Для Казахстана это критично при объединении нескольких систем.

Проверьте:

  • часовой пояс рекламного аккаунта;
  • часовой пояс CRM;
  • часовой пояс warehouse;
  • валюту аккаунта;
  • конвертацию при объединении разных валют.

Иначе дневные отчёты не совпадут

Например, расход после полуночи может попасть в разные календарные даты в Ads и BI.

Архитектура хорошего рекламного dashboard

MEDIA
Реклама
Расход, клики, impressions, platform conversions, campaign status.
CRM
Продажи
Лиды, квалификация, сделки, выручка, причины отказа.
UNIT
Экономика
CPL, qualified CPL, CAC, ROAS и другие показатели бизнеса.

Какие алерты действительно полезны

Например:

  • вчера не было primary conversions;
  • сегодня расход резко выше нормы;
  • кампания остановлена;
  • conversion tracking перестал получать данные;
  • API sync завершился ошибкой;
  • данные не обновлялись дольше допустимого;
  • CRM conversions перестали загружаться.

Telegram alert

Он полезен, если сообщение содержит контекст.

Плохо:

«CPA высокий».

Лучше:

Google Ads / Search KZ: CPA за последние 7 дней выше планового диапазона. 43 conversions, расход 680 000 ₸. Tracking работает. Требуется проверка Search Terms и структуры кампании.

Не отправляйте 200 алертов в день

Alert fatigue быстро делает систему бесполезной.

Используйте:

  • severity;
  • deduplication;
  • cooldown;
  • summary.

Human approval

Не все автоматические рекомендации нужно выполнять автоматически.

Полезный уровень:

система нашла проблему → предложила действие → человек подтвердил

И только простые, хорошо ограниченные сценарии переводить в fully automated mode.

Какие действия относительно безопасно автоматизировать

Например:

  • создание отчётов;
  • обновление dashboard;
  • alerts;
  • labels;
  • контроль статуса;
  • контроль бюджета;
  • проверку URL;
  • загрузку подтверждённых conversion data.

Что автоматизировать осторожно

  • изменение budget;
  • изменение bidding targets;
  • pause кампаний;
  • массовое добавление negatives;
  • изменение targeting;
  • автоматическое создание объявлений.

Почему auto-negatives опасны

AI или скрипт может увидеть дорогой запрос без конверсий и автоматически добавить его в минус-слова.

Но:

  • данных может быть мало;
  • conversion lag ещё не завершился;
  • запрос может быть стратегически важным;
  • match может заблокировать другие полезные запросы.

Лучше сначала создавать очередь кандидатов на review.

Логи изменений

Любая автоматизация, которая меняет кампанию, должна записывать:

  • время;
  • account;
  • объект;
  • старое значение;
  • новое значение;
  • причину;
  • rule version.

Без логов нельзя понять, кто сломал рекламу

Специалист, API, recommendation auto-apply или другой скрипт.

Dry-run

Перед включением автоматических изменений полезно несколько дней запускать правило в режиме:

«что бы система сделала» → без фактического mutate

Это позволяет увидеть слишком агрессивные правила до того, как они попадут в production.

Rollback

Для критичных automation rules должен существовать способ вернуть последнее корректное состояние.

Monitoring самой интеграции

API pipeline тоже может сломаться.

Нужно следить за:

  • последним успешным sync;
  • количеством загруженных строк;
  • authorization errors;
  • rate-limit errors;
  • schema changes;
  • failed jobs.

Ошибка «0 строк» иногда опаснее HTTP 500

Задача технически завершилась успешно, но из-за неправильного фильтра ничего не загрузила.

Поэтому проверяйте и технический статус, и ожидаемый объём данных.

Retry

Не повторяйте запрос мгновенно бесконечное число раз.

Используйте controlled retry и exponential backoff там, где это соответствует типу ошибки.

Ошибки нужно классифицировать

Например:

  • temporary;
  • authentication;
  • quota;
  • invalid request;
  • permission;
  • schema.

Для каждого класса — свой сценарий.

Автоматизация нескольких клиентов агентства

Для агентства API особенно полезен.

Можно построить единый monitoring layer:

50 accounts → единые проверки → exceptions dashboard

Специалист начинает день не с открытия 50 кабинетов, а со списка аккаунтов, где реально произошло отклонение.

Что показать в agency dashboard

  • spend today;
  • budget pacing;
  • conversions;
  • CPA;
  • conversion tracking status;
  • campaign status;
  • последний sync;
  • alert severity.

AI поверх API

LLM можно использовать как дополнительный аналитический слой.

Например:

  • суммаризировать Search Terms;
  • группировать причины отклонений;
  • формировать описание anomaly;
  • готовить draft отчёта клиенту.

Но LLM не должна самостоятельно менять ставки без ограничений

Модель может ошибиться в интерпретации данных.

Поэтому безопаснее:

данные → deterministic rules → AI explanation

чем:

данные → LLM решила → изменила campaign

Пример нормальной автоматизации CPA

Вместо:

«CPA выше цели на 10% — уменьшаем tCPA на 15% каждый час»

лучше:

Проверить tracking
Есть ли conversion data и не оборвалась ли интеграция.
Проверить объём
Достаточно ли данных для вывода, а не несколько кликов и одна конверсия.
Сравнить период
Не только последние четыре часа, но и релевантный исторический baseline.
Проверить бизнес-сигнал
Не ухудшилось ли качество лидов или выручка.
Создать alert
Специалист получает контекст и принимает решение.
Автоматизировать только после проверки
Если правило доказало стабильность, ему можно дать ограниченное право на изменение.

Безопасная схема budget automation

Задайте:

  • максимальный рост за одно изменение;
  • максимальное снижение;
  • минимальный период между изменениями;
  • минимальный объём данных;
  • финальный ceiling бюджета.

Иначе один баг способен увеличить расход в несколько раз.

Тестирование

У API-интеграции должны быть:

  • unit tests;
  • integration tests;
  • test account;
  • validate-only режим там, где он поддерживается;
  • production monitoring.

Версионирование правил

Если вчера automation использовала одно правило, а сегодня другое, это должно быть видно в логах.

Например:

pacing_rule_v3 → changed budget +8%

Безопасность доступа

Применяйте принцип minimum permissions.

Сервису отчётности не обязательно выдавать право на изменение кампаний.

Разделяйте read и write

Хорошая архитектура может иметь:

reporting service → read only

automation service → restricted write

Не используйте один токен везде

Если один credential утечёт, ущерб должен быть ограничен.

Когда API не нужен

Не стоит строить сложную инфраструктуру, если:

  • один небольшой account;
  • несколько кампаний;
  • отчёт нужен раз в месяц;
  • нет CRM;
  • нет разработчика или человека, который будет поддерживать интеграцию.

В таком случае Ads Scripts, стандартные dashboards или готовый connector могут быть дешевле и надёжнее.

Когда собственная API-интеграция оправдана

  • десятки рекламных аккаунтов;
  • собственный продукт;
  • агентство;
  • сложная CRM;
  • offline conversions;
  • единый BI;
  • частые повторяемые операции;
  • требуется custom logic.

Стоимость автоматизации

Нельзя оценивать её только количеством часов программиста.

Учтите:

  • разработку;
  • cloud infrastructure;
  • мониторинг;
  • поддержку;
  • миграцию API versions;
  • security;
  • исправление ошибок.

Автоматизация окупается там, где есть повторяемость

Если отчёт специалист вручную готовит один раз, API может быть дороже ручной работы.

Если тот же отчёт формируется для 100 аккаунтов каждое утро, ситуация меняется.

Чек-лист перед разработкой

Задача

  1. Что именно автоматизируется?
  2. Почему стандартного интерфейса недостаточно?
  3. Как измеряется эффект?

Данные

  1. Какие поля нужны?
  2. Какой refresh interval?
  3. Какой период истории?
  4. Какая timezone?
  5. Какая currency?

Доступ

  1. Google developer token получен.
  2. OAuth настроен.
  3. Yandex access настроен.
  4. Secrets хранятся безопасно.

Надёжность

  1. Есть retry.
  2. Есть rate limiting.
  3. Есть logging.
  4. Есть alerts.
  5. Есть idempotency.
  6. Есть rollback.

Управление

  1. Определены read-only задачи.
  2. Write actions ограничены.
  3. Есть guardrails.
  4. Есть human approval для рискованных изменений.

Реальный «автопилот» выглядит не так, как в рекламе SaaS

Он не должен постоянно совершать сотни изменений.

Хорошая система часто наоборот делает рекламу спокойнее:

собрать данные → найти исключение → предупредить → изменить только при необходимости

Итог

Google Ads API и Yandex Direct API дают рекламодателю намного больше возможностей, чем ручная выгрузка CSV.

С их помощью можно автоматизировать:

  • сбор данных;
  • BI-отчётность;
  • budget pacing;
  • мониторинг;
  • alerts;
  • offline conversions;
  • массовые управляемые изменения.

Но автоматизация ставок не должна превращаться в хаотичное вмешательство в Smart Bidding.

Ценность API не в том, чтобы система меняла рекламу чаще человека. Ценность в том, чтобы она быстрее собирала данные, раньше находила отклонения и выполняла только те действия, для которых заранее определены правила, ограничения и контроль.

Ads API · BI · Automation
Нужно связать рекламные кабинеты с BI, CRM или автоматическими отчётами и понять, что имеет смысл автоматизировать именно в вашем проекте?
Обсудить интеграцию

Автоматизируем рекламу без «чёрного ящика»

Competent может помочь спроектировать отчётность и рекламную автоматизацию: Google Ads, BI-дашборды, CRM-сигналы, контроль бюджета, алерты и аналитику до реального бизнес-результата.

Competent Digital Agency
Аналитика и автоматизация рекламы

Google Ads, рекламная аналитика, BI-дашборды, CRM, отчётность и автоматизация маркетинга для бизнеса в Казахстане.

Competent Digital Agency · Алматы · Казахстан
Сайты · SEO · Google Ads · Social Ads · Аналитика · GEO / AI