Трекінг-посилання і Кліки: кожен перехід — у дані

Трекінг-посилання - вхідні двері вашої воронки. Кожен платний перехід проходить крізь нього, за мілісекунди отримує 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 назад у Лід. Статуси просувають події: запускайте їх із вузлів «Тригер події» у Флоу або надсилайте серверно через events 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 редиректу» кампанії, щоб потім можна було повернути конверсію назад.