Taly 常见问题

连接与凭证

需要用具备「管理」权限的账号生成一次密钥，页面上要填的三项都来自这一步。.p8 私钥文件只能下载一次，请妥善保存。

在 App Store Connect →「付款与财务报告」页面顶部，是一串 8 位数字。销售与收入报表按供应商编号查询，不填会取不到报表数据；如果只看下载趋势，可以先留空。

绝大多数是这三类原因，逐个排查即可：

到后台重新生成密钥并导入 .p8，App 不会缓存错误的凭证。

私钥只写进本机 Keychain，其余配置存在 App 沙盒内，不会上传到任何服务器。网络请求也不会携带私钥——App 用它在本机签名生成短期 JWT 再请求 Apple。可在「设置 › 隐私与安全 → 清除全部本地数据」随时移除，卸载 App 即彻底删除。

Apple 报表里只有真正产生付款的订单才计入收入。免费 App 在统计期内没有付费下载或内购时，收入就是 $0、付费率 0%，这是符合报表的正常结果，不是解析错误。

App Store Connect 的销售与趋势报表按天生成，通常滞后约一天，跨时区会更明显，当天数据要次日才完整。订阅事件与订单不走报表，走服务器通知实时推送（见下文「实时订单通知」）。

410 是 Apple 返回的「资源不可用」：上架之前的月份本来就没有报告，明细报告也只保留最近一段时间。App 会记住这个边界，之后不再重复请求这些月份；把时间范围切到更近的区间即可看到数据。

先下拉刷新一次；若仍无变化，去「设置 › 接口诊断」看每一条请求的真实状态，或跑一遍「接口自检」。凭证过期、网络受限、Apple 侧限流都会导致取数失败，诊断页会直接给出原因。

把 Taly 给你的专属通知地址填进 App Store Connect 的服务器通知设置即可，之后用「验证连接」确认链路通：

验证有两个前置条件：已配置 Connect 凭证、已开启系统通知权限。页面会用红 / 绿勾标出哪一项不满足，缺哪项补哪项即可；权限还没问过时，点验证会顺势弹一次系统授权框。

订单推送是横幅提示，如果你没点开它，iOS 不会唤醒 App，这条数据就没机会在本机落库。不用担心漏单：每次打开实时订单页，App 都会向服务端补拉最近 100 条事件，缺的会自动补齐。

通知地址与设备绑定（地址里带设备标识），换机后旧设备仍会收到。在新设备上重新复制通知地址、更新 App Store Connect 里的配置并验证通过即可切换过来。

小组件由 iOS 按系统时间线刷新，间隔通常十几分钟到数小时不等，系统会根据使用频率自动调节，App 无法强制。打开一次 Taly 会立即写入最新数据并触发刷新。

小组件读的是 App 最后一次成功写入的数据。先在 App 内成功取一次数（配置凭证后刷新，或使用演示数据），再添加小组件就能看到真实数值。

可以：设置 › 隐私与安全 › 开启「Face ID / Touch ID 解锁」。开启前会先验证一次生物识别；设备未录入时会提示不可用。切到后台自动上锁，回到前台自动解锁，识别失败可回退设备密码。

会移除 Connect 凭证、通知配置、本地订单与评分缓存，且不可恢复。下次使用需要重新配置凭证。

Plus 是订阅制 / 买断制的高级版，购买后解锁全部高级功能；可在设置页顶部横幅查看与开通。订阅由 App Store 统一管理：在系统「设置 › Apple 账户 › 订阅」中可以取消或恢复购买。

设置 › 反馈中心，提交问题时建议附上「接口诊断」的结果截图，能少一轮来回。官方回复后，反馈中心入口会亮起小红点提醒你查看。

没有找到答案？欢迎发邮件到 yongze.chen@icloud.com，或通过 App 内的反馈中心提问。