Перейти к содержанию

Глава 9: Импорт данных

Аудитория: медиабайеры, менеджеры рекламных кампаний

Аналитика Cat-Scan полностью зависит от данных о производительности из Google Authorized Buyers. Поскольку Google не предоставляет Reporting API, все данные поступают из CSV-экспортов. В этой главе описано, как загрузить данные в Cat-Scan и как убедиться, что они поступают.

Почему это важно

Без импортированных данных Cat-Scan нечего анализировать. Воронка, представления потерь, эффективность креативов и оптимизатор — всё зависит от свежих CSV-данных. Если данные устарели, ваши решения основаны на устаревшей информации.

Два способа поступления данных

1. Ручная загрузка CSV (/import)

Перетащите CSV-файл, экспортированный из Google Authorized Buyers.

Страница импорта данных с зоной загрузки и сеткой свежести

Порядок действий:

  1. Экспортируйте отчёт из вашего аккаунта Google Authorized Buyers.
  2. Перейдите на страницу /import в Cat-Scan.
  3. Перетащите файл в зону загрузки (или нажмите для выбора файла).
  4. Cat-Scan автоматически определяет тип отчёта и показывает предварительный просмотр:
  5. Обязательные столбцы и найденные столбцы
  6. Количество строк и диапазон дат
  7. Ошибки валидации, если есть
  8. Просмотрите превью. При необходимости перенастройки столбцов используйте редактор маппинга столбцов.
  9. Нажмите Import.
  10. Индикатор прогресса показывает статус загрузки. Файлы более 5 МБ загружаются частями автоматически.
  11. Результаты: количество импортированных строк, пропущенных дубликатов и ошибок (если есть).

Типы отчётов, определяемые автоматически:

Тип Паттерн имени CSV Содержимое
bidsinauction catscan-report-* Ежедневные показатели RTB: показы, ставки, выигрыши, расходы
quality catscan-report-* (метрики качества) Сигналы качества: видимость, фрод, безопасность бренда
pipeline-geo *-pipeline-geo-* Географическая разбивка потока ставок
pipeline-publisher *-pipeline-publisher-* Разбивка по доменам издателей
bid-filtering *-bid-filtering-* Причины и объёмы фильтрации ставок

2. Автоимпорт из Gmail

Cat-Scan может автоматически загружать отчёты из подключённого аккаунта Gmail.

  • Google Authorized Buyers отправляет ежедневные отчёты по электронной почте.
  • Интеграция Cat-Scan с Gmail читает эти письма и автоматически импортирует CSV-вложения.
  • Проверяйте статус в /settings/accounts > вкладка Gmail Reports или через /gmail/status в API.

Как убедиться, что импорт из Gmail работает: - Проверьте панель Gmail Status: поле last_reason должно быть running. - Проверьте счётчик unread: большое количество непрочитанных писем может указывать на зависание импорта. - Проверьте историю импорта на наличие свежих записей.

Сетка свежести данных

Сетка свежести данных (доступна на /import и используется шлюзом работоспособности среды выполнения) отображает матрицу «дата x тип отчёта»:

              bidsinauction   quality   pipeline-geo   pipeline-publisher   bid-filtering
2026-03-02    imported        missing   imported       imported             imported
2026-03-01    imported        missing   imported       imported             imported
2026-02-28    imported        imported  imported       imported             imported
...
  • imported: Cat-Scan имеет данные для этой даты и типа отчёта.
  • missing: данные не найдены. Либо отчёт не был экспортирован, либо не был получен через Gmail, либо импорт завершился с ошибкой.

Процент покрытия показывает, насколько полны ваши данные за период ретроспективного анализа. Шлюз работоспособности среды выполнения использует этот показатель для определения работоспособности системы.

Дедупликация

Повторный импорт того же CSV-файла (или повторная обработка того же письма через Gmail) не приводит к двойному учёту данных. Каждая строка хэшируется, и дубликаты пропускаются при вставке. Это означает, что повторный импорт всегда безопасен.

История импорта

Таблица истории импорта на странице /import показывает последние 20 импортов:

  • Метка времени
  • Имя файла
  • Количество строк
  • Триггер импорта (ручная загрузка или gmail-auto)
  • Статус (complete, failed, duplicate)

Устранение неполадок

Проблема Что проверить
Ячейки «missing» в сетке свежести Был ли отчёт экспортирован из Google за эту дату? Проверьте Gmail на наличие письма.
Импорт завершается ошибкой валидации Несоответствие столбцов. Сверьте таблицу обязательных столбцов с вашим CSV.
Импорт Gmail показывает «stopped» Проверьте /settings/accounts > вкладка Gmail. Возможно, нужен перезапуск или повторная авторизация.
Процент покрытия снижается Отчёты поступают, но за меньшее количество дат, чем ожидалось. Проверьте расписание экспорта в Google AB.

Связанные разделы