将 FunnelFox 连接到 Adapty

FunnelFox 可以构建网页漏斗：即用于在 App Store 和 Google Play 之外销售订阅的落地页和测验页面。将 FunnelFox 与 Adapty 连接后，网页购买者即可在移动应用中使用付费功能，同时你还可以在同一个看板中查看网页购买与应用内购买的数据。

连接只需要一个密钥和一个访问等级 ID。之后，您的应用必须识别购买者，才能授予该访问等级。请参阅在应用中提供访问权限。

集成工作原理

FunnelFox 在网页端完成支付后，会调用 Adapty 服务端 API 来创建用户画像、记录交易，并授予你在 FunnelFox 集成设置中填写的访问等级。续订、取消订阅和支付失败均会更新同一个用户画像。网页端购买记录会与 App Store 和 Google Play 的收入一同显示在 Adapty 数据分析中。

为漏斗中销售的每个产品在 Adapty 中创建对应的产品。购买记录无论如何都会到达 Adapty，但如果没有产品配置，Adapty 就无法获取订阅时长，导致数据分析报告的时长有误或购买记录未被归类。

Adapty 通过 customer user ID 将网页购买与应用用户关联。FunnelFox 默认使用结账时输入的电子邮件地址作为该 ID。

如果您的流程通过 Stripe 或 Paddle 进行计费，则无需同时将该支付提供商连接到 Adapty。仅在您也通过该提供商在流程之外进行销售时才需要连接，Adapty 会对从两个来源收到的交易进行去重处理。

如需基于自己的 Web 结账（而非 FunnelFox 流程）构建相同的流程，请参阅同步 Web 与移动端的购买记录。

连接 FunnelFox

您需要在 FunnelFox 端完成连接配置，具体请参照 FunnelFox 的 Adapty 集成指南。该指南需要您提供 Adapty 中的两个值：

• Secret API key：在 Adapty 中打开 App Settings，复制 secret key。
• Access level ID：购买行为所授予的访问等级。每个 Adapty 应用默认包含一个 premium 访问等级；如需授予其他等级，请先创建。

在同一漏斗中授予不同的访问等级

如果漏斗只销售单一层级，则无需在此进行任何设置：每次购买都会授予集成设置中的访问等级。

如需在同一漏斗中销售多个层级，请使用结账元素上的 Custom entitlement 字段。该字段会覆盖集成设置中的访问等级 ID，仅对通过该元素完成的购买生效。一个漏斗可以包含多个结账元素，例如钱包按钮和折叠式结账。每个元素都有独立的 Custom entitlement 字段，因此请在所有需要覆盖访问等级的元素上填写该字段。

在应用中授予访问权限

要为网页购买者解锁付费功能，请使用 FunnelFox 所用的相同 customer user ID 调用 Adapty.activate() 或 Adapty.identify()。默认情况下，该 ID 为购买者在结账时输入的电子邮件地址。调用方式请参阅 识别用户 iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform 和 Capacitor 。

通过漏斗链接安装应用并不会自动识别买家身份。在应用调用 Adapty.identify() 并传入匹配 ID 之前，持有访问等级的用户画像与应用创建的用户画像是相互独立的，应用将无法显示付费权限。使用结账时填写的邮箱登录，即可将两者关联起来。

若要在无需登录步骤的情况下解锁权限，可通过延迟深度链接将漏斗中的 customer user ID 传递给应用，并在首次启动时调用 Adapty.identify() 传入该 ID。

然后从用户画像中读取访问等级以解锁相应功能。请参阅 检查订阅状态 iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform 和 Capacitor 。

测试集成

1. 在您的漏斗中完成一次购买。
2. 在 Adapty 中，打开 Profiles，通过 FunnelFox 使用的 customer user ID 找到对应的用户画像。
3. 确认您在 FunnelFox 集成设置中填写的访问等级 ID 在该用户画像上处于激活状态。
4. 打开您的应用，识别同一用户，确认付费功能已解锁。

故障排查

网页端购买者打开应用但没有付费访问权限

您的应用尚未识别该购买者。FunnelFox 已将访问等级授予以其使用的 ID 为键值的用户画像（默认为结账时填写的电子邮件地址），而您的应用读取的是另一个用户画像。请按照在应用中提供访问权限中的说明，使用该 ID 调用 Adapty.identify()。

其他 FunnelFox 集成

FunnelFox 与三个 Adapty 产品相连接，每个产品需单独配置。