处理集成中的错误

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

数据差异

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

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

网络错误

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

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

集成服务器处理事件失败

原因:集成配置不正确。

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

缺少集成数据

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

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

缺少集成凭据

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

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

事件已过期

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

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

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

已禁用/不支持的事件类型

原因:该集成不支持此事件类型,或者您在配置集成时将其禁用。例如,大多数集成不支持 access_level_updated 事件。

解决方案:请查阅集成文档,确认该集成是否支持此事件类型。如果支持,请在 Adapty 看板中确认该事件类型在集成设置中已启用。