Первые шаги для разработчика

Что подключить в приложении, чтобы Tracehub считал установки, события и доход. Порядок: SDK → тестовое приложение → события → доход → проверка установки. Предпосылка: у вас уже есть своя организация в кабинете (как её получить — на странице Доступ к кабинету). Примеры — на Swift; варианты для других языков и платформ — в разделах «iOS SDK», «Android SDK» и «Web SDK».

Токен приложения

Токен (appToken) лежит на карточке приложения: Трекинг → Приложения → выберите приложение. Там же — готовые фрагменты кода инициализации с подставленным токеном.

Токен — не для публичных репозиториев

Загружайте его из xcconfig, gradle.properties или менеджера секретов, а не храните строкой в коде.

Подключение SDK

Инициализируйте SDK в точке запуска приложения — до любых других вызовов:

import TracehubSdk

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

На время интеграции включите logLevel = .verbose — в логе видно каждый запрос SDK и ответы сервера. В релизной сборке верните .info или .none.

Отдельное приложение для тестирования

Для разработки и отладки заведите в кабинете второе приложение — например «MyApp Test» (Трекинг → Приложения → Добавить приложение) — и подставляйте его токен в отладочные сборки. Так проверки идут на собственных данных и не смешиваются с боевыми цифрами.

Среду в сборках указывайте так:

Среда	Когда использовать
.sandbox	Отладочные сборки
.production	Релизные сборки

Постбэки по тестовым событиям уходят рекламным партнёрам

Если к тестовому приложению подключены рекламные кабинеты, конверсии по тестовым установкам и событиям будут отправлены в них. Держите тестовое приложение без подключённых источников либо отключите отправку событий на вкладке «Постбэки» карточки источника.

Перед релизом переключите сборку

Убедитесь, что в релизной сборке стоит токен боевого приложения и environment: .production.

События

Событие — действие пользователя, которое вы хотите считать: завершение обучения, регистрация, покупка. У события есть токен — строка, которую вы передаёте в SDK:

Tracehub.trackEvent(TracehubEvent(eventToken: "tutorial_complete"))

Список событий приложения — на странице Трекинг → События: там видно количество за 24 часа и за 7 дней, там же событие можно переименовать или архивировать. Карточка события появляется в каталоге сама — обычно через несколько секунд после первой отправки из SDK; завести событие заранее нельзя. Если карточки нет, обновите страницу; иногда она появляется только после следующей отправки того же события.

События не привязываются к источнику по умолчанию

По умолчанию атрибутируются только установки. Чтобы событие участвовало в атрибуции и могло уходить постбэком в рекламную сеть, включите тумблер «В атрибуции» у этого события на странице «События».

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

let event = TracehubEvent(eventToken: "purchase")
event.deduplicationId = order.id
Tracehub.trackEvent(event)

SDK хранит последние 10 идентификаторов дедупликации и отбрасывает повторы.

Доход

Событие дохода — обычное событие с суммой и валютой:

let event = TracehubEvent(eventToken: "purchase")
event.setRevenue(4.99, currency: "USD")
event.deduplicationId = order.id
Tracehub.trackEvent(event)

Доход виден на дашборде (KPI «Доход» и «Доход по источникам»). Для событий покупок всегда задавайте deduplicationId — иначе повторная отправка задвоит доход.

Подписки App Store — отдельный вызов SDK, см. страницу iOS SDK: события и доход.

Для учёта дохода используйте обычное событие

Покупку отправляйте обычным trackEvent с суммой, валютой и deduplicationId, как в примере выше — тогда она полностью учтётся в доходе и отчётах.

Сессии и установка

Сессии SDK отслеживает автоматически: подписывается на переходы приложения в фон и обратно, новая сессия начинается после 30 минут отсутствия активности. Никаких вызовов из кода не нужно.

Установка засчитывается при первом запуске приложения с SDK на устройстве. Повторные запуски — это сессии, а не новые установки.

Удалить и поставить заново — это переустановка, а не установка

Такой запуск попадёт в метрику «Переустановки» и в «Установки» не попадёт. Если нужна именно новая установка, берите другое устройство или отдельное тестовое приложение. Переустановка за пределами окна переустановки считается обычной установкой и от первой уже неотличима.

Проверка установки

1. Соберите приложение с SDK и logLevel = .verbose.

2. Запустите на устройстве — в логе должен появиться успешный запрос сессии. Удобно подписаться на обратный вызов:

   config.sessionSuccessCallback = { session in
       print("Сессия отправлена, thid: \(session.thid ?? "-")")
   }

3. Откройте в кабинете Дашборд (вкладка «Обзор») — установка появится в KPI «Установки» обычно за 1–2 минуты, иногда до пяти минут. Если приложение уже стояло на этом устройстве, смотрите метрику «Переустановки».

4. Результат атрибуции можно прочитать прямо в приложении:

   config.attributionChangedCallback = { attribution in
       print("Сеть: \(attribution.network ?? "-"), кампания: \(attribution.campaign ?? "-")")
   }

Полная проверка цепочки с кликом и постбэком — см. страницу Проверка интеграции.

---