Conectar Superwall

Aponte o Superwall 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 Superwall envia as compras, renovações e reembolsos do seu app ao Clakta por um webhook: o Clakta te dá um endereço, e você cola esse endereço no Superwall.

Conectar

No Clakta:

  1. Abra seu projeto e vá em Configurações do projeto → Plataformas de vendas.
  2. Encontre o Superwall 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. Copie a URL do webhook que aparece. Deixe essa janela aberta.

No Superwall:

  1. Abra seu app, vá em Integrations e escolha Webhooks, dentro de Webhooks and tools.
  2. Clique em Create webhook. Dê um nome como Clakta e cole a URL que você copiou em Webhook URL.
  3. Deixe Events to listen for como está. Todos os eventos já vêm marcados, e 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.
REFUNDMarca a venda como reembolsada.

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

  1. Crie o webhook. O Superwall mostra a chave de assinatura uma única vez, logo em seguida. Copie a chave: ela começa com whsec_.

De volta ao Clakta:

  1. Cole a chave no campo Chave de assinatura e clique em Concluir.

O card passa a mostrar Adicionada. Vendas novas aparecem poucos segundos 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 Superwall 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 Superwall como atributos de usuário antes de mostrar o paywall. 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.

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 setUserAttributes do Superwall. No iOS:

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.

O que é registrado

Cada cobrança paga vira um pedido: a primeira compra, cada renovação e cada compra avulsa. O pedido fica na moeda em que o comprador pagou, ou em dólares americanos quando o Clakta não aceita essa moeda.

Começar um teste grátis não é uma venda. A primeira cobrança depois do teste é. Um reembolso total marca o pedido como reembolsado. Depois de um reembolso parcial, o pedido continua pago.

Compras em sandbox (TestFlight, contas de teste do Google Play, modo de teste do Stripe) não são registradas.

Dúvidas comuns

Artigos relacionados