RevenueCat

RevenueCat est la seule source de vérité pour votre état d’abonnement sur iOS, Android et le web. Que vous soyez en train de créer une nouvelle application ou que vous ayez déjà des millions d’abonnés, vous pouvez utiliser RevenueCat pour créer des achats in-app multiplateformes, gérer vos produits et vos abonnés, et analyser vos données — sans code serveur.

Cette intégration est maintenue par RevenueCat.

À propos de l’intégration

L’intégration de RevenueCat et Braze vous permet de synchroniser automatiquement les événements du cycle de vie des achats et des abonnements de vos clients sur les différentes plateformes. Cela vous permet de créer des campagnes qui réagissent à l’étape du cycle de vie de l’abonnement de vos clients, par exemple en engageant le dialogue avec les clients qui se sont désabonnés pendant leur essai gratuit ou en envoyant des rappels aux clients qui ont des problèmes de facturation.

Conditions préalables

Au minimum, vous devrez activer l’intégration depuis le tableau de bord de RevenueCat pour connecter RevenueCat à Braze. Si vous utilisez le SDK Braze, vous pouvez utiliser les SDK RevenueCat et Braze conjointement pour améliorer l’intégration en vous assurant que le même identifiant client est utilisé dans les deux systèmes.

Cas d’utilisation

• Déclenchez une campagne d’onboarding mettant en avant vos fonctionnalités premium lorsqu’un client commence un essai gratuit.
• Envoyez un rappel pour mettre à jour les informations de facturation lorsqu’un événement « Problème de facturation » est reçu.
• Envoyez une enquête de satisfaction après qu’un client a annulé un essai gratuit.

Intégration

Étape 1 : Définir l’identité de l’utilisateur Braze

Dans le SDK Braze, vous pouvez définir l’ID utilisateur Braze pour qu’il corresponde à l’ID utilisateur de l’application RevenueCat, ce qui garantit que les événements envoyés depuis Braze et RevenueCat peuvent être synchronisés avec le même utilisateur.

Configurez le SDK Braze avec le même ID d’utilisateur d’application que RevenueCat ou utilisez la méthode .changeUser() du SDK 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);

Envoi de l’objet alias d’utilisateur à Braze (facultatif)

Si vous souhaitez envoyer un identifiant unique différent de l’ID de l’utilisateur de l’application RevenueCat, mettez à jour les utilisateurs en utilisant les données suivantes comme attributs d’abonné RevenueCat.

Ces deux attributs sont nécessaires pour que l’objet alias d’utilisateur soit envoyé avec vos données d’événement. Ces propriétés peuvent être définies manuellement, comme tout autre attribut d’abonné RevenueCat. Des extraits de code sont présentés à la première étape.

Étape 2 : Envoyer des événements RevenueCat à Braze

Après avoir configuré le SDK d’achat RevenueCat et le SDK Braze pour qu’ils aient la même identité d’utilisateur, vous pouvez activer l’intégration et configurer les noms d’événements à partir du tableau de bord de RevenueCat.

1. Accédez à votre projet dans le tableau de bord RevenueCat et recherchez la carte Integrations dans le menu de gauche. Sélectionnez + New.
2. Ensuite, sélectionnez Braze parmi les intégrations disponibles et ajoutez votre instance Braze et la clé API REST Braze.
3. Saisissez les noms d’événements que RevenueCat enverra ou choisissez les noms d’événements par défaut. Vous trouverez plus de détails sur les événements disponibles à l’étape 3.
4. Indiquez si vous souhaitez que RevenueCat rapporte les recettes (après la commission de la boutique d’applications) ou le chiffre d’affaires (ventes brutes).

Étape 3 : Configurer les noms des événements

Saisissez les noms des événements que RevenueCat enverra ou sélectionnez les noms d’événements par défaut en cliquant sur Use Default Event Names. Les événements que RevenueCat permet d’envoyer sont décrits dans le tableau suivant.

Pour les événements qui incluent du chiffre d’affaires, RevenueCat enregistrera automatiquement ce montant avec l’événement dans Braze, comme les conversions d’essais et les renouvellements.

Utiliser cette intégration

Après avoir configuré les paramètres de Braze dans RevenueCat, les événements commenceront automatiquement à circuler de RevenueCat vers Braze sans aucune autre action de votre part.

Personnalisation

Ajouter une clé API d’environnement de test pour les tests

Si vous ne fournissez qu’une seule clé API REST Braze à RevenueCat, seuls les événements de production seront envoyés. Si vous souhaitez également envoyer des événements de test en bac à sable, créez une autre clé API REST Braze et ajoutez-la à vos paramètres Braze dans RevenueCat.