如何将 RevenueCat 连接到 AdMate

连接 RevenueCat 后，AdMate 可以在广告和应用商店报告旁边提供以订阅为中心的视图。它可以展示 RevenueCat 提供的项目、交易和指标，而不会把 AdMate API 变成服务器端的收入存储库。

RevenueCat 凭据权限很大。请仔细准备连接，使用当前 AdMate 版本提供的授权方式，切勿把密钥粘贴到公开的问题报告或截图中。

AdMate

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

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

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

选择正确的 RevenueCat 访问方式

AdMate 支持配置 RevenueCat 账号和多个项目。根据当前账号和版本，凭据界面可以使用受支持的 API v2 授权（包括项目密钥），也可能提供账号级别的授权流程。

请使用能够读取所需数据、但权限最小的凭据。用于嵌入应用的公开 SDK 密钥不能自动替代 API 密钥凭据，也不能假设某个项目的凭据可以列出组织中的所有项目。

设置之前：

确定需要的 RevenueCat 组织和项目；
确认你要添加的是单个项目的密钥，还是账号级别的连接；
删除不再需要的旧密钥；
为该账号在 AdMate 中设置一个清晰的别名。

添加 RevenueCat 账号

在 AdMate 中打开设置和账号管理。
找到 RevenueCat，选择添加账号。
选择当前应用显示的授权方式。
输入或授权所需凭据，不要修改其中任何字符。
让 AdMate 验证账号并获取可访问的项目。
涉及多个组织或客户时，为连接设置一个易于识别的名称。
打开 RevenueCat 摘要，确认目标项目和时间段。

如果使用多个项目密钥，请把每个密钥对应到正确的项目。不要把每个条目都简单命名为“RevenueCat”；描述性的别名可以避免意外比较不同客户的数据。

连接后需要核对的内容

先核对身份，再看总计：

账号或组织名称；
项目名称和项目标识；
包含的应用和商店；
所选日期范围和币种；
所显示的指标是否包含退款或向下调整。

然后将一个已结束的时间段与 RevenueCat 仪表板进行比较。小的差异可能来自刷新时间、币种规则或指标定义。如果某个项目完全不显示，通常说明问题出在凭据范围或项目对应关系上，而不是计算错误。

仪表板访问与 Webhook 是两回事

AdMate 以两种不同的方式使用 RevenueCat：

Apple 应用查询用户配置的项目，以获取仪表板数据；
AdMate API 可以接收 RevenueCat Webhook，用于通知流程。

为仪表板配置凭据并不会自动配置 Webhook，创建 Webhook 也不会授予应用列出项目指标的权限。请将它们视为用途和凭据都不同的两项独立任务。

API 会临时保存设备和项目上下文，以便通知能够显示有用的名称和币种。这些上下文并不是用户完整收入历史或访问令牌的服务器端副本。

排查缺失的项目

凭据验证通过，但只显示一个项目

检查该凭据是否专属于这个项目。添加或对应所需的密钥，或在合适的情况下使用受支持的账号级别方式。

有效项目没有显示任何指标

选择一个已结束且确有交易的日期范围，检查项目和商店筛选条件，并在主应用中刷新。新的或不活跃的项目返回零也是正常的。

授权突然失败

密钥可能已被撤销、轮换，或复制时带入了空格。请在 RevenueCat 中检查其状态，然后在 AdMate 中替换。不要保留已撤销的密钥作为备用。

项目名称正确，但总计看起来不对

检查指标定义、退款、币种和日期边界。在范围对齐之前，不要直接比较 RevenueCat 收入和 App Store Connect 收益。

保护凭据

切勿在分析数据、日志或诊断截图中包含密钥；
不要在预期组织之外重复使用项目密钥；
如果密钥已泄露，请进行轮换；
从不应再读取该项目的设备上移除 AdMate 账号；
与外包方或客户的合作结束时，定期审查访问权限。

在发布合并后的收入数字之前，请继续阅读为什么各服务商的总额不同。

常见问题

AdMate 可以连接多个 RevenueCat 项目吗？

可以。账号模型支持多个项目和项目凭据。在合并视图前，请为每个项目命名并逐一核实。

只用 RevenueCat 公开 SDK 密钥就够了吗？

请使用 AdMate 中 RevenueCat 设置所要求的凭据类型。应用的公开 SDK 密钥和 API 密钥凭据用途不同。

AdMate 会把所有订阅收入发送到它的 API 吗？

不会。应用直接查询已配置的服务。API 中的 RevenueCat 上下文用于支持 Webhook 通知，并不是收入存储库。

我应该向支持团队发送什么？

发送项目名称、日期范围、指标以及已脱敏的错误信息。切勿发送密钥。