Integração com RevenueCat

É necessária a ajuda do desenvolvedor

Você precisará da ajuda de sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.

O RevenueCat é uma plataforma de gerenciamento de assinaturas que simplifica as compras e assinaturas no aplicativo para empresas nas plataformas iOS, Android e web. Ele fornece ferramentas abrangentes para criar, analisar и aprimorar as assinaturas no aplicativo.

Ao integrar o Pushwoosh com o RevenueCat, as empresas podem enviar notificações push direcionadas, prompts no aplicativo e outras mensagens aos usuários com base em eventos de assinatura enviados do RevenueCat para o Pushwoosh. Isso pode incentivar os usuários a renovar assinaturas, atualizar para níveis superiores ou aproveitar ofertas especiais, melhorando o engajamento, maximizando a receita e simplificando o gerenciamento de assinaturas.

Casos de uso

Comunicação personalizada

As empresas podem usar a integração para personalizar a comunicação com os clientes. Por exemplo, uma plataforma de e-learning pode aumentar o engajamento do usuário enviando notificações push personalizadas ao detectar uma mudança no plano de assinatura. Essas notificações oferecem orientação na transição, recomendam cursos relevantes com base no novo plano e fornecem benefícios exclusivos alinhados com a atualização.

Notificações de problemas de faturamento

Quando a assinatura de um usuário enfrenta um problema de faturamento, as empresas podem usar a integração do RevenueCat com o Pushwoosh para enviar prontamente notificações direcionadas. Por exemplo, um serviço de streaming pode notificar o usuário sobre o problema de faturamento e fornecer instruções para resolvê-lo, como atualizar as informações de pagamento.

Notificações de compra não renovável

As empresas podem aproveitar a integração do RevenueCat com o Pushwoosh para transformar compras únicas em relacionamentos duradouros com os clientes. Por exemplo, um serviço de entrega de refeições pode enviar uma notificação push pós-compra agradecendo ao cliente e recomendando produtos relevantes ou promovendo um plano de assinatura para conveniência contínua. Isso promoverá a lealdade do cliente, impulsionará oportunidades de upsell e potencialmente converterá compradores únicos em assinantes.

Promoções de upgrade de nível

Aplicativos com vários níveis de assinatura podem usar a integração para monitorar as assinaturas dos usuários e enviar prompts de upgrade personalizados. Por exemplo, um aplicativo de jogos pode usar notificações push para destacar os benefícios dos níveis premium, como conteúdo exclusivo ou descontos, incentivando os usuários a elevar suas assinaturas.

Eventos

Cada webhook que o RevenueCat envia se torna um evento do Pushwoosh chamado RC_ mais o tipo de evento do RevenueCat, por exemplo, RC_INITIAL_PURCHASE, RC_RENEWAL, RC_CANCELLATION, RC_BILLING_ISSUE ou RC_EXPIRATION. O Pushwoosh cria o evento na primeira vez que chega um webhook desse tipo, então novos tipos de evento do RevenueCat aparecem no seu aplicativo automaticamente. Consulte Tipos de evento na documentação do RevenueCat para ver a lista completa.

Cada evento traz os campos do webhook do RevenueCat como atributos do evento, por exemplo, price, price_in_purchased_currency, currency, product_id, store, period_type, environment, country_code e entitlement_ids:

• Os campos que contêm um horário em milissegundos se tornam datas sem o sufixo _ms, por exemplo, purchased_at e expiration_at. A data em que o webhook foi enviado é o atributo timestamp.
• Essas datas estão em UTC e no formato YYYY-MM-DD, sem o horário do dia.
• Os atributos de cliente que você define no RevenueCat também se tornam atributos do evento. Atributos que identificam uma pessoa ou um dispositivo, como e-mail, número de telefone, nome de exibição, endereço IP, IDs de publicidade e tokens push, não são repassados ao Pushwoosh.
• Um evento mantém até 100 atributos.

As compras da App Store, do Google Play, da Mac App Store e da Amazon são registradas nas plataformas iOS, Android, macOS e Amazon. As compras de outras lojas, como Stripe, RevenueCat Billing ou concessões promocionais, são registradas sem plataforma.

Você pode usar esses eventos em suas Jornadas do Cliente. Eventos com o atributo price podem ser usados com a segmentação RFM.

