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

# UTM-метки и источники трафика

> Как платформа отслеживает источники трафика через utm_* параметры и где смотреть данные в аналитике школы

Платформа автоматически распознаёт и сохраняет UTM-метки из ссылок, по которым к вам приходят
посетители. Это позволяет понимать, из какого рекламного канала пришёл конкретный ученик и какой
источник принёс оплату — без установки дополнительных счётчиков.

## Как это работает

Когда пользователь открывает любую страницу школы, платформа читает параметры из адреса страницы
(query-строку) и заголовок реферера (referrer — сайт, с которого пришёл переход). Найденные метки
сохраняются в браузере посетителя и в cookie, а затем прикрепляются к его действиям — регистрации
и оплате.

<Steps>
  <Step title="Переход по ссылке с метками">
    Ученик открывает ссылку вида `https://school.ru/?utm_source=instagram&utm_medium=cpc&utm_campaign=autumn`.
  </Step>

  <Step title="Захват меток">
    При инициализации аналитики платформа вызывает захват UTM из текущего URL и сохраняет их
    (модель first-touch / last-touch, см. ниже).
  </Step>

  <Step title="Передача на сервер">
    С каждым запросом к API метки последнего касания передаются в служебном заголовке `utm-params`
    и фиксируются на стороне сервера в параметрах визита.
  </Step>

  <Step title="Привязка к событиям">
    При регистрации UTM сохраняются в карточке пользователя, при оплате — в карточке заказа.
  </Step>
</Steps>

### First-touch и last-touch

Платформа хранит два «касания» источника трафика одновременно:

| Касание         | Что означает                                                          | Когда обновляется                                                    |
| --------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **First-touch** | Самый первый источник, по которому пользователь впервые попал в школу | Записывается один раз и больше не перезаписывается                   |
| **Last-touch**  | Последний значимый источник перед действием                           | Перезаписывается, если у нового источника приоритет не ниже текущего |

Приоритет и «срок жизни» метки зависят от значения `utm_medium`. Например, платные каналы
(`cpc`, `paid`, `affiliate`, `paid_social`) имеют высокий приоритет и хранятся дольше (до 90 дней),
рассылки (`email`, `sms`, `push`) — средний приоритет и 14 дней, органика и соцсети
(`seo`, `social`, `organic`) — 30 дней. По истечении срока метка last-touch очищается,
а first-touch сохраняется.

<Note>
  Метки хранятся в браузере посетителя (localStorage + cookie). Если пользователь открыл школу в
  другом браузере или очистил данные сайта, история касаний в этом устройстве начнётся заново.
</Note>

## Поддерживаемые параметры

Из ссылки распознаются следующие параметры (значение каждого обрезается до 300 символов):

| Параметр       | Назначение                                                                               |
| -------------- | ---------------------------------------------------------------------------------------- |
| `utm_source`   | Источник трафика (например, `instagram`, `google`, `telegram`)                           |
| `utm_medium`   | Тип канала (`cpc`, `email`, `social`, `organic`, `referral` и др.)                       |
| `utm_campaign` | Название рекламной кампании                                                              |
| `utm_term`     | Ключевое слово / таргетинг                                                               |
| `utm_content`  | Идентификатор объявления или креатива                                                    |
| `gclid`        | Идентификатор клика Google Ads                                                           |
| `yclid`        | Идентификатор клика Яндекс.Директ                                                        |
| `fbclid`       | Идентификатор клика Facebook                                                             |
| `aff_id`       | Идентификатор партнёра (affiliate)                                                       |
| `sub_id`       | Дополнительная метка партнёрской ссылки                                                  |
| `track_id`     | Произвольный идентификатор для сквозной аналитики                                        |
| `referrer`     | Домен сайта-источника (заполняется автоматически, если UTM-меток нет, а переход внешний) |

<Tip>
  Если в ссылке нет ни одной UTM-метки, но переход пришёл с внешнего сайта, платформа сохранит
  только домен источника в поле `referrer`. Это помогает не терять органические переходы.
</Tip>

### Пример размеченной ссылки

```html theme={null}
https://school.ru/course/123
  ?utm_source=telegram
  &utm_medium=social
  &utm_campaign=webinar_oct
  &utm_content=post_pinned
```

## Где смотреть данные в админке

Собранные метки доступны владельцу школы в двух разделах управления.

### Список учеников

В разделе **«Моя школа» → «Пользователи»** в колонке регистрации у каждого ученика показывается
источник, по которому он зарегистрировался — в формате `utm_source / utm_medium / utm_campaign / utm_content`.
Если ученик пришёл напрямую и без меток, отображается пометка о прямой регистрации; если его добавил
менеджер вручную — показывается имя менеджера.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/exode-faq/images/online-schools/marketing/users-utm-column.png" alt="Колонка источника регистрации в списке учеников школы" />

Список можно **отфильтровать по UTM-меткам**: фильтр принимает набор пар «ключ — значение»
(например, `utm_source = instagram`), чтобы увидеть только учеников из конкретного канала.

### Карточка заказа

В разделе **«Заказы»** в информации о конкретном заказе выводится блок UTM-параметров, с которыми
была совершена оплата. Параметры показываются построчно в порядке
`utm_source → utm_medium → utm_campaign → utm_term → utm_content`. Список заказов также
поддерживает фильтрацию по UTM-меткам.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/exode-faq/images/online-schools/marketing/invoice-utm-block.png" alt="Блок UTM-параметров в карточке заказа" />

<Note>
  Отдельного сводного дашборда «трафик по источникам» с графиками в интерфейсе школы сейчас нет.
  UTM-данные доступны на уровне отдельных учеников и заказов (с возможностью фильтрации),
  а также передаются в подключённые внешние системы аналитики (например, Яндекс.Метрика)
  через стандартные параметры визита.
</Note>