Google Ads API — описание use case

Последнее обновление: 25 мая 2026

Это НЕ инструмент для подбора ключевых слов. Kit Marketing не разрабатывает, не предлагает и не продаёт продукт, основная цель которого — keyword research. Мы не запрашиваем доступ к KeywordPlanService через Google Ads API. Для разовых задач подбора ключевых слов наши медиабайеры пользуются Keyword Planner в интерфейсе Google Ads, как и рекомендует Google.

О компании

О Kit Marketing

Kit Marketing — украинское performance-маркетинговое агентство. Предоставляем managed-service по платному трафику для e-commerce клиентов в Google Ads (Search, Shopping, Performance Max), Meta Ads и TikTok Ads.

Сейчас у нас под управлением 1 411 активных рекламных кампаний в нашем Manager Account (MCC 576-345-4890), с суммарным медиабюджетом более 2,53 млн грн за 14 дней по портфелю клиентов. Каждый аккаунт внутри MCC принадлежит клиенту, который подписал письменный договор с Kit Marketing и явно связал свой аккаунт с нашим MCC через Customer Manager.

Зачем нам Google Ads API

Мы запрашиваем Basic Access к Google Ads API только для внутренних операций агентства. Мы не разрабатываем, не продаём и не лицензируем сторонних SaaS-продуктов, браузерных расширений, white-label платформ или реселлерских программ на основе Google Ads API.

API используется исключительно нашей внутренней командой из 4 медиабайеров/аналитиков для работы с аккаунтами внутри нашего MCC. На объёме 1 411 кампаний ручная работа через интерфейс Google Ads нерациональна и подвержена ошибкам — API единственный способ работать с таким портфелем при сохранении качества и compliance с клиентскими SLA.

Основные use cases (по важности)

1. Массовые операции с кампаниями и бюджетами

• Создание новых кампаний из утверждённых внутренних шаблонов при онбординге клиентов
• Массовое обновление ставок, бюджетов, стратегий назначения ставок
• Pause/enable кампаний, групп объявлений, объявлений
• Управление настройками уровня кампании (локации, языки, ротация, бид-стратегии)

API services: CampaignService, CampaignBudgetService, AdGroupService, AdGroupAdService, BiddingStrategyService.

2. Оптимизация ставок и бюджетов

• Корректировки ставок по устройству, локации, аудитории, времени суток
• Переключение между бид-стратегиями (Manual CPC ↔ Target ROAS ↔ Maximize Conversions) в зависимости от зрелости аккаунта
• Перераспределение бюджетов между кампаниями внутри одного клиентского аккаунта на основе наблюдаемого ROAS

API services: BiddingStrategyService, CampaignBudgetService, CampaignBidModifierService.

3. Отчётность по результатам

• Выгрузка метрик уровня кампании, группы объявлений, объявления (показы, клики, конверсии, расход, CTR, CPC, CPA, conversion value, ROAS)
• Комбинирование с данными GA4 Data API и нашей внутренней CRM (PostgreSQL) для клиентских отчётов и дашбордов (Looker Studio)

API service: GoogleAdsService (search/searchStream по campaign, ad_group, ad, conversion_action, asset).

4. Управление отслеживанием конверсий

• Создание и настройка conversion actions для новых клиентов
• Проверка работы тегов и устранение проблем трекинга
• Импорт оффлайн-конверсий из CRM клиентов (по документированному согласию)

API services: ConversionActionService, ConversionUploadService.

5. AI-ассистированный анализ (только чтение)

Anthropic Claude (через Claude Code / Anthropic API) используется только в режиме чтения как внутренний инструмент текстовой суммаризации для наших 4 медиабайеров. Claude получает агрегированные данные уровня аккаунта, уже выгруженные нашей командой через Google Ads API, и помогает:
— Суммаризировать недельные тренды результатов на естественном языке
— Готовить варианты рекламных текстов, которые медиабайер вычитывает и редактирует до отправки в API
— Готовить черновики аналитических комментариев для клиентских отчётов