Dica

Você também pode rastrear a receita de eventos como RC_INITIAL_PURCHASE, RC_RENEWAL ou RC_NON_RENEWING_PURCHASE (usando seus atributos price e currency) como eventos de conversão. Evite rastrear a receita de RC_CANCELLATION ou RC_EXPIRATION. Os eventos de conversão não suportam reembolsos nem estornos, então eles continuariam a ser contados como receita.

Configurando a integração

A integração funciona por meio dos webhooks do RevenueCat, disponíveis no plano Pro do RevenueCat.

Associar clientes do RevenueCat a usuários do Pushwoosh

O Pushwoosh registra um webhook para o usuário do Pushwoosh que ele indica e ignora um webhook que não indica nenhum usuário. Escolha como o RevenueCat indica o usuário:

• Se o seu aplicativo identifica os usuários com um ID próprio e o repassa ao RevenueCat como App User ID, use o App User ID como User ID do Pushwoosh.
• Se o App User ID for diferente do User ID do Pushwoosh, por exemplo, quando o RevenueCat usa IDs anônimos como $RCAnonymousID:…, envie os IDs do Pushwoosh como atributos do RevenueCat. Sem eles, os eventos vão para um User ID que o Pushwoosh não tem.

Usar o App User ID do RevenueCat como User ID do Pushwoosh

Defina o App User ID que você repassa ao RevenueCat como o User ID do Pushwoosh (setUserId).

Android

Java

Pushwoosh.getInstance().setUserId(appUserID);

iOS

Swift

Pushwoosh.configure.setUserId(appUserID)

Enviar os IDs do Pushwoosh como atributos do RevenueCat

Defina os atributos pushwooshUserId e pushwooshHwid no RevenueCat. O Pushwoosh os usa no lugar do App User ID:

• pushwooshUserId: o User ID do cliente no Pushwoosh.
• pushwooshHwid: o ID de hardware (HWID) do Pushwoosh do dispositivo do cliente. É opcional. Sem ele, o Pushwoosh usa o User ID como HWID.

Android

Kotlin

Purchases.sharedInstance.setAttributes(mapOf(
    "pushwooshUserId" to pushwooshUserId,
    "pushwooshHwid" to Pushwoosh.getInstance().hwid
))

iOS

Swift

Purchases.shared.attribution.setAttributes([
    "pushwooshUserId": pushwooshUserId,
    "pushwooshHwid": Pushwoosh.configure.getHWID()
])

Enviar webhooks do RevenueCat para o Pushwoosh

No painel do RevenueCat:

1. Abra o seu projeto, encontre o card Integrations no menu à esquerda e clique em + New.

2. Escolha Webhooks.

3. Se o RevenueCat mostrar a lista dos seus webhooks, clique em Add new configuration.
4. Dê à integração um nome simples, como Pushwoosh, para fácil identificação.
5. Insira a seguinte URL como a URL do webhook:

https://integration-revenuecat.svc-nue.pushwoosh.com/integration-revenuecat/v1/post-event?pwapp=APP_CODE

Na URL, substitua APP_CODE pelo código do seu aplicativo Pushwoosh existente, que está localizado abaixo do nome do seu aplicativo na sua conta Pushwoosh.

6. No campo Authorization header value, insira seu token da API do Pushwoosh. Você pode encontrar este token em Settings > API Access no Pushwoosh.

7. Decida se deseja transmitir eventos para compras de produção (ao vivo), compras de sandbox (teste) ou ambos.
8. No menu suspenso App, especifique se os eventos de webhook devem ser despachados para um único aplicativo ou para todos os aplicativos dentro do projeto.
9. No menu suspenso Event Type, selecione se deseja enviar todos os eventos ou especifique quais eventos enviar para o Pushwoosh.

10. Escolha mostrar todos os eventos, apenas eventos bem-sucedidos ou apenas eventos com falha.

Para verificar a conexão, envie um webhook de teste a partir do RevenueCat. Uma entrega bem-sucedida significa que o Pushwoosh aceitou a URL e o token da API. O webhook de teste em si não é registrado como evento: cada evento RC_ aparece em Público → Eventos no seu aplicativo do Pushwoosh assim que chega o primeiro webhook real desse tipo.