RevenueCat

RevenueCat es la única fuente de verdad para el estado de tu suscripción en iOS, Android y web. Tanto si estás creando una nueva aplicación como si ya tienes millones de suscriptores, puedes usar RevenueCat para crear compras dentro de la aplicación multiplataforma, gestionar tus productos y suscriptores, y analizar tus datos, sin necesidad de código de servidor.

Esta integración está mantenida por RevenueCat.

Sobre la integración

La integración de RevenueCat y Braze te permite sincronizar automáticamente los eventos del ciclo de vida de compra y suscripción de tus clientes en todas las plataformas. Esto te permite crear campañas que reaccionen a la etapa del ciclo de vida de suscripción de tus clientes, como interactuar con clientes que cancelaron durante su prueba gratuita o enviar recordatorios a clientes con problemas de facturación.

Requisitos previos

Como mínimo, necesitarás habilitar la integración desde el dashboard de RevenueCat para conectar RevenueCat con Braze. Si estás usando el SDK de Braze, puedes usar los SDK de RevenueCat y Braze juntos para mejorar la integración asegurándote de que se utiliza el mismo identificador de cliente en ambos sistemas.

Casos de uso

• Activa una Campaign de incorporación que destaque tus funciones premium cuando un cliente inicie una prueba gratuita.
• Envía un recordatorio para actualizar la información de facturación cuando se reciba un evento de “Problema de facturación”.
• Envía un cuestionario de opinión después de que un cliente cancele una prueba gratuita.

Integración

Paso 1: Establecer la identidad de usuario de Braze

En el SDK de Braze, puedes configurar el ID de usuario de Braze para que coincida con el ID de usuario de la aplicación RevenueCat, lo que garantiza que los eventos enviados desde Braze y RevenueCat puedan sincronizarse con el mismo usuario.

Configura el SDK de Braze con el mismo ID de usuario de la aplicación que RevenueCat o usa el método .changeUser() del SDK de 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 alias de usuario a Braze (opcional)

Si deseas enviar un identificador de usuario único alternativo distinto del ID de usuario de la aplicación RevenueCat, actualiza los usuarios con los siguientes datos como atributos de suscriptor de RevenueCat.

Ambos atributos son necesarios para que el objeto alias de usuario se envíe junto con los datos del evento. Estas propiedades pueden configurarse manualmente, como cualquier otro atributo de suscriptor de RevenueCat. En el paso uno se muestran fragmentos de código de ejemplo.

Paso 2: Enviar eventos de RevenueCat a Braze

Después de configurar el SDK de compras de RevenueCat y el SDK de Braze para que tengan la misma identidad de usuario, puedes activar la integración y configurar los nombres de los eventos desde el dashboard de RevenueCat.

1. Navega hasta tu proyecto en el dashboard de RevenueCat y busca la tarjeta Integrations en el menú de la izquierda. Selecciona + New.
2. A continuación, selecciona Braze entre las integraciones disponibles y añade tu instancia de Braze y tu clave de API REST de Braze.
3. Introduce los nombres de eventos que RevenueCat enviará o elige los nombres de eventos predeterminados. Encontrarás más información sobre los eventos disponibles en el paso 3.
4. Selecciona si deseas que RevenueCat informe de los ingresos netos (después del corte de la tienda de aplicaciones) o de los ingresos brutos (ventas brutas).

Paso 3: Configurar los nombres de los eventos

Introduce los nombres de eventos que RevenueCat enviará o selecciona entre los nombres de eventos predeterminados seleccionando Use Default Event Names. Los eventos que RevenueCat admite enviar se describen en el siguiente cuadro.

Para los eventos que incluyan ingresos, RevenueCat registrará automáticamente este importe junto con el evento en Braze, como las conversiones de prueba y las renovaciones.

Uso de esta integración

Después de configurar los ajustes de Braze en RevenueCat, los eventos comenzarán a fluir automáticamente de RevenueCat a Braze sin ninguna otra acción de tu parte.

Personalización

Añadir una clave de API de sandbox para pruebas

Si solo proporcionas una clave de API REST de Braze a RevenueCat, solo se enviarán los eventos de producción. Si también quieres enviar eventos de prueba de sandbox, crea otra clave de API REST de Braze y añádela a tu configuración de Braze en RevenueCat.