Жёсткие архитектурные ограничения (не просто policy-обещания):
— У Claude нет write-доступа к Google Ads API. Архитектурно нет пути, при котором ответ Claude мог бы привести к прямому API write call.
— Каждое API write (создание кампании, изменение ставки, бюджета, объявления, conversion action) инициируется человеком-медиабайером через наш внутренний инструмент. Внутренний инструмент требует аутентификации медиабайера до отправки запроса.
— Claude не получает PII конечных пользователей или данных, идентифицирующих посетителей сайтов наших клиентов.
— Claude рассматривается как sub-processor по нашему DPA-эквиваленту.

Что мы НЕ делаем с Claude:
— Не обучаем модель — ни нашу, ни Anthropic — на данных Google Ads API.
— Не используем данные Google Ads API для построения lookalike-аудиторий или ретаргетинга.
— Не предоставляем выводы Claude внешним клиентам как отдельный продукт и не продаём доступ к Claude.

Чем этот инструмент НЕ является

• ❌ НЕ инструмент keyword research. Мы не вызываем KeywordPlanService.
• ❌ НЕ сторонний SaaS. Нет публичного веб-интерфейса; нет регистраций; не продаётся; не редистрибутируется.
• ❌ НЕ реселлер / white-label платформа. Каждый клиент — прямой контрактный клиент Kit Marketing.
• ❌ НЕ автономный AI-инструмент для назначения ставок. Каждое API write запускается аутентифицированным человеком.
• ❌ НЕ data broker. Данные Google Ads API не покидают системы, описанные в разделе Sub-processors.

Кто имеет доступ к данным API

• Внутренняя команда: 4 сотрудника и долгосрочных подрядчика Kit Marketing — все под подписанными NDA и письменным DPA (Data Processing Agreement), отражающим требования Google API Services User Data Policy. Онбординг включает обязательное обучение по требованиям Limited Use.
• Scope доступа: только аккаунты внутри нашего MCC 576-345-4890, которые клиенты явно связали с нами через Customer Manager в Google Ads.
• Логирование доступа: все API write actions логируются в внутреннем audit log (timestamp, действующий пользователь, MCC, customer_id, resource, before/after state). Логи хранятся 24 месяца для целей аудита.

Данные, которые мы запрашиваем через API

• Структура кампаний / групп / объявлений / ассетов (чтение и запись)
• Метрики результатов (показы, клики, конверсии, расход, CTR, CPC, CPA, ROAS, conversion value)
• Conversion actions (чтение и запись)
• Audience и demographic отчёты на агрегированном уровне (без данных индивидуальных пользователей)
• Настройки уровня аккаунта (бюджеты, бид-стратегии, гео и языковой таргетинг)

Мы не запрашиваем и не обрабатываем индивидуально идентифицируемые данные конечных пользователей сверх того, что Google Ads и так показывает в рекламных аккаунтах на агрегированном уровне.

Хранение данных

Sub-processors

Следующие sub-processors обрабатывают данные Google Ads API от нашего имени, каждый — по письменному DPA или эквивалентным контрактным условиям:

Соответствие Limited Use и Google API Services User Data Policy

Использование данных, полученных через Google APIs, в Kit Marketing соответствует Google API Services User Data Policy, включая требования Limited Use:

• Мы не передаём данные Google Ads API третьим лицам, кроме как необходимо для предоставления услуги клиенту, чьего аккаунта они касаются, или sub-processors, указанным выше под DPA.
• Мы не используем данные Google Ads API для показа рекламы (нет ретаргетинга, нет персонализированной рекламы, нет lookalike-аудиторий).
• Мы не допускаем чтение пользовательских данных людьми сверх необходимого для контрактной услуги.
• Мы не продаём данные Google Ads API.
• Мы не используем данные Google Ads API для обучения AI- или ML-моделей — ни наших, ни sub-processors.

Полный текст Privacy Policy с Limited Use disclosure: https://kit-marketing.com.ua/privacy-policy/

Реагирование на инциденты

В случае подозрения на data incident, затрагивающий данные Google Ads API:
1. Изолируем затронутые системы в течение 24 часов с момента подтверждения
2. Уведомляем затронутых клиентов в течение 72 часов
3. Уведомляем Google API support, если инцидент связан со злоупотреблением API
4. Проводим post-incident review и обновляем контрольные процедуры

Google APIs, которые мы используем

• Google Ads API (текущая заявка)
• Google Analytics 4 Data API (уже подключён в том же Cloud project)
• Google Merchant Center API (уже подключён — для Shopping клиентов)