Google Ads API — опис use case
Останнє оновлення: 25 травня 2026
Це НЕ інструмент для пошуку ключових слів. Kit Marketing не розробляє, не пропонує і не продає продукт, основна мета якого — keyword research. Ми не запитуємо доступ до
KeywordPlanServiceчерез Google Ads API. Для разових задач підбору ключових слів наші медіабаєри користуються Keyword Planner в інтерфейсі Google Ads, як і рекомендує Google.
Про компанію
| Компанія | Kit Marketing |
| Юридична особа | ФОП Цвєтков Ілля Олегович |
| ІПН | 3332606453 |
| КВЕД | 73.11 — Рекламні агентства |
| Країна | Україна |
| Сайт | https://kit-marketing.com.ua |
| Privacy Policy | https://kit-marketing.com.ua/uk/polityka-konfidentsiynosti/ |
| Умови послуг | https://kit-marketing.com.ua/uk/umovy-nadannya-poslug/ |
| illia@kit-marketing.com.ua | |
| MCC | 576-345-4890 |
| Cloud project | Kit Marketing Ads API |
| Рівень доступу | Basic Access |
| Рік заснування | 2020 |
| Статус | Google Partner |
Про 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.
4. Керування відстеженням конверсій
- Створення та налаштування conversion actions для нових клієнтів
- Перевірка роботи тегів та усунення проблем трекінгу
- Імпорт оффлайн-конверсій з CRM клієнтів (за документованою згодою)
API services: ConversionActionService, ConversionUploadService.
5. AI-асистований аналіз (лише читання)
Anthropic Claude (через Claude Code / Anthropic API) використовується лише в режимі читання як внутрішній інструмент текстової сумаризації для наших 4 медіабаєрів. Claude отримує агреговані дані рівня акаунту, вже вивантажені нашою командою через Google Ads API, і допомагає:
— Сумаризувати тижневі тренди результатів природною мовою
— Готувати варіанти рекламних текстів, які медіабаєр вичитує та редагує до відправки в API
— Готувати чернетки аналітичних коментарів для клієнтських звітів
Жорсткі архітектурні обмеження:
— У 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 зовнішнім клієнтам як окремий продукт.
Чим цей інструмент НЕ є
- ❌ НЕ інструмент keyword research. Ми не викликаємо
KeywordPlanService. - ❌ НЕ сторонній SaaS. Немає публічного веб-інтерфейсу; немає реєстрацій; не продається.
- ❌ НЕ реселер / white-label платформа. Кожен клієнт — прямий контрактний клієнт Kit Marketing.
- ❌ НЕ автономний AI-інструмент для призначення ставок.
- ❌ НЕ data broker.
Хто має доступ до даних API
- Внутрішня команда: 4 співробітники та довгострокових підрядники Kit Marketing — усі під підписаними NDA та DPA, що відображає вимоги Google API Services User Data Policy.
- Scope доступу: лише акаунти всередині нашого MCC
576-345-4890. - Логування доступу: всі API write actions логуються в внутрішньому audit log. Логи зберігаються 24 місяці.
Дані, які ми запитуємо через API
- Структура кампаній / груп / оголошень / ассетів (читання та запис)
- Метрики результатів
- Conversion actions (читання та запис)
- Audience та demographic звіти на агрегованому рівні
- Налаштування рівня акаунту
Ми не запитуємо і не обробляємо індивідуально ідентифіковані дані кінцевих користувачів.
Зберігання даних
| Клас даних | Термін зберігання |
|---|---|
| Сирі API-відповіді (кеш для звітності) | 90 днів, потім видалення |
| Агреговані метрики | 36 місяців, потім анонімізація |
| Audit log API write | 24 місяці |
| OAuth refresh токени | Відкликаються протягом 24 годин після закінчення контракту |
Sub-processors
| Sub-processor | Призначення | Регіон |
|---|---|---|
| Google Cloud | Compute та storage для проекту Kit Marketing Ads API | europe-west3 |
| Google Looker Studio | Дашборди (лише читання) | Google global |
| Anthropic (Claude API) | Read-only AI-асистент для нашої команди | За Anthropic terms / без навчання на входах |
| PostgreSQL | Внутрішній data warehouse, self-hosted | EU |
Відповідність 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 для показу реклами.
- Ми не допускаємо читання користувацьких даних людьми поза необхідним для контрактної послуги.
- Ми не продаємо дані Google Ads API.
- Ми не використовуємо дані Google Ads API для навчання AI- або ML-моделей.
Повний текст Privacy Policy з Limited Use disclosure: https://kit-marketing.com.ua/uk/polityka-konfidentsiynosti/
Реагування на інциденти
У разі підозри на data incident:
1. Ізолюємо системи протягом 24 годин
2. Повідомляємо клієнтів протягом 72 годин
3. Повідомляємо Google API support
4. Проводимо post-incident review
Google APIs, які ми використовуємо
- Google Ads API (поточна заявка)
- Google Analytics 4 Data API
- Google Merchant Center API