Трекинг-ссылки и макросы

Трекинг-ссылка — то, что рекламный кабинет ставит в объявление. В момент показа кабинет подставляет в неё свои макросы; Tracehub принимает переход, сохраняет клик и позже сопоставляет его с установкой.

Готовая ссылка в кабинете

Собирать ссылку вручную не нужно. Откройте Кампании → нужная кампания → вкладка «Источники»: в колонке «Ссылка» у каждого источника два действия — «клик» (трекинг-ссылка для объявления) и «показ» (пиксель показа, см. ниже). Если ссылки ещё нет, там же есть кнопка «Создать ссылку». Скопированная ссылка уже содержит токен приложения и макросы из настроек источника — её можно сразу вставлять в рекламный кабинет.

Формат клик-ссылки

https://links.tracehub.ru/l/{tracker_token}
  ?app_token=<APP_TOKEN>
  &yclid={logid}
  &gps_adid={google_aid}
  &idfa={ios_ifa}
  &oaid={oaid}
  &android_id={android_id}
  &campaign_id={campaign_id}
  &adgroup_id={gbid}
  &creative_id={ad_id}

Слева от знака = — имя параметра, которое читает Tracehub. Справа в фигурных скобках — макрос кабинета, он заполняется на стороне рекламной сети. Набор макросов различается: пример выше — для Яндекс Директа.

app_token — токен приложения той платформы, для которой создана ссылка. Кабинет подставляет его в готовую ссылку сам.

Идентификатор клика

Распознаваемые имена:

Параметр	Источник
`yclid`	Яндекс Директ
`gclid`	Google
`mt_click_id`	myTarget
`vk_click_id`	VK Реклама
`fb_click_id`	Meta
`ttclid`	TikTok
`network_click_id`	универсальный — для сетей вне списка

Если в ссылке пришло сразу несколько таких параметров, Tracehub сначала смотрит имя, ожидаемое для вашей сети (оно определяется автоматически по маппингу макросов источника), а затем берёт первый непустой параметр по порядку таблицы; network_click_id проверяется последним.

Идентификаторы устройства

Параметр	Что это
`gps_adid`	Google Advertising ID (Android)
`idfa`	Identifier for Advertisers (iOS)
`idfv`	Identifier for Vendor (iOS)
`oaid`	Open Advertising ID (устройства HMS)
`android_id`	ANDROID_ID — универсальный резервный идентификатор
`gps_adid_md5`	md5 от GAID в нижнем регистре
`idfa_md5`	md5 от IDFA в верхнем регистре
`oaid_md5`	md5 от OAID в нижнем регистре

Хэшированные (*_md5) варианты принимаются для сетей, которые не передают сырой идентификатор. Если сеть отдаёт сырое значение — передавайте его.

Кампания, группа объявлений, креатив

Два семейства параметров — имена и числовые ID:

Параметр	Что это	Куда попадает
`campaign`	имя кампании в сети	ось «Кампания сети» в отчётах и макрос `{campaign_token}` в постбэках
`adgroup`	имя группы объявлений	ось «Группа объявлений»
`creative`	имя креатива	ось «Креатив»
`campaign_id`	числовой ID кампании в сети	сохраняется с кликом; в оси отчётов не попадает
`adgroup_id`	числовой ID группы объявлений	так же
`creative_id`	числовой ID объявления	так же

Если имена (campaign / adgroup / creative) в ссылке не переданы, в отчёты попадают значения из настроек ссылки — ID кампании, группы и креатива на стороне сети, заданные у источника кампании. Если сеть умеет подставлять имена (например, макрос {campaign_name}), передавайте их: так одна кампания не разъедется в отчётах на два значения между кликами и показами.

Параметры редиректа

Эти параметры не влияют на атрибуцию — они определяют, куда попадёт пользователь после клика:

Параметр	Зачем
`os_name`	`android` или `ios` — явное указание платформы. Любое другое значение игнорируется, тогда платформа определяется по User-Agent
`store`	подсказка магазина Android, например `store=rustore`. Нужна для RuStore: его установка не меняет User-Agent, и без подсказки пользователь уйдёт в Google Play
`deeplink_params`	URL-кодированные пары `key=value` — приложение получит их вместе с диплинком, см. страницу Диплинки и OneLink

