> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Отчёты

> Журналы конверсий и кликов: входящие постбеки, доставка в Facebook CAPI, клики с гео и устройствами, фильтры-конструктор и экспорт в CSV.

Отчёты это два журнала внутри трекера: «Конверсии» и «Клики». Они показывают сырые события трафика построчно:
какой клик пришёл, кто запустил бота, какой постбек прислала партнёрка и что платформа с ним сделала. Здесь вы
проверяете спорные случаи и выгружаете данные, а не смотрите агрегаты (для агрегатов есть
[Дашборд трекера](/ru/tracker)).

## Где найти

В левом меню компании откройте «Трекер», затем вкладку «Отчёты». Внутри раздела вверху две подвкладки:

<Columns cols={2}>
  <Card title="Конверсии" icon="receipt">
    Журнал постбеков от партнёрок и исходящих событий в Facebook CAPI. Открывается по умолчанию.
  </Card>

  <Card title="Клики" icon="arrow-pointer">
    Журнал всех кликов по трекинговым ссылкам с гео, устройством и sub-параметрами.
  </Card>
</Columns>

<Info>
  Отчёты видят роли с tracker-доступом: «Байер», «Тимлид-байер» и администраторы компании. Оператору без
  tracker-доступа трекер не показывается. О выдаче доступа смотрите [Настройки](/ru/settings).
</Info>

## Общие инструменты обоих журналов

Оба журнала устроены одинаково и делят один набор инструментов сверху.

| Инструмент        | Что делает                                                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Период**        | Пресеты «Сегодня», «Вчера», «7 дней», «30 дней», «Всё время», «Произвольный». По умолчанию журнал открыт на последних 24 часах. |
| **Поиск**         | Быстрый поиск по строке (в конверсиях по `click_id`, в кликах по `click_id` или sub-параметрам).                                |
| **Фильтр**        | Конструктор условий из полей и операторов (подробно ниже).                                                                      |
| **Колонки**       | Кнопка показывает и прячет колонки таблицы. Выбор запоминается для этой компании.                                               |
| **Экспорт CSV**   | Выгружает текущую выборку в CSV-файл.                                                                                           |
| **Загрузить ещё** | Журнал грузится страницами по 50 строк, кнопка догружает следующую.                                                             |

<Tip>
  Строку в любом журнале можно развернуть кликом: раскроется карточка со всеми полями события. В конверсиях это
  сырые параметры постбека, тело запроса в Facebook и ответ; в кликах это полная карточка клика по группам
  (гео, устройство, sub-параметры, FB, подписчик, флаги).
</Tip>

## Конверсии (Conversions Log)

Журнал сводит в одну ленту два потока событий:

<Columns cols={2}>
  <Card title="Входящие" icon="arrow-down-left">
    Постбеки от партнёрских сетей: регистрация, FTD, RD. Платформа сопоставляет их с подписчиком по `click_id`.
  </Card>

  <Card title="Исходящие" icon="arrow-up-right">
    События, которые платформа отправляет обратно в Facebook через Conversion API (CAPI) по FB-кампаниям.
  </Card>
</Columns>

Направление переключается фильтром «Все / Входящие / Исходящие». В таблице входящие помечены стрелкой внутрь,
исходящие стрелкой наружу.

### Колонки

По умолчанию видны: время, направление, `click_id`, результат обработки, источник, кампания. Через кнопку
«Колонки» можно добавить «Тип» (статус события) и «Ошибка» (текст ошибки, если событие не прошло).

### Результат обработки входящего постбека

Колонка «Результат» показывает, что платформа сделала с постбеком. Это главный ответ на вопрос «партнёрка
говорит, что отправила FTD в 17:42, а я его не вижу».

| Результат                | Что значит                                                                                |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| **success**              | Постбек принят и привязан к подписчику.                                                   |
| **no\_click\_match**     | `click_id` из постбека не найден: клик к платформе не приходил или id указан неверно.     |
| **duplicate**            | Такое событие уже приходило раньше, повтор отклонён.                                      |
| **invalid\_status**      | Партнёрка прислала статус, который платформа не принимает.                                |
| **invalid\_token**       | Постбек пришёл с неверным ключом партнёрки.                                               |
| **rejected\_transition** | Недопустимый порядок событий по этому клику (например, повторный депозит раньше первого). |
| **rate\_limited**        | Слишком частые постбеки, часть отклонена по лимиту.                                       |
| **error**                | Внутренняя ошибка обработки.                                                              |

### Исходящие в Facebook CAPI

Для строк направления «Исходящие» тот же столбец показывает статус доставки в Facebook: «Отправка» (в
процессе), «Доставлено» (Facebook принял), «Ошибка» (не удалось отправить). Ту же доставку видно на странице
самой кампании в блоке «Доставка в Facebook CAPI». Про то, какие события уходят в CAPI и как это настроить,
смотрите [Трекер и кампании](/ru/tracker) и [Постбеки](/ru/postbacks).

<Note>
  Поиск в конверсиях идёт по точному `click_id`. Вбейте id спорной сделки, и вы одним запросом увидите весь его
  след: пришёл ли постбек, с каким результатом, ушло ли событие в Facebook. Если журнал открыт узким периодом,
  а строки нет, переключите период на «Всё время»: постбек мог прийти раньше.
</Note>

## Клики (Click Log)

Журнал всех кликов по трекинговым ссылкам компании. Каждому клику присвоен `click_id`, к которому потом
привязываются запуск бота, подписчик и конверсии.

### Колонки

Колонок много, набор настраивается кнопкой «Колонки». Они покрывают почти всю карточку клика:

