快速上手
- 打开 Taly，首次启动会以演示数据展示全部界面，供你先熟悉布局——演示数据会明确标注，绝不伪装成真实数据；
- 进入「设置 › Apple Connect 配置」，填入你的 App Store Connect API 密钥（见下一步）；
- 保存后回到首页下拉刷新，真实数据即刻呈现。
不需要注册账号，装好、连上就能用。
连接 App Store Connect
需要用具备「管理」权限的账号生成一次密钥，页面上要填的三项都来自这一步。.p8 私钥文件只能下载一次，请妥善保存。
- 登录 App Store Connect → 用户和访问 → 集成 → App Store Connect API；
- 点击「生成密钥」，命名后选择角色（建议：财务报告 或 管理者）；
- 下载 .p8 文件，复制页面上的 Issuer ID 与该密钥的 Key ID；
- 回到 Taly → 设置 → Apple Connect 配置，粘贴 Issuer ID / Key ID 并导入 .p8。
Vendor Number（供应商编号）在 App Store Connect →「付款与财务报告」页面顶部，是一串 8 位数字：销售与收入报表按供应商编号查询，不填会取不到报表数据；如果只看下载趋势，可以先留空。
首页：看懂你的数据
- 四项核心指标：销售额、收入、下载量、付费率，每张卡都带环比涨跌；
- 时间范围：昨天 / 7 天 / 月度 / 年度 / 全部，随时切换；
- 图表类型：柱状图与折线图一键切换；
- 切换 App：右上角菜单可切换当前展示的 App，多款 App 逐个看。
应用页
「应用」标签页展示当前 App 的信息与快捷入口：销售概览、订阅数据，以及评分、地区分布、兑换码三个直达入口。
实时订单通知
把 Taly 给你的专属通知地址填进 App Store Connect 的服务器通知设置，之后用「验证连接」确认链路通：
- 打开 Taly → 订单 → 配置，复制专属通知地址；
- App Store Connect → 用户和访问 → App Store 服务器通知 → 粘贴到「生产环境 URL」；
- 回到 Taly 点击「验证连接」，收到一条测试推送即表示成功。
「验证连接」有两个前置条件：已配置 Connect 凭证、已开启通知权限，页面会用红 / 绿勾标出哪一项不满足。
点「验证连接」被拦住了？验证前需要配置 Connect 凭证并开启通知权限；权限还没问过时，点验证会顺势弹一次系统授权框。
手机收到了推送、但列表里没有这条订单？订单推送是横幅提示，如果你没点开它，iOS 不会唤醒 App，这条数据就没机会在本机落库。不用担心漏单：每次打开实时订单页，App 都会向服务端补拉最近 100 条事件，缺的会自动补齐。
换了一台新手机？通知地址与设备绑定，在新设备上重新复制通知地址、更新 App Store Connect 里的配置并验证通过即可切换过来。
地区分布
按销售报告的国家 / 地区编码聚合下载分布，带中文名与旗帜标识，看看你的 App 都卖到了哪里。数据与首页指标同源，零额外请求。
评分与评论
- 平均分 / 评分总数来自 App Store 公开接口，与商店页显示一致；
- 评论列表来自 App Store Connect 的客户评论接口（需要「客户支持」或「App 管理」角色的密钥），可以看到评论正文与开发者回复。
兑换码
- 列出该 App 全部订阅优惠码（Offer Codes）；
- 可按条批量生成一次性兑换码（Custom Codes），生成后到 App Store Connect → 你的 App → 订阅 → 优惠码 下载分发；
- Apple 不提供「App 促销码（每版本 100 个）」的公开 API，无订阅的 App 页面内会说明这一点。
桌面小组件
把收入、销量、下载、付费率与销售曲线直接钉在桌面上，小、中、大三种尺寸可选：
- 在 App 内成功取一次数（配置凭证后刷新，或使用演示数据）；
- 长按桌面空白处 → 添加小组件 → 搜索 Taly；
- 选择尺寸添加，即可看到最新数据。
小组件由 iOS 按系统时间线刷新，间隔通常十几分钟到数小时不等；打开一次 Taly 会立即写入最新数据并触发刷新。
隐私与安全
- Face ID / Touch ID 应用锁：设置 › 隐私与安全 › 开启「Face ID / Touch ID 解锁」。切到后台自动上锁，回到前台自动解锁，识别失败可回退设备密码；
- 清除本地数据：会移除 Connect 凭证、通知配置、本地订单与评分缓存，且不可恢复，下次使用需重新配置；
- 你的数据在哪：私钥只存本机钥匙串，订单与统计数据只存本机，App 直接与 Apple 通信——都不经过我们的服务器。
遇到问题？
- 接口诊断：设置 › 接口诊断，查看每一条请求的真实状态与失败原因；
- 接口自检：一键跑完连接、报表、通知等链路的完整体检；
- 反馈中心：设置 › 反馈中心，提交问题时建议附上接口诊断的结果截图，官方回复后入口会亮起小红点提醒你。
也可以访问本页旁边的「常见问题」，或直接发邮件到 yongze.chen@icloud.com。