adapty.activate() должен завершиться до вызова любого другого метода Adapty SDK. Пока он не выполнен, у SDK нет состояния. Любой вызов, сделанный до или параллельно с activate(), завершится ошибкой #2002 notActivated. Если ваше приложение аутентифицирует пользователей и вы получаете customer user ID после запуска, вызовите adapty.identify() в этот момент. Не вызывайте методы, требующие действий пользователя, пока identify не завершится. Вызовы, выполняемые параллельно с ним, либо завершаются ошибкой #3006 profileWasChanged, либо применяются к анонимному профилю, созданному при активации. В этом случае атрибуция, MMP ID вроде appsflyer_id и привязка установки не всегда переносятся на идентифицированный профиль. Если ваше приложение не аутентифицирует пользователей, пропустите identify и продолжайте работать с анонимным профилем. MMP и аналитические SDK (AppsFlyer, Adjust, Branch, PostHog) подчиняются тому же правилу. Сначала инициализируйте их и дождитесь колбэков с UID, и только потом вызывайте adapty.activate. Иначе MMP ID попадёт в краткий анонимный профиль и не всегда переносится в идентифицированный. Подробнее об особенностях AppsFlyer — в разделе AppsFlyer.

Правильный порядок

Ваш путь зависит от двух вещей: когда вы узнаёте customer user ID и используете ли вы MMP или аналитический SDK.

• Шаги 2 и 5: Обязательны для каждого приложения. Активируйте SDK, затем вызывайте его методы.
• Шаги 1 и 3: Нужны только при интеграции MMP или аналитического SDK (AppsFlyer, Adjust, Branch, PostHog).
• Шаг 4: Нужен только если ваше приложение аутентифицирует пользователей и получает customer user ID после запуска. Если идентификатор пользователя известен при запуске приложения, передайте его напрямую в activate() (шаг 2a). В этом случае анонимный профиль не создаётся, поэтому шаг 4 не нужен. | Шаг | Вызов | Когда | Примечания | |------|---------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| | 1 | Инициализируйте MMP или аналитический SDK (AppsFlyer, Adjust, PostHog, Branch) | При запуске приложения, первым делом | Дождитесь колбэка с UID от MMP, например getAppsFlyerUID. | | 2a | adapty.activate('YOUR_PUBLIC_SDK_KEY', { customerUserId: 'YOUR_USER_ID' }) | При запуске приложения, после шага 1, если у вас есть customer user ID | Рекомендуется. Анонимный профиль не создаётся никогда. | | 2b | adapty.activate('YOUR_PUBLIC_SDK_KEY') без customerUserId | При запуске приложения, после шага 1, если у вас нет customer user ID (или вы его не собираете) | Adapty создаёт анонимный профиль. | | 3 | adapty.updateAttribution(data, source, networkUserId) для каждого MMP | После шага 2, до любых вызовов, связанных с действиями пользователя | Обязательно, чтобы идентификаторы MMP попали в нужный профиль. | | 4 | await adapty.identify('YOUR_USER_ID') | После шага 3 (или шага 2, если MMP нет), до шага 5 — только на пути 2b с аутентификацией | Всегда используйте await. Параллельные вызовы во время identify приводят к ошибке #3006 profileWasChanged. | | 5 | getPaywall, getPaywallProducts, restorePurchases, makePurchase, updateAttribution, updateProfile | После шага 4, если вы вызываете identify; иначе — после шага 3 (или шага 2, если MMP нет) | Этим вызовам необходим стабильный профиль. |

Установки через web2app и веб-воронки

Если пользователь совершает покупку через веб-чекаут (Stripe, Paddle) и после этого устанавливает нативное приложение, первый вызов activate() на устройстве создаёт новый анонимный профиль. Этот профиль не связан с веб-профилем. Если вы можете определить customer user ID до запуска приложения (из вашего флоу авторизации или install referrer), передайте его напрямую в activate(). В противном случае веб-покупка останется невидимой на устройстве, пока вы не вызовете identify('YOUR_USER_ID'), а затем restorePurchases.

О том, какие метаданные нужно передавать при каждом веб-чекауте, читайте в статьях:

• Stripe
• Paddle