Conectar RevenueCat

Aponte o RevenueCat para o Clakta com um webhook para receber as compras, renovações e reembolsos do seu app automaticamente, e ligar cada venda ao anúncio que trouxe o usuário.

O RevenueCat envia as compras, renovações e reembolsos do seu app ao Clakta por um webhook. O Clakta te dá um endereço e um código de segurança, e você cola os dois no RevenueCat.

Conectar

No Clakta:

  1. Abra seu projeto e vá em Configurações do projeto → Plataformas de vendas.
  2. Encontre o RevenueCat e clique em Conectar.
  3. Dê à conexão um nome que você vá reconhecer depois, como Meu app, e clique em Criar conexão.
  4. O Clakta mostra dois valores: a URL do webhook e o Valor do header Authorization. Deixe essa janela aberta: você vai copiar os dois daqui a pouco.

No RevenueCat:

  1. Abra seu projeto, escolha Integrations no menu da esquerda e depois Webhooks.
  2. Clique em Add new configuration e dê um nome como Clakta.
  3. Cole a URL do webhook do Clakta em Webhook URL, e o Valor do header Authorization do Clakta em Authorization header value.
  4. Envie os eventos de compras de produção e de todos os apps do projeto. O Clakta não registra compras de sandbox, então enviá-las não muda nada.
  5. Deixe o filtro de eventos vazio, para que todos os eventos sejam enviados. O Clakta usa estes:
EventoPara que o Clakta usa
INITIAL_PURCHASERegistra a primeira cobrança de uma assinatura.
RENEWALRegistra cada renovação, inclusive a primeira cobrança depois de um teste grátis.
NON_RENEWING_PURCHASERegistra uma compra avulsa.
CANCELLATIONMarca a venda como reembolsada quando o cancelamento é um reembolso.
REFUND_REVERSEDMarca a venda como paga de novo quando um reembolso é revertido.

O Clakta ignora os outros eventos, então deixá-los ativos não atrapalha.

  1. Salve a configuração no RevenueCat.

De volta ao Clakta:

  1. Clique em Concluir.

O card passa a mostrar Adicionada. Vendas novas costumam aparecer em menos de um minuto depois de pagas. Vendas feitas antes da conexão não são importadas.

Ligar cada venda ao anúncio que trouxe o usuário

O RevenueCat só sabe o que o seu app conta para ele. Para o Clakta saber de onde veio cada comprador, o app precisa salvar essa informação no RevenueCat como atributos do cliente antes da compra. O Clakta lê estes:

AtributoO que colocar nele
clakta_session_idA sessão do visitante no Clakta, quando o usuário chegou pelo seu site.
clkt, utm_source, utm_medium, utm_campaign, utm_contentOs parâmetros do anúncio, quando o app os recebe (por exemplo, no link que abriu o app).
$emailO e-mail do comprador, para juntar as compras dele aqui com as de outras plataformas.
$displayNameO nome do comprador.

As renovações ficam com o mesmo anúncio da primeira cobrança. Sem esses atributos, as vendas são registradas do mesmo jeito, só que sem origem.

Se você mesmo desenvolve o app

Defina os atributos com o SDK do RevenueCat. No iOS:

O RevenueCat envia os atributos para os servidores dele quando a compra é feita, então você pode defini-los em qualquer momento antes dela.

Se o usuário começa pelo seu site, leia a sessão dele lá com clakta.getSessionId() e passe para o app, por exemplo no link que abre o app. Se você vende na web com o RevenueCat Billing, também pode colocar clakta_session_id nos metadados da compra.

Dúvidas comuns

Artigos relacionados