如何将 App Store Connect 连接到 AdMate

App Store Connect 包含多类数据：应用元数据、评论、分析、销售额、预估收益以及最终财务报告。AdMate 可以把这些内容汇集到你用于 AdMob 和 RevenueCat 的同一个应用中，但连接必须具备正确的标识符和权限。

设置使用 App Store Connect API 密钥。请把私钥当作密码对待：只在凭据界面中导入，切勿将其附加到支持请求中。

AdMate

在一个面板中查看您的所有收入

通过应用、平台和国家或地区筛选器，跨多个账户跟踪 AdMob、AdSense、RevenueCat 和 App Store Connect

在 iPhone、iPad、Mac 和 Apple Watch 上监控收入、点击、eCPM、订阅、安装和付款

需要从 App Store Connect 获取的内容

准备 Apple 在“用户和访问”区域为 API 密钥显示的数值：

Key ID，用于识别 API 密钥；
Issuer ID，用于识别 App Store Connect API 的颁发者；
.p8 私钥的内容或文件；
在 AdMate 中使用的清晰账号别名；
当所需的销售或财务报告需要时，提供供应商编号。

分配给密钥的角色决定 Apple 返回哪些数据。能够列出应用的密钥，仍可能无权访问销售或财务数据。请使用满足需求的最小权限角色，但要确保它涵盖你实际要查看的报告。

Apple 通常只允许下载一次私钥文件。请把原始文件安全保存在代码仓库和截图之外。如果文件丢失或泄露，请撤销该密钥并创建新的密钥，而不是让别人通过聊天发给你。

在 AdMate 中添加账号

打开设置和账号管理。
选择添加 App Store Connect 账号。
输入一个易于识别的显示名称。
按 Apple 提供的原样填写 Key ID 和 Issuer ID。
通过凭据界面导入或粘贴私钥。
如果财务或销售报告需要，请添加供应商编号。
保存账号，并让 AdMate 验证凭据。
打开账号摘要，确认显示了预期的应用。

不要手动编辑 .p8 密钥的开头或结尾行。多余的文本、缺失的换行，或使用其他颁发者的密钥，都会导致无法生成令牌。

分别核对每一类数据

摘要显示正常，并不代表 App Store Connect 的所有接口都可用。请检查你计划使用的内容：

应用和元数据

确认显示了预期的应用和图标。缺少某个应用，可能说明该密钥属于另一个提供商组织，或者其角色受到限制。

打开评论视图，检查一个你熟悉的应用。评论是按商店和地区区分的数据；有效的空白状态可能只是表示没有匹配的评论。

分析

选择一个完整的时间段，并考虑 Apple 提供报告所需的时间。有些分析报告不是实时的，有各自的粒度和延迟。

销售额和收益

把客户销售额和开发者收益分开标注。它们不是同一个数值，也都不应与银行付款混为一谈。

财务报告

财务报告使用 Apple 已结算的报告期，并且可能需要正确的供应商编号和角色。请将其用于对账，而不要期待当天的数据会出现。

排查连接问题

密钥或签名无效

将 Key ID、Issuer ID 和私钥作为一组重新核对。即使密钥有效，若与错误的颁发者搭配也会失败。如果密钥可能已泄露，请先撤销再继续测试。

应用能加载，但财务报告不能

检查 API 密钥的角色、供应商编号和所请求的财务期间。拥有元数据访问权限并不保证能访问财务数据。

分析没有数据

使用受支持的历史时间范围，确认报告已经可用，并确认所选应用确实产生了所请求的指标。

出现了其他组织的应用

移除该账号，并添加正确提供商的密钥。不要仅仅因为两个组织的应用使用相同的 bundle 命名规则，就把它们的总额合并。

多个 App Store Connect 账号

AdMate 支持多个账号。请使用能识别组织的别名，而不是创建密钥的人的名字。轮换密钥后，请在正确的账号中替换，并分别测试应用、分析和财务数据。

如需与订阅分析进行比较，请阅读为什么 App Store Connect 与 RevenueCat 的总额不同。

常见问题

AdMate 需要我的 Apple ID 密码吗？

不需要。连接使用 App Store Connect API 密钥、颁发者及相关标识符。切勿为此设置输入或分享 Apple ID 密码。

为什么应用能加载，而收益不能？

该密钥可能有足够权限读取应用元数据，但没有销售或财务权限，也可能缺少供应商编号和报告期间。

可以在多台使用 AdMate 的设备上复用同一个密钥吗？

技术上同一凭据可能可以使用，但每多一份副本都会增加泄露风险。请遵循你所在组织的密钥管理政策，并撤销不应再拥有访问权限的设备上的密钥。

App Store Connect 的估算值是最终的会计数值吗？

不是。会计处理请使用已结算的财务报告和实际付款。