Диплинки и OneLink

Диплинк ведёт пользователя не просто в приложение, а на конкретный экран. 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: диплинки и атрибуция».

Приложение установлено. Короткая ссылка вида 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.

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