Быстрый старт

От нуля до первой атрибутированной установки — четыре шага. Предпосылка: у вас уже есть своя организация в кабинете (как её получить — на странице Доступ к кабинету). Эта страница даёт общую картину; подробные инструкции — на страницах «Первые шаги для разработчика» (для тех, кто подключает SDK) и «Первые шаги для маркетолога» (для тех, кто запускает кампании).

Шаг 1. Приложение в кабинете

В кабинете Tracehub откройте Трекинг → Приложения → Добавить приложение, укажите платформу и идентификатор (bundle ID для iOS, package name для Android).

После сохранения на карточке приложения появится токен приложения (appToken) — он понадобится на следующем шаге. Там же лежат готовые фрагменты кода инициализации SDK с уже подставленным токеном.

Шаг 2. SDK

Инициализация — одна строка в точке запуска приложения.

iOS:

import TracehubSdk

let config = TracehubConfig(appToken: "ВАШ_APP_TOKEN", environment: .production)
config.logLevel = .info
Tracehub.initSdk(config: config)

Android:

val config = TracehubConfig.Builder(
    context     = this,
    appToken    = "ВАШ_APP_TOKEN",
    environment = Environment.PRODUCTION,
)
    .setLogLevel(LogLevel.INFO)
    .build()

Tracehub.initSdk(config)

Web:

import Tracehub from "@tracehub/web-sdk";

Tracehub.initSdk({
  appToken: "ВАШ_APP_TOKEN",
  environment: "production",
});

Подробно — см. разделы «iOS SDK», «Android SDK» и «Web SDK». Для разработки и тестирования заведите в кабинете отдельное приложение (например «MyApp Test») и подставляйте его токен в отладочные сборки, а среду в них указывайте sandbox — см. страницу Первые шаги для разработчика.

Шаг 3. Источник и трекинг-ссылка

Маркетинг → Источники → Подключить источник — выберите рекламный кабинет (Яндекс Директ, VK Реклама). Затем создайте кампанию (Маркетинг → Кампании) и добавьте в неё источник: трекинг-ссылки создадутся автоматически — по одной на каждую платформу приложения, у которой заполнены ссылки на магазины. Если магазинов нет (например, приложение раздаётся APK), ссылку можно задать вручную.

Ссылка выглядит так:

https://links.tracehub.ru/l/{tracker_token}
  ?yclid={logid}
  &gps_adid={google_aid}
  &idfa={ios_ifa}
  &campaign_id={campaign_id}

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

Шаг 4. Проверка

Пройдите цепочку целиком: клик по трекинг-ссылке → установка → атрибуция к источнику → постбэк в рекламный кабинет. Пошаговый чеклист с местами, где всё это видно в кабинете, — на странице Проверка интеграции.

Следующие шаги

«Первые шаги для разработчика» — SDK, события, доход, проверка установки.
«Первые шаги для маркетолога» — рекламный кабинет, кампания, постбэки, дашборд.
«Проверка интеграции» — чеклист перед запуском трафика.
«Постбэки» — как отдать конверсии обратно в рекламный кабинет.
«Глоссарий» — если незнакомы термины «реатрибуция», «окно атрибуции», «CTIT».