Диплинки и OneLink

This content is not available in your language yet.

Диплинк ведёт пользователя не просто в приложение, а на конкретный экран. OneLink — единая короткая ссылка Tracehub: она сама определяет платформу и ведёт в нужный магазин или на запасной URL, а после установки приложение получает диплинк и открывает нужный экран.

Отличия OneLink от трекинг-ссылки

Трекинг-ссылка привязана к кампании и источнику — её место в объявлении рекламной сети. OneLink привязан к приложению и рекламного кабинета не требует: он для собственных каналов — рассылок, QR-кодов, соцсетей, сайта, блогеров. Формат:

https://links.tracehub.ru/ol/{onelink_token}

Создание в кабинете

Откройте раздел «Диплинки» в меню кабинета. Список привязан к приложению — выберите его в переключателе в шапке. Нажмите «Создать»:

Поле	Обязательное	Что указывать
Название	да	как ссылка будет подписана в списке
Deep link URL	да	экран приложения, который нужно открыть, — по схеме приложения, например `myapp://promo/q1`
Запасной URL	да	обычный `http(s)`-адрес — туда попадут десктоп и те, у кого платформа не определилась
iOS URL	нет	страница приложения в App Store
Android URL	нет	страница приложения в Google Play
Альтернативные магазины для Android	нет	адреса страниц в RuStore, Huawei AppGallery, Xiaomi GetApps, Samsung Galaxy Store, Vivo App Store

Готовая ссылка появится в колонке «Короткая ссылка», рядом — кнопка копирования. Там же в списке: «Клики · 7 дн.» и «Установки · 7 дн.», статус и запасной URL. Управление — в меню строки (⋯): редактировать, включить/выключить, скопировать URL, удалить.

Поведение при переходе

Платформа. Tracehub определяет её по User-Agent браузера. Если размещение позволяет, платформу можно указать явно параметром os_name=android или os_name=ios — явное значение приоритетнее User-Agent. На Android дополнительно определяется магазин: пользователи устройств Huawei, Xiaomi, Samsung, Vivo попадут в свой магазин, если для него задан URL. Для RuStore передавайте подсказку ?store=rustore — по User-Agent RuStore определить нельзя.

Приложение не установлено. Пользователь попадает в магазин своей платформы. При первом запуске после установки SDK получает отложенный диплинк — тот самый Deep link URL (плюс deeplink_params, если они были в ссылке) — и приложение может сразу открыть нужный экран. Диплинк приходит не мгновенно: SDK получает его вместе с данными атрибуции первого запуска. Если установка не атрибутирована, диплинка не будет — пользователь увидит обычный стартовый экран. Как обработать диплинк в коде — см. страницы «iOS SDK: диплинки и атрибуция» и «Android SDK: диплинки и атрибуция».

На Android установка связывается с переходом через Install Referrer магазина: при редиректе в Google Play, RuStore или вендорский магазин Tracehub дописывает в адрес идентификатор перехода (referrer=, для RuStore — referrerId=), а SDK после установки читает его из магазина. Это точное сопоставление, оно не зависит от рекламных идентификаторов и работает и для переходов из встроенных браузеров. Идентификатор дописывается к тому адресу, на который уходит переход с Android: к полю «Android URL», к альтернативному магазину, а если приложения нет в Google Play и поле «Android URL» пустое — к адресу магазина в поле «Fallback URL». Лендинг в поле «Fallback URL» не трогается. Настраивать ничего не нужно, но для RuStore приложение должно быть верифицировано в магазине, а в приложении подключён плагин RuStore Install Referrer — иначе магазин значение не отдаёт. Если в адресе магазина уже есть свой referrer, Tracehub его не трогает и идентификатор перехода не добавляет. На iOS такого механизма нет — там установка связывается с переходом по косвенным признакам.

Приложение установлено. Короткая ссылка вида links.tracehub.ru/ol/… открывает магазин приложений или запасной URL. Прямое открытие уже установленного приложения настраивается отдельно — если этот сценарий вам нужен, напишите в поддержку Tracehub.

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

Встроенные браузеры приложений (TikTok, Instagram, Facebook, WeChat) не открывают приложения по обычной ссылке. Таким браузерам Tracehub отдаёт специальную страницу: она пытается открыть приложение и, если не вышло, уводит в магазин. Настраивать это не нужно.

Параметры OneLink-ссылки

Параметр	Зачем
`os_name`	`android` / `ios` — явное указание платформы
`store`	подсказка магазина Android (например, `rustore`)
`deeplink_params`	URL-кодированные пары `key=value` — доедут до приложения вместе с диплинком
`gps_adid`, `idfa`, `idfv`	идентификаторы устройства, если размещение позволяет их подставить, — улучшают сопоставление с установкой

Статистика

Клики и установки по каждой ссылке — в разделе «Диплинки», колонки «Клики · 7 дн.» и «Установки · 7 дн.». Ноль означает ровно ноль: по ссылке пока не переходили. Прочерк вместо числа — статистика временно недоступна, обновите страницу позже.

Клик засчитывается на переходе по короткой ссылке: из браузера, мессенджера, рекламного объявления. Если приложение уже установлено и открывается по ссылке напрямую (Android App Links, iOS Universal Links), переход считается тогда, когда приложение передаёт ссылку в SDK — см. «Диплинки и атрибуция» для Android и iOS.

Чтобы установка засчиталась ссылке, Tracehub дописывает к вашему диплинку параметр th_ol — например, https://example.com/promo?th_ol=Hx7kQ2mZp1Ab. Приложение открывается по вашему собственному адресу, и только этот параметр говорит, от какой ссылки пришёл переход. Не вырезайте его при разборе диплинка и передавайте адрес в SDK целиком — иначе установка ссылке не засчитается.

Повторная установка на то же устройство в пределах окна реатрибуции (по умолчанию 90 дней) в колонку «Установки» не попадает: это тот же пользователь, а не новый. Чтобы проверить подсчёт установок, нужно устройство, на котором приложения не было, или новый эмулятор.

В общих отчётах установки по OneLink не образуют отдельного значения на оси «Источник»: OneLink — собственный канал без рекламного кабинета, такие установки попадают в органику. У них пустые «Кампания», «Кампания сети», «Группа объявлений» и «Креатив» — разделить кампании между собой в отчётах не получится. Если нужен раздельный учёт кампаний, используйте трекинг-ссылки. Статистика по конкретной ссылке — только в разделе «Диплинки».