Глосарій

Кожен термін — дві перспективи. Ліва колонка — як це розуміє медіабаєр. Права колонка — як DevOps-інженер знаходить це в системі.

Термін	Визначення для медіабаєра	Визначення для DevOps / системи
Сіт	Обліковий запис баєра в Google Authorized Buyers. Ви визначаєте обсяг аналізу та таргетингу для кожного сіта.	buyer_account_id в Postgres. Зберігається в таблиці seats. Синхронізується через GET /seats.
QPS	Queries Per Second: максимальна частота запитів на ставки, яку ви просите Google надсилати. Google обмежує фактичний обсяг залежно від рівня вашого облікового запису.	Налаштований ліміт на конфігурацію претаргетингу. Фактична вхідна частота відстежується через метрики воронки RTB у rtb_daily.
Втрати	QPS, витрачений на запити на ставки, які ваш біддер відхиляє (неправильні географії, неправильні розміри, немає відповідного креативу). Гроші, витрачені даремно.	(total_qps - bids_placed) / total_qps. Обчислюється з агрегатів rtb_daily. Видно в API воронки.
Конфігурація претаргетингу	Правила, що контролюють, які запити на ставки досягають вашого біддера. Ви отримуєте 10 на сіт. Контролює географії, розміри, формати, платформи, паблішерів.	Мутабельна сутність, синхронізована з Google AB API. Зберігається в pretargeting_configs. Управляється через /settings/pretargeting. Знімки дозволяють відкат.
Воронка	Прогресія від запиту на ставку до витрат: QPS -> Ставки -> Виграші -> Покази -> Кліки -> Витрати. Кожен крок має відсів.	Обчислюється з метрик rtb_daily. Обслуговується через GET /analytics/rtb-funnel. Фронтенд кешує на 30 хвилин.
Креатив	Рекламний матеріал: зображення, відео, HTML або нативний. Має формат, розмір, URL призначення та історію ефективності.	Рядок у таблиці creatives. Мініатюри в blob storage. Синхронізується з Google AB API. Ефективність із join-ів rtb_daily.
Кампанія	Логічне групування креативів. Використовується для організації аналізу та звітності.	Рядок у таблиці ai_campaigns. Зв'язок багато-до-багатьох із креативами. Підтримує автокластеризацію AI.
Картка конфігурації	Панель інтерфейсу, що показує стан конфігурації претаргетингу, максимальний QPS, географії, розміри, формати та платформи.	React-компонент PretargetingConfigCard. Дані з GET /settings/pretargeting-configs.
Свіжість даних	Сітка, що показує, для яких дат є імпортовані дані («імпортовано»), а де є прогалини («відсутнє») для кожного типу звіту.	GET /uploads/data-freshness. Використовує запити generate_series + EXISTS до rtb_daily, rtb_bidstream, rtb_quality, rtb_bid_filtering. Тайм-аут запиту 30 с.
Імпорт	Завантаження даних про ефективність у форматі CSV у Cat-Scan — вручну або через автоімпорт Gmail.	CSV розбирається, валідується, дедуплікується (через обмеження унікальності row_hash), вставляється в цільові таблиці. Частинне завантаження для файлів > 5 МБ.
Відкат	Повернення конфігурації претаргетингу до попереднього стану. Попередній перегляд у режимі dry-run, потім підтвердження.	Відновлення знімка: зчитує pretargeting_snapshots, застосовує дельту до Google AB API, записує новий знімок. POST /snapshots/rollback.
Оптимізатор / BYOM	Автоматизована система, яка оцінює сегменти та пропонує зміни конфігурацій. Використовує вашу власну зовнішню модель.	Ендпоінт скорингу викликається через HTTP POST. Пропозиції зберігаються в optimizer_proposals. Життєвий цикл: оцінка -> пропозиція -> затвердження -> застосування.
Пресет робочого процесу	Безпечний, збалансований або агресивний. Контролює, наскільки сміливими є пропозиції оптимізатора.	Параметр canary_profile для API score-and-propose. Впливає на порогові значення впевненості та ліміти масштабу змін.
Ефективний CPM	Скільки ви фактично платите за тисячу показів з урахуванням втрат та вартості інфраструктури.	Обчислюється в OptimizerEconomicsService. Поєднує дані про витрати з rtb_daily із налаштованою вартістю хостингу.
Конверсія	Цінна дія користувача (покупка, реєстрація), що відстежується після показу. Повертається для оптимізації таргетингу.	Подія, отримана через піксель (GET /conversions/pixel) або вебхук (POST /conversions/webhook). Зберігається в таблицях конверсій. Перевірка HMAC для вебхуків.
Win rate	Виграші / Ставки. Наскільки конкурентні ваші ставки на аукціоні.	auction_wins / bids_placed з rtb_daily.
CTR	Кліки / Покази. Наскільки привабливі ваші креативи.	clicks / impressions з rtb_daily.
Тест стану під час виконання	(Не термін баєра)	Робочий процес CI v1-runtime-health-strict.yml. Виконує наскрізні перевірки: стан API, стан даних, конверсії, оптимізатор, SLO QPS. Повертає PASS/FAIL/BLOCKED для кожної перевірки.
Перевірка контрактів	(Не термін баєра)	scripts/contracts_check.py. Перевіряє контракти даних (безумовні правила від імпорту до виходу API). Виконується після розгортання. Блокує реліз у разі збою.
Cloud SQL Proxy	(Не термін баєра)	Сайдкар-контейнер, що забезпечує автентифікований доступ до Cloud SQL Postgres. Повинен бути справним перед запуском контейнера API.
Заголовок X-Email	(Не термін баєра)	HTTP-заголовок, встановлений OAuth2 Proxy після автентифікації Google. API довіряє йому, коли OAUTH2_PROXY_ENABLED=true. Видаляється nginx для зовнішніх запитів.