将集成迁移到 Adapty

迁移到 Adapty 不仅仅是切换 SDK。您的第三方分析和归因集成——如 Amplitude 和 Adjust 等工具——也需要进行协调切换。操作得当，过渡过程中几乎不会产生重复或丢失的事件，也不会影响您的推广活动。

映射您的事件

在大多数 Adapty 集成中，事件名称是可自定义的。您可以将其配置为与看板和广告活动中已使用的名称匹配。切换后，您的分析和广告活动报告将继续使用相同的事件名称。要查看 Adapty 中所有可用事件的完整列表，请参阅事件。

对于 Adjust，集成使用事件 ID 而非自定义事件名称。请将您现有的事件 ID 从 Adjust 看板迁移到 Adapty 集成配置中。详情请参阅 Adjust 集成指南。

要将事件发送到集成，Adapty 必须拥有用户画像。用户画像通过以下两种方式之一创建：

历史数据导入：在 SDK 上线之前，当您导入历史交易数据时创建用户画像。
SDK 交互：当用户首次使用带有 Adapty SDK 的应用时，系统自动创建用户画像。 Adapty 可实时获取在旧系统中发生的购买记录。但只有在买家的用户画像存在时，才能发送集成事件。用户画像在用户使用集成了 Adapty SDK 的应用版本首次打开应用时创建。未升级到新版本的用户将不会产生集成事件。

在您的集成设置中启用 Exclude Historical Events。这可以防止早于用户首次 Adapty SDK 会话的事件被发送到集成中。

此设置在历史数据导入期间尤为重要，届时 Adapty 会一次性处理大量过去的交易记录。如果不启用此设置，这些交易将在您的分析工具中生成大量事件。

Adapty 允许您在保持集成禁用状态的同时进行配置和测试。您可以设置凭据、事件映射和过滤器，而无需在准备好之前激活集成。启用集成时，所有配置都会被保留，因此在迁移日之前保持关闭状态不会造成任何数据丢失。

在迁移当天，同时禁用旧方案中的集成并在 Adapty 中启用该集成。同时运行两者将产生重复事件。

在迁移当天暂停大型获客活动。这可以降低由重叠窗口期内的事件导致活动优化出错的风险。

迁移过程中出现少量缺失或重复的集成事件是不可避免的。只要切换操作正确，受影响的事件数量可以忽略不计。

产生数据缺口的主要原因在于上述时序问题：Adapty 只有在用户画像存在之后，才能为某笔购买发送集成事件。在旧系统中产生的购买记录，只有当买家使用集成了 Adapty SDK 的应用打开 App 后，才会生成对应的 Adapty 集成事件。

Adapty 建议使用集成，而非将原始服务器到服务器商店通知直接转发给您的分析或归因工具。

使用集成的优势：