Трекинг-ссылки и Клики: каждый переход — в данные

Трекинг-ссылка - входная дверь воронки. Каждый платный переход проходит через неё, за миллисекунды получает click id, и всё, что случится дальше - нажатие Start, регистрация, депозит - прицепится именно к этому id. Если клики ловятся криво, ниже по воронке уже ничего не починить: это денежный слой всей связки.

Что такое трекинг-ссылка

Каждая кампания при создании автоматически получает персональный brandless-хост - случайный восьмисимвольный сабдомен на нейтральном домене, поэтому в рекламном URL нет бренда трекера (модерация такое любит). Любой путь на этом хосте ведёт в ту же кампанию, а классический /r/campaign_id продолжает работать как постоянный запасной вариант для старых рекламных креативов. Ссылка лежит на странице Кампании: колонка «Ссылка отслеживания» показывает хост, рядом кнопки копирования и открытия - при копировании платформа подтягивает каноничный URL с сервера («Ссылка отслеживания скопирована»).

Что фиксируется на клике

• sub1-sub5 и ref_id - query-параметры до 255 символов каждый: сюда кладут крео, адсет, источник или id из внешнего трекера. За слишком длинный параметр клик никогда не отклоняется - всё, что не влезло, просто обрезается.
• Платформенные click id: fbclid (Meta), gclid, gbraid и wbraid (Google, включая iOS-privacy трафик, для которого gclid не приходит), ttclid (TikTok) - именно по ним серверные конверсии потом матчатся с кликом по объявлению.
• User agent фиксируется на каждом клике. Geo задуман как двухбуквенный код страны, но зависит от заголовка X-Geo-Country, который прод пока не выставляет, поэтому на практике колонка geo приходит пустой - считайте это текущим ограничением платформы, а не проблемой конкретной кампании.

sub4, sub5, ref_id и платформенные click id не показываются ни в таблице «Клики», ни в экспорте CSV - там видны только sub1-sub3. Чтобы убедиться, что клик действительно поймал fbclid или gclid, проверяйте это ниже по цепочке: шаблоны URL в постбэках принимают {sub4}, {sub5}, {platform}, {fbclid}, {gclid}, {gbraid}, {wbraid} и {ttclid} как макросы и подставляют то, что реально записал клик.

Сам редирект - это 302 с бюджетом меньше 10 мс: запись клика в базу идёт асинхронно, чтобы посетитель не ждал обращения к БД. Если в кампании задан URL редиректа, посетитель уходит сразу туда с подставленными {click_id} и {campaign_id}; иначе он попадает на hosted-лендинг, где переход по кнопке открывает Telegram с click id, зашитым в стартовую ссылку бота. Клики принимают только активные кампании: кампания на паузе или в архиве отвечает 404, и клик не записывается.

Работа со страницей «Клики»

1. Откройте Клики. Счётчик «Уникальные» показывает объём кликов под текущими фильтрами.
2. Сужайте выборку фильтрами «Статус» и «Кампания» и диапазоном дат в UTC; поиск ищет по ID, кампании, sub1 и geo.
3. Фильтры хранятся в URL, так что достаточно скопировать адресную строку - и коллега откроет ровно тот же срез: «кампания X, FTD, прошлая неделя» превращается в ссылку вместо инструкции.
4. Колонки таблицы: «Создан», «Кампания» (отображается по имени), Sub1-Sub3, Geo, «Статус». Пагинация: 25/50/100 строк или «Все».

Фильтр статуса перечисляет Клик, Лендинг, Старт, Лид, Депозит и FTD. Регистрация - реальный шаг воронки (см. ниже), но отдельного пункта фильтра для неё пока нет: если нужно вычленить именно её, экспортируйте CSV и отфильтруйте колонку статуса.

Статусы клика

Клик идёт по воронке: Клик → Лендинг → Старт → Регистрация → Лид → Депозит → FTD. Статус двигается только вперёд - поздний или повторный ивент никогда не откатит FTD обратно в лид. Статус продвигают события: создавайте их из узлов «Триггер события» флоу либо репортите server-to-server через API событий.

Экспорт CSV

Кнопка «Экспорт CSV» выгружает все строки под текущими фильтрами, а не только видимую страницу: колонки id, campaignId, sub1-sub3, geo, status, createdAt. Удобно, чтобы свести спенд против FTD по sub1 в таблице.

Частые ошибки

• «Ссылка внезапно умерла». Сначала проверьте статус кампании - пауза или архив дают 404 сразу, так и задумано.
• Обрезанные sub-параметры. Всё, что длиннее 255 символов на параметр, отсекается, а сам клик всё равно проходит - держите метки компактными.
• Rate limit на тестах. Кликовый endpoint пускает 60 запросов в минуту с одного IP; если долбить его с одной машины, вернётся 429, и это ничего не скажет о реальном трафике.
• Поиск против фильтров. Строка поиска фильтрует только уже загруженные на странице строки; фильтры статуса/кампании/даты идут запросом к серверу. На больших аккаунтах сначала фильтруйте, потом ищите.
• Пустая колонка geo. Захват страны на проде пока не подключён, поэтому поле geo и в кликах, и в экспорте CSV приходит пустым - сейчас это ожидаемо, а не проблема конкретной кампании.
• Мост во внешний трекер. Если клики уходят дальше в Keitaro или подобный трекер, вставьте {click_id} в URL редиректа кампании - тогда конверсию можно будет отправить обратно.