RevGlance文档

App Store

使用 API 密钥连接 App Store Connect，读取 iOS 和 Mac 的每日 Sales and Trends 报告。

RevGlance 通过 App Store Connect API 读取 Apple 的每日 Sales and Trends 报告。SALES 摘要提供付费应用和 App 内购买；SUBSCRIBER 报告提供每笔订阅扣款、免费试用和退款。

连接

  1. 在 App Store Connect 中，打开 Users and Access › Integrations › App Store Connect API，生成一个具有 Finance 或 Sales 角色的团队密钥。
  2. 记下密钥列表上方的 Issuer ID 以及该密钥的 Key ID，然后下载 .p8 文件。Apple 只允许下载一次。
  3. 在 Payments and Financial Reports（左上角）下找到您的 vendor number。
  4. 填写这四个字段，粘贴完整的 .p8 文件（包括 -----BEGIN PRIVATE KEY----- 等行），然后选择 连接 App Store。

表单需要填写的内容

字段格式示例
Issuer ID57246542-96fe-1a63-e053-0824d011072a
密钥 ID2X9R4HXF34
供应商编号85012345
私钥（.p8 文件内容）加密存储-----BEGIN PRIVATE KEY-----

添加 webhook

报告大约会延迟一天。App Store Server Notifications 会在有变化的那一刻通知 RevGlance，以便下一份报告一生成就被获取。

  1. 在 RevGlance 中，打开 设置 › 来源，打开 App Store 数据源的菜单并选择 Webhook。
  2. 自行生成一个较长的随机密钥，将其粘贴到 签名密钥 下并保存。
  3. 复制 webhook URL，并在末尾加上 ?token= 和您的密钥。
  4. 在 App Store Connect 中，打开您应用的 App Information，在 App Store Server Notifications 下将该地址设为生产环境 URL，版本选择 2。

RevGlance 会校验 URL 中的密钥以及 Apple 自己的签名，即一条可追溯至 Apple Root CA G3 的证书链。

预期情况

  • 匿名客户。 Apple 不提供买家姓名。每个订阅者会成为一个带有匿名 Subscriber ID 的客户，优惠代码、跨订阅组的升级和 ID 重置可能看起来像新的订阅。
  • 一年的历史数据。 每日报告最多回溯一年，且每天的数据大约延迟一天到达。
  • 取消显示较晚。 Apple 不报告取消：订阅在续订逾期三天后才会结束。

App Store 的计算方式

  • 客户价格计为收入，手续费为客户价格减去您的收益，因此含税价格中的税费会显示为手续费。
  • MRR 是最新的客户价格，因此在价格含税时也包含税费：Apple 的报告不单独列出税费。推介优惠按优惠价格计入，之后的常规价格显示为扩展。
  • 退款来自 Apple 报告中的负价格。当 Apple 撤销退款时，RevGlance 会移除该订阅者和订阅的最近一笔退款。Apple 不说明撤销的是哪笔退款，因此当一个订阅有多笔退款时，可能会移除错误的一笔。
  • 在 Apple 重置订阅者 ID（180 天）之后申请的退款会保留，但不关联客户。
  • App 捆绑包抵扣（CMB-C）不是退款，不予计入。
  • Apple 不显示取消：续订逾期三天即视为订阅结束。
  • 失败的扣款不会被报告，因此该数字始终为零。