Глоссарий¶
Каждый термин с двух точек зрения. В левой колонке -- как его понимает медиабайер. В правой -- как его находит в системе DevOps-инженер.
| Термин | Определение для медиабайера | Определение для DevOps / системы |
|---|---|---|
| Место (Seat) | Аккаунт покупателя в Google Authorized Buyers. Анализ и таргетинг настраиваются для каждого места отдельно. | buyer_account_id в Postgres. Хранится в таблице seats. Синхронизируется через GET /seats. |
| QPS | Queries Per Second: максимальная частота запросов ставок, которую вы запрашиваете у Google. Google регулирует фактический объем в зависимости от уровня вашего аккаунта. | Настраиваемый лимит для каждого конфига претаргетинга. Фактическая входящая частота отслеживается через метрики RTB-воронки в rtb_daily. |
| Потери (Waste) | QPS, потребляемый запросами ставок, которые ваш биддер отклоняет (неподходящие регионы, размеры, нет подходящего креатива). Деньги, потраченные впустую. | (total_qps - bids_placed) / total_qps. Вычисляется из агрегатов rtb_daily. Доступно через API воронки. |
| Конфиг претаргетинга | Правила, определяющие, какие запросы ставок достигают вашего биддера. На каждое место выделяется 10 конфигов. Управляет географиями, размерами, форматами, платформами, издателями. | Изменяемая сущность, синхронизируемая из Google AB API. Хранится в pretargeting_configs. Управляется через /settings/pretargeting. Снимки позволяют выполнять откат. |
| Воронка (Funnel) | Последовательность от запроса ставки до расхода: QPS -> Ставки -> Победы -> Показы -> Клики -> Расход. На каждом этапе есть потери. | Вычисляется из метрик rtb_daily. Предоставляется через GET /analytics/rtb-funnel. Фронтенд кэширует на 30 минут. |
| Креатив | Рекламный материал: изображение, видео, HTML или нативный формат. Имеет формат, размер, целевой URL и историю эффективности. | Строка в таблице creatives. Миниатюры в blob-хранилище. Синхронизируется из 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 МБ. |
| Откат | Возврат изменения конфига претаргетинга к предыдущему состоянию. Предварительный просмотр с пробным прогоном, затем подтверждение. | Восстановление из снимка: считывает 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 для внешних запросов. |