Как установить SDK и подружить трекер атрибуции с мобильным приложением
SDK — это код, связующее звено между трекером и вашим приложением, которое фиксирует действия пользователей и отправляет данные для анализа. Но интеграция SDK — это больше, чем просто копирование кода: тут важны детали. В статье расскажем, как правильно установить SDK для интеграции трекера и не допустить ошибки.
Что такое SDK, и зачем он нужен
SDK (Software Development Kit) — это набор готовых инструментов для разработки, который включает в себя библиотеки, документацию и примеры кода. В контексте аналитики и маркетинга SDK позволяет приложению собирать и передавать данные о действиях пользователя в различные сервисы: трекеры, BI-системы или системы автоматизации.
У каждого трекера свой SDK, причем для Android и iOS они разные. Установить его можно двумя способами:
- Использовать специальные сервисы для автоматической установки.
- Вручную добавить в приложение.
Нельзя просто взять и вставить код — нужно правильно настроить архитектуру приложения, чтобы оно могло работать с SDK. Как это сделать, обычно подробно описано на сайте вашего трекера. Инструкции очень подробные, а информация внутри постоянно обновляется, поэтому нет смысла переписывать ее сюда полностью, но разберем основные моменты на примере SDK AppsFlyer для Android.
Как установить SDK: пошаговая инструкция
Прежде чем погружаться в установку, проверьте версию операционной системы приложения. Например, для SDK AppsFlyer нужен минимум Android 4.4 или iOS 9+. Если версия ниже — придется сначала обновить само приложение.
Шаг 1. Устанавливаем сборщик
Сначала нужно установить специальную программу-сборщик — она автоматически добавит SDK в нужное место кода. Для Android AppsFlyer предлагает Gradle, для iOS — CocoaPods. Какой именно выбрать, подскажет документация вашего трекера.
Шаг 2. Подключаем репозиторий в сервисе сборки
Для того, чтобы приложение где искать SDK нужно создать репозиторий. Репозиторий задают кодом, который вставляют в проект приложения.
AppsFlyer поддерживает репозиторий Maven Central, поэтому в проект вставляем код:
repositories {
mavenCentral()
Шаг 3. Добавляем зависимость
Теперь указываем точный адрес SDK в репозитории, чтобы помочь приложению его найти. Для этого в проект добавляем зависимость. Копируем еще один короткий код с сайта трекера и вставляем в раздел dependencies.
Не путайте с «полной» версией SDK — зависимость намного компактнее
Код для копирования можно найти в блоке сайта о сервисах сборки.
У AppsFlyer это будет:
implementation 'com.appsflyer:af-android-sdk:6.9.0'
Если не хотите возиться со сборщиками, можно пойти другим путем: скачать SDK целиком и добавить вручную в раздел libs как библиотеку.
На этом основная часть установки закончена. Дальше настраиваем интеграцию.
Как настроить интеграцию
- Выбор рекламной площадки. В интерфейсе трекера найдите свое приложение (оно появится после установки SDK) и выберите из списка площадку. Проверьте, поддерживает ли ваш трекер нужные площадки, чтобы избежать проблем — например, AppMetrica не работает с Facebook и Instagram (Meta запрещена в России). А некоторые иностранные трекеры не работает с российскими источниками.
- Создание «умной ссылки» для магазинов приложений. Укажите ссылки на Google Play и App Store — трекер создаст свою ссылку, чтобы пользователи Android переходили в Google Play, а пользователи iOS — в App Store.
- Вставка «ключа разработчика», который подтверждает, что вы управляете приложением и разрешаете его трекинг. Скопируйте уникальный идентификатор приложения из личного кабинета трекера и добавьте его в код. Передавайте идентификатор только проверенным ребятам, исключительно для работы. После вставки «ключа» убедитесь, что настройки корректные — ссылки работают правильно, приложение верное.
После вставки идентификатора — трекер начнет сбор данных.
Важно: у каждого трекера свои инструкции, которые периодически обновляются.
Изучайте официальные руководства на сайте трекера перед интеграцией и копируйте код только оттуда. Если настройка кажется сложной, лучше обратиться к разработчику.
Что делать, если трекер работает некорректно
Иногда трекер может давать сбои: замедляться, пропускать события, ошибочно определять нормальный трафик как фрод и так далее.
Обычно это связано с такими причинами:
- Старая версия SDK. Трекеры регулярно обновляются, и с новыми версиями SDK часто исправляются баги и добавляются улучшения. Если пропустить обновление, могут возникать ошибки. Иногда разработчики прямо указывают на необходимость обновления для исправления конкретных проблем — следите за новостями.
- Технические проблемы. Подписка на e-mail-рассылку трекера — отличный способ узнавать о сбоях и обновлениях, поскольку в интернете может быть пусто.
Если проблема возникла, но в официальных источниках ничего не написано, посмотрите профессиональные чаты по рекламе, например, в Telegram. Там можно узнать, кто уже сталкивался с похожими проблемами, и получить совет или контакт техподдержки трекера.
Причины снижения конверсии: виноват не всегда трекер
Если вас беспокоит только падение конверсии, не стоит сразу обвинять трекер — возможно, дело в рекламной кампании.
Вот основные причины:
- Креативы «выгорели». Пользователи видели вашу рекламу несколько раз, но не совершили действие (посмотрели страницу приложения в сторе и решили, что оно не отвечает их интересам; устали от рекламы; поймали «баннерную слепоту» из-за постоянного повторения одних и тех же креативов и так далее.) Если люди не переходят по объявлению, стоит обновить креативы или попробовать другие рекламные каналы.
- Выросла конкуренция. Если новые рекламодатели начали работать на аналогичную ЦА в вашем источнике, ставки могут повыситься. В таких случаях нужно пересмотреть ограничение бюджета, которое вы установили ранее, иначе количество событий может сократиться.
- Слабая страница приложения в магазине. Если описание и скриншоты приложения не показывают его ценность — это может отпугнуть пользователей. Проверьте соотношение переходов и установок. Если переходов много, но мало установок, возможно, нужно доработать страницу приложения.
Кроме того, трекер может казаться «некорректным» из-за расхождения данных с рекламной сетью. Слово «некорректно» в кавычках, потому что трекинговая система функционирует исправно, но фиксирует события иным способом, чем рекламная площадка. Это приводит к ошибкам в аналитике, затрудняя планирование продвижения и стратегического развития.
Эта проблема возникает потому что:
- Разные часовые пояса. В рекламном кабинете и трекере может быть указано разное время, из-за чего события фиксируются в разные дни. Проверьте настройки и установите одинаковые часовые пояса.
- Отличия в подсчете фрода. Площадки и трекеры по-разному определяют некачественный трафик, и с этим ничего не поделаешь. Главное — следить, чтобы разница не была больше обычной для вашей комбинации трекера и площадки. Если растет, ищите виноватого — это трекер или источник.
- Разная логика атрибуции. Например, рекламная сеть засчитывает установку сразу, а трекер — только когда пользователь скачает и откроет приложение. Учтите это при анализе данных.
Для решения можно вычислить среднее расхождение в процентах, чтобы определить «коэффициент» для каждого источника. Умножая число событий на этот коэффициент, вы получаете показатели, согласованные с данными трекера. Эти коэффициенты позволяют сравнивать разные рекламные площадки, приближая данные к единому стандарту.
Вывод
Интеграция трекера с приложением — процесс простой, если четко идти по инструкции. Однако даже при правильной настройке возможны случаи некорректной работы. Это может происходить из-за различий в функционировании трекера и рекламной площадки или иногда из-за технических сбоев.
Поэтому настройка SDK — лишь первый этап работы с интеграцией. Важно регулярно проверять расхождения и контролировать процесс. Так трекер будет отображать точную аналитику, что поможет привлечь больше пользователей и повысить доходы.