Cómo conectar RevenueCat a AdMate

Una conexión con RevenueCat añade a AdMate una vista centrada en suscripciones junto a los informes de publicidad y tiendas. Puede mostrar los proyectos, transacciones y métricas expuestos por RevenueCat sin convertir la API de AdMate en un almacén de ingresos en el servidor.

Las credenciales de RevenueCat tienen mucho alcance. Prepara la conexión con cuidado, utiliza el modo de autorización ofrecido por tu versión actual de AdMate y nunca pegues una clave secreta en una incidencia pública o una captura.

AdMate

Todos tus ingresos en un solo panel

Consulta AdMob, AdSense, RevenueCat y App Store Connect en varias cuentas, con filtros por app, plataforma y país

Monitoriza ingresos, clics, eCPM, suscripciones, instalaciones y pagos desde iPhone, iPad, Mac y Apple Watch

Elige el acceso correcto de RevenueCat

AdMate admite la configuración de cuentas de RevenueCat y varios proyectos. Según la cuenta y la versión actual, la pantalla puede utilizar los modos de autorización compatibles con API v2, incluidas claves secretas de proyecto, y puede ofrecer un flujo de autorización a nivel de cuenta.

Utiliza la credencial con menos privilegios que permita leer los datos necesarios. Una clave pública de SDK pensada para integrarse en una app no sustituye automáticamente a una credencial secreta de API, y no debes asumir que la clave de un proyecto puede listar todos los proyectos de una organización.

Antes de configurar:

identifica la organización y los proyectos necesarios;
confirma si vas a añadir una clave de proyecto o una conexión de cuenta;
elimina claves antiguas que ya no sean necesarias;
decide un alias claro para la cuenta dentro de AdMate.

Añade la cuenta de RevenueCat

Abre Ajustes y la gestión de cuentas en AdMate.
Busca RevenueCat y elige añadir una cuenta.
Selecciona el método de autorización mostrado por la app actual.
Introduce o autoriza la credencial solicitada sin modificar sus caracteres.
Deja que AdMate valide la cuenta y obtenga los proyectos accesibles.
Asigna un nombre reconocible cuando gestiones varias organizaciones o clientes.
Abre el resumen de RevenueCat y confirma el proyecto y el periodo correctos.

Si utilizas varias claves secretas, asigna cada una a su proyecto. No llames «RevenueCat» a todas las entradas: un alias descriptivo evita comparaciones accidentales entre clientes.

Qué comprobar después de conectar

Empieza por la identidad antes de mirar los totales:

nombre de la cuenta u organización;
nombre e identificador del proyecto;
aplicaciones y tiendas incluidas;
intervalo y moneda seleccionados;
si la métrica incluye reembolsos o ajustes negativos.

Después compara un periodo cerrado con el panel de RevenueCat. Puede haber pequeñas diferencias por la hora de actualización, la moneda o la definición de la métrica. Un proyecto completamente ausente suele apuntar al alcance de la credencial o a su asignación, no a un error de cálculo.

El panel y los webhooks son accesos distintos

AdMate usa RevenueCat en dos niveles:

la aplicación Apple consulta los proyectos configurados por el usuario para mostrar el panel;
la API de AdMate puede recibir webhooks de RevenueCat para flujos de notificaciones.

Configurar una credencial para el panel no configura automáticamente un webhook, y crear un webhook no da permiso a la app para listar métricas. Trátalos como tareas independientes con credenciales y objetivos distintos.

La API conserva contexto temporal del dispositivo y proyecto para que una notificación muestre nombres y moneda útiles. Ese contexto no es una copia en el servidor del historial completo de ingresos ni del token de acceso del usuario.

Soluciona un proyecto ausente

La credencial valida pero solo aparece un proyecto

Comprueba si pertenece específicamente a ese proyecto. Añade o asigna las claves necesarias, o utiliza el método de cuenta compatible si procede.

No aparecen métricas en un proyecto válido

Selecciona un periodo cerrado con transacciones conocidas, verifica los filtros de proyecto y tienda y actualiza la app principal. Un proyecto nuevo o inactivo puede devolver cero correctamente.

La autorización deja de funcionar

La clave puede haberse revocado, rotado o copiado con espacios. Confirma su estado en RevenueCat y sustitúyela en AdMate. No conserves una clave revocada como alternativa.

El proyecto es correcto pero el total parece erróneo

Comprueba la definición de la métrica, reembolsos, moneda y límites de fecha. No compares directamente ingresos de RevenueCat con proceeds de App Store Connect hasta alinear el alcance.

Protege la credencial

no incluyas nunca la clave en analíticas, logs o capturas de diagnóstico;
no reutilices una clave fuera de su organización;
rótala si se ha expuesto;
elimina la cuenta de AdMate en dispositivos que ya no deban leer el proyecto;
revisa el acceso cuando termine una relación con un colaborador o cliente.

Continúa con por qué difieren los totales de los proveedores antes de publicar una cifra combinada.

Preguntas frecuentes

¿Puede AdMate conectar varios proyectos de RevenueCat?

Sí. El modelo de cuentas admite varios proyectos y credenciales. Etiqueta y verifica cada proyecto antes de combinar vistas.

¿Es suficiente una clave pública del SDK?

Utiliza el tipo de credencial solicitado por la configuración de RevenueCat en AdMate. Las claves públicas de la app y las credenciales secretas de API tienen objetivos distintos.

¿Envía AdMate todos los ingresos a su API?

No. La app consulta directamente los servicios configurados. El contexto de RevenueCat en la API se usa para notificaciones de webhooks, no como almacén financiero.

¿Qué debo enviar a soporte?

Envía el nombre del proyecto, el periodo, la métrica y el error redactado. Nunca envíes la clave secreta.