Перейти до змісту

Розділ 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. Необхідні колонки vs. знайдені колонки
  6. Кількість рядків та діапазон дат
  7. Будь-які помилки валідації
  8. Перегляньте попередній перегляд. Якщо колонки потребують перепризначення, скористайтеся редактором зіставлення колонок.
  9. Натисніть Імпортувати.
  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» або через /gmail/status в API.

Для перевірки роботи імпорту Gmail: - Перевірте панель статусу Gmail: 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 імпортів:

  • Мітка часу
  • Назва файлу
  • Кількість рядків
  • Тригер імпорту (ручне завантаження vs. gmail-auto)
  • Статус (завершено, невдало, дублікат)

Усунення несправностей

Проблема Що перевірити
Комірки «missing» у сітці свіжості Чи було експортовано звіт із Google у цю дату? Перевірте Gmail на наявність листа.
Імпорт не вдається з помилкою валідації Невідповідність колонок. Порівняйте таблицю необхідних колонок із вашим CSV.
Імпорт Gmail показує «stopped» Перевірте /settings/accounts > вкладка Gmail. Можливо, потрібен перезапуск або повторна авторизація.
Відсоток покриття падає Звіти надходять, але за менше дат, ніж очікувалося. Перевірте розклад експорту в Google AB.

Пов'язане