如何配置 AdMate 通知和 RevenueCat Webhook

AdMate 通知可以为 RevenueCat 事件补充背景信息，但通知路径与仪表盘连接是分开的。应用使用用户配置的凭据查询项目；AdMate API 接收已配置的 Webhook，并使用临时设备上下文生成相应的通知。

把这些职责分开，对安全和故障排查都至关重要。

AdMate

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

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

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

两种配置，两种用途

仪表盘连接

AdMate 中的 RevenueCat 账户让应用能够读取已配置授权可访问的项目和指标。

Webhook 投递

RevenueCat 会把事件发送到 AdMate API 的 Webhook 端点。API 会使用已注册的设备上下文（例如项目、应用、语言和货币元数据）来准备受支持的通知。

在仪表盘中添加密钥并不会自动在服务商处创建 Webhook。创建 Webhook 也不会让应用仪表盘获得授权。

准备应用上下文

在 AdMate 中连接并验证 RevenueCat 账户；
选择目标项目和应用；
打开应用提供的 Webhook 或通知设置；
同步流程要求的设备上下文；
确认语言、货币和项目名称；
在操作系统层面允许通知。

API 上下文的有效期有限，应通过应用支持的流程进行刷新。它不是永久性的财务数据库。

配置 RevenueCat

在 RevenueCat 的 Webhook 配置中，添加 AdMate 流程中显示的端点和授权信息。请遵循应用内的最新说明，而不要从其他环境复制凭据。

尽可能使用不含敏感信息的事件进行测试。切勿把密钥或完整的 Webhook 授权值放进截图、代码仓库或公开的支持帖子中。

端到端验证

检查整条链路：

RevenueCat 接受 Webhook 配置；
受支持的事件成功投递；
AdMate API 能够解析设备和项目上下文；
平台服务接受推送投递；
设备仍处于已注册状态并允许通知；
显示的项目、应用、语言和货币均正确。

仪表盘刷新成功，只能验证另一条路径。

故障排查

RevenueCat 报告 Webhook 错误

在 RevenueCat 中检查端点、授权和响应状态。不要更换无关的仪表盘密钥。

Webhook 成功但没有收到通知

请核实设备上下文、推送权限、注册状态，以及该事件类型是否受支持。设备上下文可能会在一段时间不活跃后过期。

通知显示了错误的项目名称

从正确的项目刷新上下文，并确认没有把两个账户映射到同一个显示名称。

一台设备正常，另一台却不行

每台设备都有自己的注册信息和上下文。请在受影响的设备上测试权限和上下文。

安全规则

不要把 Webhook 授权和服务商密钥放进 Git；
不要在日志中记录包含客户或交易标识符的完整负载；
不要把 Webhook API 当作收入数据仓库；
一旦授权信息泄露，立即更换；
当设备不应再接收事件时，删除其设备上下文。

常见问题

AdMate 会在服务器上保存我全部的 RevenueCat 历史吗？

不会。API 只处理 Webhook 事件以及临时的设备和项目上下文；应用会直接查询已配置的服务。

为什么既需要仪表盘账户，又需要 Webhook？

它们服务于不同的路径：交互式报告和由服务器投递的事件通知。

Webhook 能修复仪表盘中缺失的指标吗？

不能。请检查应用的 RevenueCat 授权和项目映射。

一份安全的支持报告应包含哪些内容？

事件类型、大致时间、经过脱敏的状态以及设备和应用上下文，绝不能包含密钥或完整的客户标识符。