Редирект выбирается так: Android — альтернативный магазин (если определился и для него задан URL), иначе Android URL; iOS — iOS URL; платформа не определилась — запасной URL. Все адреса задаются при создании ссылки; если не заполнить ни одного, они наследуются из магазинов приложения (вкладка «Магазины» в настройках приложения).

Лишние параметры

ip, user_agent, campaign_name на приёме клика не читаются. IP и User-Agent берутся из самого HTTP-запроса — передавать их параметрами бессмысленно.

Пиксель показа

Пиксель показа учитывает показы объявления — переходов по нему нет, картинка 1×1 пикселя загружается в момент, когда объявление показано. Зачем это нужно: атрибуция по показу (view-through). Если пользователь видел рекламу, не кликнул, но установил приложение в пределах окна показа — установка может быть атрибутирована этому показу. Клик всегда приоритетнее показа; окно показа настраивается там же, где остальные окна атрибуции.

Пиксель берётся в кабинете рядом с клик-ссылкой: Кампании → кампания → «Источники» → «показ». Он использует тот же tracker_token, что и клик-ссылка, — отдельную сущность создавать не нужно. Вставьте его в креатив как невидимую картинку (<img src="…">).

https://links.tracehub.ru/imp/{tracker_token}
  ?app_token=<APP_TOKEN>
  &gps_adid={google_aid}
  &oaid={oaid}
  &android_id={android_id}

Что пиксель принимает:

Параметры	Комментарий
идентификаторы устройства	те же, что на клике, плюс `gps_adid_sha1` (sha1 от GAID) — показ сопоставляется с установкой по устройству, а без идентификаторов — вероятностно по IP
`device_name`	модель устройства, если сеть её отдаёт
`campaign`, `adgroup`, `creative`	имена — как на клике; без них берутся значения из настроек ссылки
`yclid`	Яндекс Директ заполняет `{logid}` и на показах — передавайте: идентификатор вернётся в постбэке (`reqid`) при конверсии по показу

os_name, deeplink_params и числовые campaign_id / adgroup_id / creative_id на показе не читаются.

Показы видны и на дашборде: отдельной колонкой и в воронке «Показы → Клики → Установки». Среза по конкретной ссылке нет — показы разрезаются только по кампании сети, группе объявлений и креативу.

Параметры ссылки в аналитике

Откуда	Что	Куда попадает
из ссылки	идентификатор клика	сопоставление клика с установкой; возвращается сети в постбэке
из ссылки	идентификаторы устройства	точное сопоставление клика/показа с установкой
из ссылки	`campaign` / `adgroup` / `creative`	оси отчётов «Кампания сети», «Группа объявлений», «Креатив» и макросы постбэков
из ссылки	`campaign_id` / `adgroup_id` / `creative_id`	сохраняются с кликом, в оси отчётов не попадают
из ссылки	`deeplink_params`	передаются приложению вместе с диплинком
из настроек ссылки	рекламная сеть и кабинет	ось «Источник» в отчётах
из настроек ссылки	кампания Tracehub	страница кампании и её аналитика
из настроек ссылки	ID кампании/группы/креатива на стороне сети	значения по умолчанию для осей отчётов, когда имена не переданы в ссылке
из HTTP-запроса	IP и User-Agent	география и характеристики устройства

Install Referrer на Android

При редиректе в магазин Android Tracehub автоматически дописывает идентификатор клика в ссылку магазина: referrer= для Google Play и вендорских магазинов, referrerId= для RuStore. После установки SDK читает это значение из магазина — точное сопоставление установки с кликом, которое работает, даже когда рекламные идентификаторы недоступны. Настраивать ничего не нужно, работает и для переходов из встроенных браузеров TikTok / Instagram / Facebook.

Проверка ссылки

Перед запуском кампании пройдите по собранной ссылке с реального устройства и убедитесь, что клик появился в кабинете на странице кампании. Если клик виден, а установка потом уходит в органику — почти всегда дело в идентификаторе клика: он либо не подставился кабинетом, либо приехал под нераспознаваемым именем.