Обработка ошибок в интеграциях

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

Расхождение данных

Причина: Это может происходить из-за того, что не все пользователи используют версию приложения с Adapty SDK.

Решение: Чтобы обеспечить согласованность данных, вы можете принудительно обновить приложение пользователей до версии с Adapty SDK.

Сетевые ошибки

Причина: Скорее всего, это связано с отсутствием интернет-соединения между сервером Adapty и сервером интеграции.

Решение: Такие проблемы обычно быстро проходят и затрагивают лишь небольшое число событий.

Сервер интеграции не смог обработать событие

Причина: Интеграция настроена некорректно.

Решение: Обратитесь к статье об этой интеграции в нашей документации. Убедитесь, что вы выполнили все шаги настройки как в дашборде Adapty, так и на стороне стороннего инструмента и в коде приложения.

Отсутствующие данные интеграции

Причина: В профиле отсутствует ID, специфичный для данной интеграции. Это может происходить, если интеграция настроена некорректно в коде приложения.

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

Отсутствующие учётные данные интеграции

Причина: Некоторые учётные данные интеграции отсутствуют или указаны неверно.

Решение: Проверьте все учётные данные для этой интеграции в дашборде Adapty. Проблема может быть связана с несоответствием версии или среды.

Срок действия события истёк

Причина: В настройках интеграции включена опция Exclude historical events, а дата создания события предшествует дате создания профиля в нашей системе.

Это может происходить, если цепочка транзакций, начавшаяся много лет назад, поступает в Adapty через валидацию чека для профиля, созданного недавно.

Решение: Убедитесь, что это не происходит для новых событий. Если вы хотите отправлять исторические события в интеграцию, отключите Exclude historical events.

Отключённый или неподдерживаемый тип события

Причина: Либо это событие не поддерживается данной интеграцией, либо вы отключили его при настройке интеграции.

Решение:

Проверьте, поддерживает ли интеграция данный тип события. Следующие события доступны не во всех интеграциях:
- access_level_updated: только для вебхука.
- Синтетические события (trial_active, subscription_active): Adjust, Amplitude, AppMetrica, AppsFlyer, Branch, Facebook Analytics, Firebase, Mixpanel, OneSignal, PostHog, Singular, SplitMetrics и вебхук.
Если интеграция поддерживается, убедитесь, что событие включено в настройках интеграции.

Синтетическое событие не пришло

Причина: Синтетические события срабатывают один раз, по таймеру, и четыре ситуации останавливают их без ошибки:

Пробный период или подписка завершились до истечения задержки. Конвертированная, истёкшая или возвращённая покупка ничего не порождает, и Adapty больше не проверяет. Вместо этого ищите trial_converted, trial_expired, subscription_expired или subscription_refunded.
Пользователь отключил автопродление до истечения задержки. Доступ действует до конца оплаченного периода, но Adapty пропускает отправку. Вместо этого ищите trial_renewal_cancelled или subscription_renewal_cancelled.
Вы включили событие после того, как покупка уже была совершена. Adapty запускает таймер, когда приходит trial_started или subscription_started, поэтому событие генерируется только для покупок, сделанных после включения.
Вы изменили задержку после того, как покупка уже была совершена. Уже запланированные отправки сохраняют ту задержку, с которой были созданы.

Решение: Это не сбои доставки, поэтому повторять отправку нечего, и в Event Feed ничего не появляется. Чтобы убедиться, что настройка работает, включите событие и отследите покупку, совершённую после этого момента.