Часто задаваемые вопросы¶

Вопросы помечены по аудитории: [Покупатель] для медиабайеров и менеджеров кампаний, [DevOps] для платформенных инженеров, [Все] для общих вопросов.

[Покупатель] Почему мой процент покрытия ниже 100%?¶

Покрытие показывает, сколько ячеек «дата x тип отчета» содержат данные по сравнению с ожидаемым количеством. Типичные причины пробелов:

Google не отправил отчет за эту дату (праздничный день, задержка экспорта).
Gmail-импорт пропустил письмо (проверьте статус Gmail).
Определенный тип отчета недоступен для вашего места (например, данные о качестве могут отсутствовать для некоторых покупателей).

Проверьте таблицу актуальности данных на странице /import, чтобы увидеть, какие именно ячейки отсутствуют. См. Импорт данных.

[Покупатель] В чем разница между «потерями» и «низким процентом побед»?¶

Потери = запросы ставок, которые ваш биддер отклонил, не сделав ставку. Это QPS, за который вы заплатили, но не смогли использовать вовсе. Исправляется с помощью претаргетинга.

Низкий процент побед = запросы ставок, на которые ваш биддер сделал ставку, но проиграл аукцион. Это означает, что ваши ставки недостаточно конкурентоспособны. Исправляется стратегией ставок, а не претаргетингом.

Оба показателя отображаются в воронке, но требуют разных действий. См. Как читать QPS-воронку.

[Покупатель] Можно ли отменить изменение претаргетинга?¶

Да. Перейдите на страницу /history, найдите нужное изменение, нажмите «Предварительный просмотр отката», чтобы увидеть, что будет отменено, а затем подтвердите. Сам откат тоже фиксируется. См. Настройка претаргетинга.

[Покупатель] Как часто нужно повторно импортировать данные?¶

Ежедневно. Автоимпорт через Gmail делает это автоматически. Если вы загружаете данные вручную, делайте это раз в день после поступления отчетов. Устаревшие данные означают устаревшие решения.

[Покупатель] Что именно меняет оптимизатор?¶

Оптимизатор предлагает изменения конфигов претаргетинга: добавление или удаление географий, размеров, издателей и т. д. Он никогда не применяет изменения автоматически. Вы проверяете и одобряете каждое предложение. См. Оптимизатор.

[DevOps] Почему проверка runtime health strict gate не прошла?¶

Проверьте логи воркфлоу: gh run view <id> --log-failed. Обратите внимание на FAIL и BLOCKED:

FAIL = что-то сломалось. Частые причины: таймаут data-freshness и проблемы с SET statement_timeout. См. Устранение неполадок.
BLOCKED = отсутствует зависимость, не обязательно ошибка в коде. Примеры: нет данных о качестве для этого покупателя, у предложения нет billing_id. Сравните с предыдущими запусками, чтобы отличить регрессии от уже существующих пробелов.

[DevOps] Почему эндпоинт data-freshness работает медленно?¶

Запрос сканирует rtb_daily (~84M строк) и rtb_bidstream (~21M строк). Если план запроса деградирует до последовательного сканирования вместо использования индексов (buyer_account_id, metric_date DESC), выполнение займет минуты.

Решение: убедитесь, что запросы используют паттерн generate_series + EXISTS (14 обращений к индексу вместо полного сканирования таблицы). См. Работа с базой данных.

[DevOps] Как узнать, какая версия развернута?¶

curl -sS https://scan.rtb.cat/api/health | jq -r '.git_sha,.version'

Эта команда возвращает git SHA и тег образа. Сравните с вашим журналом коммитов.

[DevOps] Как развернуть исправление?¶

Запушьте в unified-platform
Дождитесь успешного завершения build-and-push.yml
Запустите deploy.yml через gh workflow run с confirm=DEPLOY
Проверьте через /api/health

См. Развертывание для полной процедуры.

[DevOps] Пользователи зависли в цикле авторизации. Что делать?¶

Проверьте Cloud SQL Proxy: sudo docker ps | grep cloudsql. Если он не работает, перезапустите его, подождите 10 секунд, затем перезапустите контейнер API. См. Устранение неполадок для полной процедуры.

[Все] Откуда Cat-Scan берет данные?¶

Из CSV-экспортов Google Authorized Buyers. Reporting API не используется. Данные поступают либо через ручную загрузку CSV, либо через автоматический импорт из Gmail. См. Импорт данных.

[Все] Безопасно ли повторно импортировать тот же CSV?¶

Да. Каждая строка хешируется и дедуплицируется. Повторный импорт никогда не приводит к двойному подсчету.

[Все] Какие языки поддерживает интерфейс?¶

Английский, нидерландский и китайский (упрощенный). Переключатель языка находится в боковой панели.