Миграция на Adapty — это не только смена SDK. Сторонние инструменты аналитики и атрибуции, такие как Amplitude и Adjust, тоже требуют скоординированного переключения. При правильном подходе количество дублирующихся или пропущенных событий будет минимальным, а кампании не пострадают.

Сопоставьте события

В большинстве интеграций Adapty названия событий можно настраивать. Вы можете задать те же имена, которые уже используются в ваших дашбордах и кампаниях — аналитика и отчёты по кампаниям продолжат работать с теми же названиями событий после переключения. Полный список доступных событий в Adapty см. в разделе События.

Для Adjust интеграция использует идентификаторы событий вместо пользовательских названий. Перенесите существующие идентификаторы событий из дашборда Adjust в настройки интеграции Adapty. Подробнее см. в руководстве по интеграции с Adjust.

Как Adapty создаёт события интеграции

Чтобы отправить событие в интеграцию, Adapty должен иметь профиль пользователя. Профиль создаётся одним из двух способов:

• Исторический импорт: профиль создаётся при импорте исторических данных о транзакциях до запуска SDK.
• Взаимодействие через SDK: профиль создаётся автоматически, когда пользователь впервые открывает приложение с SDK Adapty.

Adapty узнаёт о покупках, совершённых в устаревшей системе, в режиме реального времени. Однако отправить событие в интеграцию он может только после того, как профиль покупателя будет создан. Профиль создаётся при первом запуске приложения с SDK Adapty. Пользователи, не обновившие приложение, не будут генерировать события интеграции.

Подготовка перед днём миграции

Исключите исторические события

Включите Exclude Historical Events в настройках интеграции. Это предотвратит отправку в интеграцию событий, относящихся к периоду до первой сессии пользователя с SDK Adapty.

Этот параметр особенно важен при историческом импорте, когда Adapty единовременно обрабатывает большой объём прошлых транзакций. Без него эти транзакции сгенерируют огромное количество событий в вашем инструменте аналитики.

Настройте интеграцию заранее

Adapty позволяет настраивать и тестировать интеграцию, не включая её. Вы можете задать учётные данные, маппинг событий и фильтры, не активируя интеграцию до нужного момента. Настройки сохраняются при включении, поэтому ничего не теряется, пока интеграция отключена.

Чтобы найти нужную интеграцию, см. разделы Интеграции атрибуции, Интеграции аналитики, Интеграции сервисов рассылок или Webhook и ETL-интеграции.

Переключение в день миграции

Отключите интеграцию в устаревшем решении и одновременно включите её в Adapty. Работа обоих решений одновременно приведёт к дублированию событий.

В день миграции приостановите крупные кампании по привлечению пользователей. Это снизит риск ошибок оптимизации кампаний из-за событий в окне перехода.

Чего ожидать

Некоторое количество пропущенных или дублирующихся событий интеграции при миграции неизбежно. При правильном переключении число затронутых событий будет незначительным.

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

Интеграции и серверные уведомления

Adapty рекомендует использовать интеграции, а не пересылать сырые серверные уведомления от сторов напрямую в инструменты аналитики или атрибуции.

Преимущества интеграций:

• Единый формат: события из всех сторов — App Store, Google Play, Stripe — используют одинаковый формат.
• Обогащённые данные: события включают данные, которые собирает Adapty, — например, состояние подписки и атрибуты пользователя. Сырые уведомления этого не содержат.