Como conectar o RevenueCat ao AdMate

Uma conexão com o RevenueCat dá ao AdMate uma visão focada em assinaturas ao lado dos relatórios de publicidade e das lojas. Ela pode mostrar os projetos, transações e métricas disponibilizados pelo RevenueCat sem transformar a API do AdMate em um repositório de receita no servidor.

As credenciais do RevenueCat são poderosas. Prepare a conexão com cuidado, use o modo de autorização oferecido pela versão atual do AdMate e nunca cole uma chave secreta em um relato público ou em uma captura de tela.

AdMate

Todos os seus ganhos num único painel

Acompanhe AdMob, AdSense, RevenueCat e App Store Connect em várias contas com filtros por app, plataforma e país

Monitorize ganhos, cliques, eCPM, subscrições, instalações e pagamentos no iPhone, iPad, Mac e Apple Watch

Escolha o acesso correto ao RevenueCat

O AdMate oferece suporte à configuração de contas do RevenueCat e a vários projetos. Dependendo da conta e da versão atuais, a tela de credenciais pode usar a autorização compatível da API v2, incluindo chaves secretas de projeto, e pode oferecer um fluxo de autorização no nível da conta.

Use a credencial com o menor privilégio capaz de ler os dados de que você precisa. Uma chave pública de SDK, feita para ser incorporada em um app, não substitui automaticamente uma credencial secreta de API, e não se pode presumir que a credencial de um projeto liste todos os projetos de uma organização.

Antes de configurar:

identifique a organização do RevenueCat e os projetos de que você precisa;
confirme se você vai adicionar a chave de um único projeto ou uma conexão no nível da conta;
remova chaves antigas que não são mais necessárias;
defina um apelido claro para a conta no AdMate.

Adicione a conta do RevenueCat

Abra Configurações e o gerenciamento de contas no AdMate.
Encontre RevenueCat e escolha adicionar uma conta.
Selecione o método de autorização mostrado pelo app atual.
Insira ou autorize a credencial solicitada sem alterar nenhum caractere.
Deixe o AdMate validar a conta e buscar os projetos acessíveis.
Dê à conexão um nome fácil de reconhecer quando houver várias organizações ou clientes.
Abra o resumo do RevenueCat e confirme o projeto e o período desejados.

Se você usa várias chaves secretas de projeto, associe cada uma ao projeto correto. Não nomeie todas as entradas apenas como “RevenueCat”; um apelido descritivo evita comparações acidentais entre clientes.

O que verificar depois da conexão

Comece pela identidade antes dos totais:

nome da conta ou da organização;
nome e identificador do projeto;
apps e lojas incluídos;
intervalo de datas e moeda selecionados;
se reembolsos ou ajustes para baixo estão incluídos na métrica exibida.

Depois, compare um período fechado com o painel do RevenueCat. Pequenas diferenças podem vir do momento da atualização, das regras de moeda ou das definições das métricas. Um projeto totalmente ausente geralmente indica um problema de escopo da credencial ou de associação do projeto, e não um erro de cálculo.

Acesso ao painel e webhooks são coisas separadas

O AdMate usa o RevenueCat de duas formas diferentes:

o app da Apple consulta os projetos configurados pelo usuário para obter os dados do painel;
a API do AdMate pode receber webhooks do RevenueCat para fluxos de notificação.

Configurar uma credencial para o painel não configura automaticamente um webhook, e criar um webhook não dá ao app permissão para listar as métricas de um projeto. Trate-os como tarefas separadas, com credenciais e finalidades separadas.

A API mantém um contexto temporário de dispositivo e projeto para que uma notificação possa mostrar nomes e moeda úteis. Esse contexto não é uma cópia no servidor de todo o histórico de receita do usuário nem do token de acesso.

Resolva um projeto ausente

A credencial é validada, mas só aparece um projeto

Verifique se a credencial pertence especificamente a esse projeto. Adicione ou associe as chaves necessárias, ou use o método compatível no nível da conta, se for adequado.

Nenhuma métrica aparece para um projeto válido

Selecione um intervalo de datas encerrado e com transações conhecidas, verifique os filtros de projeto e de loja e atualize no app principal. Um projeto novo ou inativo pode retornar zero corretamente.

A autorização falha de repente

A chave pode ter sido revogada, trocada ou copiada com espaços. Verifique o status dela no RevenueCat e substitua-a no AdMate. Não mantenha uma chave revogada como alternativa.

O nome do projeto está certo, mas o total parece errado

Verifique a definição da métrica, os reembolsos, a moeda e os limites das datas. Não compare diretamente a receita do RevenueCat com os proventos do App Store Connect até que os escopos estejam alinhados.

Proteja a credencial

nunca inclua a chave em análises, logs ou capturas de tela de diagnóstico;
não reutilize uma chave de projeto fora da organização a que se destina;
troque a chave se ela tiver sido exposta;
remova a conta do AdMate dos dispositivos que não devem mais ler o projeto;
revise os acessos periodicamente quando terminar a relação com um prestador ou cliente.

Continue com por que os totais dos provedores são diferentes antes de divulgar um número de receita combinado.

Perguntas frequentes

O AdMate pode conectar vários projetos do RevenueCat?

Sim. O modelo de conta oferece suporte a vários projetos e credenciais de projeto. Nomeie e verifique cada projeto antes de combinar as visualizações.

Uma chave pública de SDK do RevenueCat é suficiente?

Use o tipo de credencial solicitado pela configuração do RevenueCat no AdMate. Chaves públicas de SDK de apps e credenciais secretas de API têm finalidades diferentes.

O AdMate envia toda a receita de assinaturas para sua API?

Não. O app consulta diretamente os serviços configurados. O contexto do RevenueCat na API serve às notificações por webhook e não é um repositório de receita.

O que devo enviar ao suporte?

Envie o nome do projeto, o intervalo de datas, a métrica e o erro com dados ocultados. Nunca envie a chave secreta.