---
title: "Миграция интеграций на Adapty"
description: "Переключите интеграции с аналитикой и атрибуцией с устаревшего решения на Adapty без дублирования событий и нарушения работы кампаний."
---

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

## Сопоставьте события \{#map-your-events\}

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

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

## Как Adapty создаёт события интеграции \{#how-adapty-creates-integration-events\}

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

- **Исторический импорт**: профиль создаётся при [импорте исторических данных о транзакциях](importing-historical-data-to-adapty) до запуска SDK.
- **Взаимодействие через SDK**: профиль создаётся автоматически, когда пользователь впервые открывает приложение с SDK Adapty.

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

## Подготовка перед днём миграции \{#prepare-before-migration-day\}

### Исключите исторические события \{#exclude-historical-events\}

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

Этот параметр особенно важен при [историческом импорте](importing-historical-data-to-adapty), когда Adapty единовременно обрабатывает большой объём прошлых транзакций. Без него эти транзакции сгенерируют огромное количество событий в вашем инструменте аналитики.

### Настройте интеграцию заранее \{#set-up-the-integration-in-advance\}

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

Чтобы найти нужную интеграцию, см. разделы [Интеграции атрибуции](attribution-integration), [Интеграции аналитики](analytics-integration), [Интеграции сервисов рассылок](messaging) или [Webhook и ETL-интеграции](webhook-and-etl).

## Переключение в день миграции \{#switch-on-migration-day\}

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

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

## Чего ожидать \{#what-to-expect\}

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

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

## Интеграции и серверные уведомления \{#integrations-vs-server-to-server-notifications\}

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

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

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