处理集成中的错误

使用任何归因、消息推送或分析集成时，您可能会遇到一些常见错误。请参阅本指南了解故障排除方案。

数据差异

原因：这可能是因为并非所有用户都在使用包含 Adapty SDK 的应用版本。

解决方案：为确保数据一致性，您可以强制用户将应用更新至包含 Adapty SDK 的版本。

原因：这很可能是因为 Adapty 服务器与集成服务器之间的网络连接中断。

解决方案：此类问题通常不会持续太久，且仅影响少量事件。

原因：集成配置不正确。

解决方案：请参阅我们文档中关于该集成的文章，确保您已在 Adapty 看板、第三方工具端以及应用代码中完成所有配置步骤。

原因：用户画像缺少某些集成专用 ID。这可能发生在应用代码中集成未正确配置的情况下。

解决方案：请参阅我们文档中关于该集成的文章，确保您已在应用代码中实现代码片段中的方法，并且这些方法确实与您的用户画像进行了交互。

原因：某些集成凭据缺失或不正确。

解决方案：请在 Adapty 看板上检查该集成的所有凭据。此问题可能由版本或环境不匹配引起。

原因：集成设置中启用了 Exclude historical events 选项，且事件的创建日期早于我们系统中该用户画像的创建日期。

如果一条从多年前开始的交易链通过收据验证传入 Adapty，而对应的用户画像是最近才创建的，则可能发生这种情况。

解决方案：确保新事件不会出现此情况。如果您希望将历史事件发送至集成，请禁用 Exclude historical events。

原因：该事件在此集成中不受支持，或者您在设置集成时将其禁用了。

解决方案：

检查集成是否支持此事件类型。以下事件并非所有集成都能接收：
- access_level_updated：仅 webhook 支持。
- 合成事件（trial_active、subscription_active）：Adjust、Amplitude、AppMetrica、AppsFlyer、Branch、Facebook Analytics、Firebase、Mixpanel、OneSignal、PostHog、Singular、SplitMetrics 以及 webhook 支持。
如果该集成支持此功能，请确保在集成设置中已开启对应事件。

原因：合成事件会在计时器触发时执行一次，以下四种情况会导致其静默停止：

在延迟时间结束之前，试用或订阅已终止。已转换、已过期或已退款的购买不会产生任何事件，Adapty 也不会再次检查。请改为查找 trial_converted、trial_expired、subscription_expired 或 subscription_refunded。
在延迟时间结束之前，用户已关闭自动续订。其访问权限会持续到付费周期结束，但 Adapty 会跳过发送。请改为查找 trial_renewal_cancelled 或 subscription_renewal_cancelled。
您在购买开始后才启用了该事件。Adapty 在收到 trial_started 或 subscription_started 时启动计时器，因此只有在您启用该事件之后发生的购买才会产生对应事件。
您在购买开始后更改了延迟时间。已安排的发送将保留创建时设定的延迟。

解决方案：这些都不是推送失败，所以没有什么需要重试的，Event Feed 中也不会出现任何内容。要确认配置是否正常，请开启该事件，然后观察该时间点之后发生的购买行为。