<Columns cols={2}>
  <Card title="Идентификация" icon="fingerprint">
    Время, `click_id`, IP, Referer, User-Agent, кампания, бот, источник.
  </Card>

  <Card title="Гео" icon="location-dot">
    Страна, город, регион, язык, ASN и AS Organization (сеть-провайдер).
  </Card>

  <Card title="Устройство" icon="mobile">
    Тип устройства, модель, ОС и версия, браузер и версия.
  </Card>

  <Card title="FB-разбивка" icon="facebook">
    `fb_campaign`, `fb_adset`, `fb_ad`, плейсмент. Значения приходят от макросов Facebook.
  </Card>

  <Card title="Sub-параметры" icon="tags">
    `sub1` … `sub5` из вашей трекинговой ссылки.
  </Card>

  <Card title="Подписчик и флаги" icon="user-check">
    Подписчик (если клик дошёл до бота), «Уник», признаки бота и прокси, «LP view».
  </Card>
</Columns>

Бейдж в колонке «Подписчик» ведёт к переписке с этим человеком (см. [Сообщения](/ru/messenger)). Признаки
«Бот» и «Прокси» помечают подозрительный трафик, «Уник» отмечает первый клик с этого устройства, «LP view»
означает, что клик реально дошёл до просмотра лендинга.

### Тип клика: лендинг, /start, органика

Клик по лендингу и запуск бота это разные события, и в журнале они различаются колонкой «Тип» (source\_kind):

| Тип           | Что это                                                                                               |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| **Landing**   | Реальный HTTP-клик по трекинговой ссылке (обычно через лендинг с пикселем).                           |
| **TG /start** | Прямой запуск бота по ссылке `t.me` с кодом кампании, без лендинга. Это уже вход в воронку.           |
| **Organic**   | Запуск бота без кампании: человек нашёл бота сам и написал `/start`. Попадает в системную «Органику». |

<Note>
  Клик по лендингу это промо-хит, он может не дойти до бота. Запуск бота через `/start` создаёт подписчика
  (Subscriber) и открывает воронку. Живую ленту событий с раздельными вкладками «Клики» и «Запуски бота» вы
  найдёте в блоке «Активность» на [Дашборде трекера](/ru/tracker); клик по строке ведёт в Click Log,
  отфильтрованный по этому `click_id`.
</Note>

<Tip>
  Поиск в кликах ищет по `click_id` или по любому из sub-параметров. Когда вы вводите поисковый запрос, период
  автоматически переключается на «Всё время», чтобы нужный клик не отсёкся 24-часовым окном. Стёрли запрос,
  период вернётся к последним 24 часам.
</Tip>

## Фильтр-конструктор

Кнопка «Фильтр» открывает конструктор условий. Вы собираете правило из трёх частей: поле, оператор и значение,
условия объединяются логикой «И» или «ИЛИ» и группируются в подгруппы для смешанной логики. Так вы находите,
например, все клики из нужного adset за последние сутки, у которых нет подписчика, за пару секунд.

Поля сгруппированы по смыслу: Идентификация, Гео, Устройство, Флаги, FB, Sub-метки, Подписчик. В журнале
конверсий фильтруются `click_id`, кампания, источник, результат обработки, статус и текст ошибки.

Операторов шестнадцать (набор как в Keitaro), доступный набор зависит от типа поля:

| Группа      | Операторы                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------- |
| **Текст**   | равно, не равно, содержит, не содержит, начинается с, заканчивается на, соответствует regex, не соответствует regex |
| **Списки**  | имеет любой из, не имеет ни одного из                                                                               |
| **Числа**   | больше, меньше, больше или равно, меньше или равно                                                                  |
| **Пустота** | пусто, заполнено                                                                                                    |

## Экспорт в CSV

Кнопка «Экспорт CSV» выгружает текущую выборку с учётом всех фильтров, периода и поиска. Выгрузка отдаёт до 200
строк за раз, поэтому для больших срезов сначала сузьте выборку фильтром или периодом. Файл открывается в
Excel, Google Sheets или загружается в ваш трекер.

<Warning>
  `click_id` это денежный идентификатор атрибуции: он привязывает будущий депозит к конкретному подписчику и
  кампании. В отчётах его можно только смотреть и искать по нему, подменять вручную нельзя, иначе деньги
  привяжутся не к тому человеку. Подробнее в разделе [Постбеки](/ru/postbacks).
</Warning>

## Видимость по роли

Журналы показывают только те данные, к которым у вас есть доступ.

| Роль                       | Что видно в отчётах                                                                           |
| -------------------------- | --------------------------------------------------------------------------------------------- |
| **Байер**                  | Клики и конверсии только своих кампаний. Технические детали постбека показываются сокращённо. |
| **Тимлид-байер**           | Кампании всех своих байеров и свои.                                                           |
| **Администратор компании** | Все клики и конверсии компании, с полными сырыми деталями.                                    |

<Info>
  Роли и tracker-доступ выдаются отдельно от ролей в команде. Как это настроить, смотрите
  [Настройки](/ru/settings).
</Info>

## Что дальше

<Columns cols={2}>
  <Card title="Трекер и кампании" icon="chart-line" href="/ru/tracker">
    Дашборд, метрики воронки, кампании и трекинговые ссылки, откуда берутся эти клики и конверсии.
  </Card>

  <Card title="Постбеки" icon="webhook" href="/ru/postbacks">
    Как партнёрка шлёт события на вашу постбек-ссылку и как их читать в журнале конверсий.
  </Card>

  <Card title="Кампании" icon="bullseye" href="/ru/campaigns">
    Настройка источников, лендингов и FB Pixel, разбивки на странице кампании.
  </Card>

  <Card title="Фильтры и сегменты" icon="filter" href="/ru/filters">
    Тот же конструктор условий для сегментации подписчиков и рассылок.
  </Card>
</Columns>