排查 App Store 集成问题

本文介绍常见的 App Store 集成问题，每个部分均包含症状描述、根本原因及解决方案。

产品未显示

以下两种表现通常指向同一个根本原因：

  • App Store Connect API 密钥配置正确，但 Adapty 无法获取任何产品。
  • 产品已在 App Store Connect 中创建，但未出现在 Adapty 中，或显示数量少于预期。SDK 在尝试购买时报告 “Product Id not found”。 最常见的根本原因是 Apple 协议未签署 — 付款协议、税务表格或银行表格处于待处理或未签署状态。当协议处于待处理状态时，App Store Connect API 会在产品相关端点静默返回 403 错误。Adapty 不会收到任何明确的报错提示，产品会被静默过滤掉。

请前往 App Store Connect → Agreements, Tax, and Banking，签署所有待处理的协议。然后在 Adapty 的 App settings → iOS SDK 中重新同步。

App Store 服务器通知显示”Delayed”

在 App Store Connect 中，App Store 服务器通知的状态可能会显示为 Delayed。这意味着 Apple 在发送订阅事件通知方面出现了延迟——续订、取消和账单问题等通知会排队等待，并延迟到达。

安装统计数据不受影响。Adapty 从应用首次启动开始统计安装量，而非依赖服务器端通知。

如果续订或取消数据出现滞后，Delayed 状态是最可能的原因。随着 Apple 处理积压的通知，该状态通常会自动恢复正常。

Adapty 中的价格与 App Store 不匹配

Adapty 产品编辑页面上的价格字段的行为方式取决于产品的添加方式。

如果你在 Adapty 中创建产品并从看板推送到商店，该价格将作为商店的初始价格使用。 如果你添加的产品在商店中已存在，此价格仅作为占位符使用。Adapty 的分析、集成和 SDK 均以从 App Store 实际获取的价格为准，而非该占位符。App Store 价格发生变更后不会同步更新占位符，且目前无法在看板中手动编辑占位符。

CSV 价格导出为空

如果你导出的 CSV 价格文件只有列标题，说明 App Store Connect API 密钥未完成配置。请参阅第 6 步 — 添加 App Store Connect API 密钥。

无法将新产品推送至 App Store

当你在看板中创建产品时，Adapty 可以将新产品推送至 App Store Connect。如果你的 App Store 集成尚未完整配置，推送选项将被禁用。以下两项设置为必填项：