Beacon for App Store Connect
在 iPhone 上查看你的 App 下载量、收入和下一笔到账 · Your App Store numbers on iPhone
需要帮助？Need help?
遇到问题或有建议，请发邮件，通常会在 2 个工作日内回复。
For questions or feedback, email us. We usually reply within two business days.
请附上 iOS 版本、App 版本（设置 → 关于）和问题截图。不要在邮件里发送 .p8 私钥。
Please include your iOS version, the app version (Settings → About) and a screenshot. Never send your .p8 private key.
常见问题
需要准备什么？
一把 App Store Connect 团队 API Key：在 App Store Connect →「用户和访问」→「集成」→「App Store Connect API」里创建，记下 Issuer ID、Key ID，下载 .p8 私钥，再到「付款和财务报告」里找到 Vendor Number。打开 Beacon 点「开始配置」填入即可。Key 需要 Sales 或 Finance 角色；要看财务页的结算数据，需要 Finance 角色。
数据多久更新一次？
Apple 的销售报告按天生成，通常在次日上午（太平洋时间）可用。Beacon 回到前台时会检查更新，开启「后台刷新」后系统会定时拉取，让小组件保持最新。
为什么收入和 App Store Connect 里不完全一样？
销售页的收入是按每日销售报告估算的；财务页的已结算金额来自 Apple 的财务报告，以 Apple 实际打款为准。汇率和税费会造成差异。
换了新 iPhone 怎么办？
配置保存在 iCloud 钥匙串中，同一 Apple 账户下的设备会自动同步，不需要重新填写。
怎么停止 Beacon 访问我的数据？
在 App Store Connect 吊销这把 API Key，Beacon 就再也无法读取你的数据。已下载的报表可以在「设置」→「清除本地缓存」里删除，删除 App 也会一并删掉。
Frequently asked questions
The app's interface is in Simplified Chinese.
What do I need?
An App Store Connect team API key. Create one under Users and Access → Integrations → App Store Connect API, note the Issuer ID and Key ID, download the .p8 private key, and find your Vendor Number under Payments and Financial Reports. Open Beacon, tap 开始配置 (Set up), and fill them in. The key needs the Sales or Finance role; settled amounts on the Finance tab require the Finance role.
How often does the data update?
Apple generates sales reports daily, usually available the next morning Pacific Time. Beacon checks for new reports when it comes to the foreground, and with background refresh on, the system fetches them periodically to keep widgets current.
Why don't proceeds match App Store Connect exactly?
Sales-tab revenue is estimated from daily sales reports. Settled amounts on the Finance tab come from Apple's financial reports and reflect what Apple actually pays. Exchange rates and taxes cause differences.
Got a new iPhone?
Your configuration is stored in iCloud Keychain and syncs to devices signed in to the same Apple Account.
How do I stop Beacon from accessing my data?
Revoke the API key in App Store Connect and Beacon can no longer read your data. Downloaded reports can be removed with Settings → 清除本地缓存 (Clear local cache), or by deleting the app.