如何排查 RevenueCat 项目不显示的问题

RevenueCat 凭据可能是有效的，却只能访问一个项目。当授权针对特定项目时，这是预期行为。如果 AdMate 中缺少某个项目，请先诊断范围和映射，而不要认为 RevenueCat API 返回了不完整的账户。

AdMate

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

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

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

确认授权模式

打开 RevenueCat 账户配置，确认它使用的是账户级流程还是项目密钥。当前的 AdMate 设置支持项目映射，并会将所选模式与账户一起保存。

项目密钥应当代表它自己的项目，而不会自动发现无关的项目。

在 RevenueCat 中确认项目

请在经授权的浏览器会话中确认以下内容，而不是把密钥粘贴到第三方工具中：

组织；
项目名称和标识符；
项目中的应用和商店；
凭据的状态；
已连接账户的权限或范围。

不同组织中名称相似的项目是常见的混淆来源。

检查项目与密钥的映射

当密钥模式使用多个项目时，每个密钥都必须关联到对应的项目。请检查别名和标识符，而不是密钥本身的片段。

如果密钥已轮换：

通过组织的授权流程创建或获取新的密钥；
在 AdMate 中更新正确的项目映射；
验证该项目；
删除已撤销的凭据；
切勿在笔记或支持消息中同时保留两个值。

清除筛选条件并选择账户

项目可能存在，却被当前的账户、应用、商店或日期筛选隐藏。请返回 RevenueCat 账户，选择目标组织，并在重新加载前清除无关的筛选条件。

选择一个包含已知交易的完整时段。没有活动的项目即使已经连接，也可能正确地显示为空的指标视图。

区分四种症状

列表中没有该项目

可能是授权范围、组织选择或项目映射的问题。

有项目但没有应用

请检查 RevenueCat 中的项目配置，以及这些应用是否属于另一个项目。

有应用但没有指标

请检查日期范围、商店筛选、指标是否可用以及项目是否有活动。

授权错误

请检查撤销、轮换、复制时带入的空格以及凭据类型。如果可能已经泄露，请进行轮换。

与服务商数据进行比较

在 RevenueCat 仪表盘中测试相同的项目、时段和指标。如果那里也为空，请修正服务商配置或选择有数据的时段。如果 RevenueCat 有数据，而 AdMate 在有效刷新后仍然始终为空，请整理一份经过脱敏且可复现的报告。

安全的诊断报告

请提供 AdMate 版本、平台、授权模式、账户别名、项目名称、所选时段以及经过脱敏的错误。切勿包含密钥、OAuth 令牌、完整的客户标识符或交易内容。

如果连接了多个项目，请参阅如何管理多个 RevenueCat 项目。

常见问题

为什么只显示一个项目？

所配置的凭据可能只针对一个项目。请添加另一个已授权项目的映射，或在适当时使用受支持的账户级流程。

公开的 SDK 密钥可以列出项目吗？

请使用 AdMate 设置所要求的凭据类型。应用的公开 SDK 密钥和私密的 API 访问权限用途不同。

我应该删除账户重新开始吗？

请先检查模式、映射、筛选条件和凭据状态。修正一个项目比丢弃整个账户的上下文更安全。

如果密钥已经泄露怎么办？

请在 RevenueCat 中撤销或轮换该密钥，更新正确的映射，并且不要再使用已泄露的值。