跳到主要内容
RevenueSensor
连接收入来源

连接 Apple App Store

创建一个具备正确角色的 App Store Connect API 密钥,添加它,然后选择你的应用。

Apple 的报表不使用登录弹窗。你需要在 App Store Connect 中创建一个 API 密钥,下载一次,然后把它的详细信息粘贴到 Revenue Sensor 中。在控制台中,这个来源叫作 Apple IAP。

开始之前

  • App Store Connect 的 Account Holder 或 Admin 权限,这样你才能创建密钥。
  • 你的 Vendor Number,位于 App Store Connect → Reports → Payments and Financial Reports。它显示在左上角,你的账户名称下方。

创建你的 API 密钥

  1. 1

    打开 Integrations 的密钥页面

    App Store Connect → Users and Access → Integrations → App Store Connect API。

  2. 2

    生成密钥

    点击 Active 旁边的 +,为密钥起一个你能认出的名字,例如“Revenue Sensor”。

  3. 3

    赋予报表角色

    在 Access 下选择 Sales、Finance 或 Admin。这些角色都能读取 Revenue Sensor 导入的 Sales and Trends 报表。只有 Admin 还能提供精确的 App Store Connect 数字(见下文)。只有 Developer 或 App Manager 权限的密钥无法读取收入。

  4. 4

    下载 .p8 文件

    Apple 只允许你下载一次私钥。离开页面之前,请把它保存在安全的地方。如果丢失了,请生成一个新密钥,并使用它新的 Key ID 和 .p8 文件。

最常见的一种失败

如果收入返回为空,或者账户显示“Your API key needs the Sales role”,原因几乎总是密钥的角色:在 App Store Connect 中给它赋予 Sales 或 Finance 角色,然后重新连接。同时检查 Vendor Number 是否与该密钥属于同一个 App Store Connect 账户。

添加你的凭据

  • Issuer ID:显示在 App Store Connect API 密钥页面的顶部。所有密钥的 Issuer ID 都相同。
  • Key ID:显示在你创建的密钥所在的那一行。
  • 私钥:你下载的 .p8 文件。上传它或拖入即可。它会被加密存储,并且不会再显示。
  • Vendor Number:来自 Payments and Financial Reports。

选择你的应用

Revenue Sensor 会列出该密钥能看到的已发布应用。选择你想追踪的应用。只有选中的应用会被同步。

会导入什么

收入等于 Apple 每日 Sales 汇总报表中的销量乘以 Developer Proceeds。到账金额是 Apple 付给你的钱,已扣除其佣金及其代收的任何税费,因此 Payout 是这个来源唯一的收入口径。退款会以销量为负数的行出现,因此会在 Apple 处理退款的那一天被扣除。下载量和退款也从同一份报表导入。

报表延迟

Apple 在每天结束后才发布当天的销售报表,所以当天的数据永远还看不到。Apple 修订数据时,最近几天的数字可能会有轻微变化;每次同步都会重新读取最近 14 天。

本页内容