RevenueCat

A RevenueCat é a única fonte da verdade do status da sua inscrição em iOS, Android e web. Quer você esteja construindo um novo app ou já tenha milhões de assinantes, é possível usar a RevenueCat para criar compras em aplicativos multiplataforma, gerenciar seus produtos e assinantes e analisar seus dados – sem necessidade de código de servidor.

Esta integração é mantida pela RevenueCat.

Sobre a integração

A integração do RevenueCat e da Braze permite que você sincronize automaticamente os eventos do ciclo de vida de compra e inscrição dos seus clientes em todas as plataformas. Isso permite que você crie campanhas que reagem ao estágio do ciclo de vida da inscrição de seus clientes, como engajar com clientes que optaram por sair durante o período de teste gratuito ou enviar lembretes para clientes com problemas de faturamento.

Pré-requisitos

No mínimo, será necessário ativar a integração no dashboard da RevenueCat para conectá-la à Braze. Se você estiver usando o SDK da Braze, poderá usar os SDKs da RevenueCat e da Braze juntos para aprimorar a integração, garantindo que o mesmo identificador de cliente seja usado em ambos os sistemas.

Casos de uso

• Disparar uma campanha de integração destacando seus recursos premium quando um cliente iniciar um teste gratuito.
• Enviar um lembrete para atualizar as informações de cobrança quando um evento de “Problema de cobrança” for recebido.
• Enviar uma pesquisa de feedback após um cliente cancelar um teste gratuito.

Integração

Etapa 1: Definir identidade de usuário da Braze

No SDK da Braze, você pode definir o ID de usuário da Braze para corresponder ao ID de usuário do app da RevenueCat, garantindo que os eventos enviados da Braze e da RevenueCat possam ser sincronizados para o mesmo usuário.

Configure o SDK da Braze com o mesmo ID de usuário do app da RevenueCat ou use o método .changeUser() do SDK da Braze.

• swift
• objective-c
• java

1
2
3
4
5
6
7
8
9
// Configure Purchases SDK
Purchases.configure(withAPIKey: "public_sdk_key", appUserID: "my_app_user_id")

// Change user in Braze SDK
Appboy.sharedInstance()?.changeUser("my_app_user_id")

// Optional User Alias Object attributes
Purchases.shared.setAttributes(["$brazeAliasName" : "name",
                             "$brazeAliasLabel" : "label"])

1
2
3
4
5
6
7
8
9
10
11
// Configure Purchases SDK
[RCPurchases configureWithAPIKey:@"public_sdk_key" appUserID:@"my_app_user_id"];

// Change user in Braze SDK
[[Appboy sharedInstance] changeUser:@"my_app_user_id"];

// Optional User Alias Object attributes
[[RCPurchases sharedPurchases] setAttributes:@{
    @"$brazeAliasName": @"name",
    @"$brazeAliasLabel": @"label"
}];

1
2
3
4
5
6
7
8
9
10
11
12
// Configure Purchases SDK
Purchases.configure(this, "public_sdk_key", "my_app_user_id");

// Change user in Braze SDK
Braze.getInstance(context).changeUser(my_app_user_id);

// Optional User Alias Object attributes
Map<String, String> attributes = new HashMap<String, String>();
attributes.put("$brazeAliasName", "name");
attributes.put("$brazeAliasLabel", "label");

Purchases.getSharedInstance().setAttributes(attributes);

Enviar objeto de alias de usuário para a Braze (opcional)

Se você deseja enviar um identificador de usuário único alternativo diferente do ID de usuário do app RevenueCat, atualize os usuários com os seguintes dados como atributos de assinante do RevenueCat.

Ambos os atributos são necessários para que o objeto de alias do usuário seja enviado junto com seus dados de evento. Essas propriedades podem ser definidas manualmente, como qualquer outro atributo de assinante RevenueCat. Exemplos de snippets de código são mostrados na etapa 1.

Etapa 2: Enviar eventos do RevenueCat para a Braze

Depois de configurar o SDK de compras da RevenueCat e o SDK da Braze para ter a mesma identidade de usuário, você pode ativar a integração e configurar os nomes dos eventos no dashboard da RevenueCat.

1. Navegue até o seu projeto no dashboard da RevenueCat e encontre o cartão Integrations no menu à esquerda. Selecione + New.
2. Em seguida, selecione Braze entre as integrações disponíveis e adicione sua instância da Braze e a chave da API REST da Braze.
3. Digite os nomes dos eventos que o RevenueCat enviará ou escolha os nomes dos eventos padrão. Mais detalhes sobre os eventos disponíveis podem ser encontrados na etapa 3.
4. Selecione se deseja que a RevenueCat relate os rendimentos (após a comissão da app store) ou a receita (vendas brutas).

Etapa 3: Configurar nomes de eventos

Digite os nomes dos eventos que o RevenueCat enviará ou selecione entre os nomes de eventos padrão selecionando Use Default Event Names. Os eventos que a RevenueCat pode enviar estão descritos na tabela a seguir.

Para eventos que incluem receita, a RevenueCat registrará automaticamente esse valor junto com o evento na Braze, como conversões de teste e renovações.

Usando esta integração

Depois de definir as configurações da Braze na RevenueCat, os eventos começarão a fluir automaticamente da RevenueCat para a Braze sem qualquer outra ação da sua parte.

Personalização

Adicionar uma chave de API sandbox para testes

Se você fornecer apenas uma chave da API REST da Braze para a RevenueCat, apenas eventos de produção serão enviados. Se você também quiser enviar eventos de teste em sandbox, crie outra chave da API REST da Braze e adicione-a às suas configurações da Braze na RevenueCat.