在 Flutter SDK 中优化付费墙加载

在 Flutter 中可靠地获取付费墙需要做到三点:快速渲染、返回针对目标受众的付费墙,以及在网络较慢时优雅降级。以下规则涵盖了实现这一目标所需的时机选择、缓存策略和备用方案。

以下规则假设 Adapty().activate()Adapty().identify() 已完成调用。请参阅 Flutter SDK 调用顺序

规则与注意事项

应该这样做不要这样做原因
只在即将展示时获取对应的版位。在启动时并发预取所有版位。批量预取会阻塞主线程,导致启动时出现黑屏。
在归因数据有机会解析之后再调用 getPaywall——例如,在 activate 之后等待 1-2 秒,或等待 didUpdateProfileStream 触发后再调用。runApp 之前的 main() 中调用 getPaywall此时归因数据尚未到位。付费墙会按默认目标受众进行解析,静默绕过市场细分和 ASA 个性化设置。
为每个版位设置 loadTimeout 并配置备用付费墙无限等待 getPaywall 返回。没有超时设置,网络状况较差的用户会看到空白屏幕,直到网络恢复——或者直接关闭应用。
有关 fetchPolicyloadTimeout 参数的说明,请参阅获取付费墙和产品;有关如何选择合适版位的信息,请参阅版位

针对弱网环境进行优化

对于网络连接持续较差的市场(农村地区、交通途中、受路由问题影响的地区):

  • 除首次请求外,所有获取操作均设置 fetchPolicy: AdaptyPaywallFetchPolicy.returnCacheDataElseLoad
  • 在 Adapty 看板中为每个版位配置备用付费墙
  • loadTimeout 设置为 3–5 秒,并在超时触发时接受备用付费墙。
  • 不要将付费墙的显示挂起在 getProfile() 上。独立调用 getPaywall,避免因获取用户画像缓慢而阻塞 UI。