Braze
En tant que l’une des meilleures solutions d’engagement client, Braze propose une large gamme d’outils pour les notifications push, les e-mails, les SMS et la messagerie in-app. En intégrant Adapty avec Braze, vous pouvez facilement accéder à tous vos événements d’abonnement en un seul endroit, ce qui vous permet de déclencher des communications automatisées basées sur ces événements.
Adapty fournit un ensemble complet de données qui vous permet de suivre les événements d’abonnement de tous les stores en un seul endroit et peut être utilisé pour mettre à jour les profils de vos utilisateurs dans Braze. Avec Adapty, vous pouvez facilement observer le comportement de vos abonnés, comprendre ce qu’ils apprécient et utiliser ces informations pour communiquer avec eux de manière ciblée et efficace. Cette intégration vous permet ainsi de suivre les événements d’abonnement dans votre tableau de bord Braze et de les associer à vos campagnes d’acquisition.
Adapty envoie les événements d’abonnement, les propriétés utilisateur et les achats à Braze, ce qui vous permet de créer des communications ciblées avec vos clients via les notifications push Braze après une intégration simple et rapide, comme décrit ci-dessous.
Comment configurer l’intégration Braze
Pour connecter Adapty à Braze, ouvrez Integrations → Braze dans l’Adapty Dashboard, activez le bouton bascule et renseignez les identifiants :
- REST API key et Braze Instance ID sont obligatoires.
- iOS App ID et Android App ID sont facultatifs.
- Pour créer la clé API REST, dans le tableau de bord Braze, allez dans Settings → APIs and Identifiers et cliquez sur Create API Key. Dans les permissions de données utilisateur, sélectionnez
users.track. Braze ne permet pas de modifier les permissions d’une clé après sa création, donc une clé sansusers.trackdoit être remplacée par une nouvelle. Pour plus de détails, consultez Creating REST API keys dans la documentation Braze. - Pour trouver l’ID d’instance Braze, comparez l’URL de votre tableau de bord Braze avec le tableau des instances dans la documentation Braze. L’ID d’instance a un format régional, tel que
US-03ouEU-01. Par exemple,dashboard-03.braze.comcorrespond àUS-03. - Pour trouver l’ID d’application iOS et l’ID d’application Android, dans le tableau de bord Braze, allez dans Settings → APIs and Identifiers → App Identifiers. Copiez la valeur dans la colonne Identifier pour chaque application. Pour plus de détails, consultez App identifier dans la documentation Braze.
Événements, attributs utilisateur et achats
Sous les identifiants, vous trouverez trois groupes d’événements que vous pouvez envoyer à Braze depuis Adapty. Activez simplement ceux dont vous avez besoin. Vous pouvez également modifier les noms des événements selon vos besoins avant de les envoyer à Braze. Consultez la liste complète des événements proposés par Adapty ici :
Adapty enverra les événements d’abonnement et les attributs utilisateur à Braze via une intégration serveur à serveur, vous permettant de les consulter dans votre Braze Dashboard et de configurer des campagnes en conséquence.
Pour les événements comportant des revenus, tels que les conversions d’essai et les renouvellements, Adapty enverra ces informations à Braze sous forme d’achats.
Adapty envoie les revenus à Braze uniquement sous forme d’événements d’achat legacy. Braze a placé les événements d’achat legacy en mode maintenance et ne les active pas pour les nouveaux clients. Si votre espace de travail Braze ne les accepte pas, Braze rejette chaque événement comportant des revenus avec un HTTP 400 et le message Legacy purchase ingestion is disabled. Ces événements, tels que les premiers achats, les renouvellements, les conversions d’essai et les remboursements, n’arrivent pas du tout dans Braze, pas seulement leurs revenus.
Avant d’activer l’intégration, assurez-vous que votre espace de travail Braze accepte les événements d’achat legacy. Pour plus de détails, consultez Purchase events dans la documentation Braze.
Ici vous trouverez les spécifications complètes des propriétés d’événements envoyées à Braze.
Attributs utilisateur utiles
Par défaut, Adapty envoie certains attributs utilisateur pour l’intégration Braze. Consultez la liste ci-dessous pour déterminer lesquels correspondent le mieux à vos besoins.
| Attribut utilisateur | Type | Valeur |
|---|---|---|
adapty_customer_user_id | String | Contient la valeur de l’identifiant unique de l’utilisateur défini par le client. Peut être trouvé dans le Dashboard Adapty et dans Braze. |
adapty_profile_id | String | Contient la valeur de l’identifiant unique Adapty User Profile ID de l’utilisateur, qui peut être trouvé dans le Dashboard Adapty. |
environment | String | Indique si l’utilisateur opère dans un environnement sandbox ou de production. Les valeurs sont soit |
store | String | Contient le nom du Store utilisé pour effectuer l’achat. Valeurs possibles :
|
vendor_product_id | String | Contient la valeur de l’ID produit dans le store Apple/Google. ex. : org.locals.12345 |
subscription_expires_at | String | Contient la date d’expiration du dernier abonnement. Le format de la valeur est : YYYY-MM-DDTHH:mm:ss.SSS+TZ ex. : 2023-02-15T17:22:03.000+0000 |
active_subscription | String | La valeur sera définie sur true lors de tout événement d’achat ou de renouvellement, ou sur false si l’abonnement est expiré. |
period_type | String | Indique le dernier type de période pour l’achat ou le renouvellement. Les valeurs possibles sont
|
Toutes les valeurs float seront arrondies en int. Les chaînes de caractères restent inchangées.
En plus de la liste prédéfinie de tags disponibles, il est possible d’envoyer des attributs personnalisés via des tags. Cela offre plus de flexibilité sur le type de données pouvant être incluses dans le tag et peut être utile pour suivre des informations spécifiques liées à un produit ou un service. Tous les attributs utilisateur personnalisés sont envoyés automatiquement à Braze si l’utilisateur coche la case Send user attributes depuis la page d’intégration.
Configuration du SDK
Pour lier les profils utilisateurs dans Adapty et Braze, vous devez soit configurer le SDK Braze avec le même identifiant utilisateur client qu’Adapty, soit utiliser sa méthode .changeUser() :
Dépannage
access_level_updated s’affiche comme ayant échoué dans le fil d’événements
access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.