---
title: "Braze"
description: "Intégrez Braze avec Adapty pour un engagement client et des notifications push sans friction."
---

En tant que l'une des meilleures solutions d'engagement client, [Braze](https://www.braze.com/) 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](events) 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.](https://www.braze.com/product/journey-orchestration)

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 \{#how-to-set-up-braze-integration\}

Pour intégrer Braze, rendez-vous sur [Integrations -> Braze](https://app.adapty.io/integrations/braze), activez le bouton et remplissez les champs.

La première étape du processus d'intégration consiste à fournir les identifiants nécessaires pour établir une connexion entre vos profils Braze et Adapty. Vous aurez besoin de la **REST API Key**, de votre **Braze Instance ID** et des **App IDs** pour iOS et Android pour que l'intégration fonctionne correctement :

  <img src="/assets/shared/img/5f1e62c-adapty_braze.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

1. La **REST API Key** peut être créée dans **Braze Dashboard** → **Settings** → **API Keys**. Assurez-vous que votre clé dispose de la permission `users.track` lors de sa création :

  <img src="/assets/shared/img/b5fdf16-adapty_braze_create_api_key.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

  <img src="/assets/shared/img/1e5b4b8-adapty_braze_api_key_users_track.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

2. Pour obtenir le **Braze Instance ID**, notez l'URL de votre Braze Dashboard et rendez-vous dans la section des [Braze Docs](https://www.braze.com/docs/api/basics/#endpoints) où l'ID d'instance est spécifié. Il doit avoir une forme régionale telle que US-03, EU-01, etc.
3. Les App IDs iOS et Android se trouvent également dans Braze Dashboard → Settings → API Keys. Copiez-les depuis cet emplacement :

  <img src="/assets/shared/img/1e6d21b-adapty_braze_app_ids.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## Événements, attributs utilisateur et achats \{#events-user-attributes-and-purchases\}

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](events) :

  <img src="/assets/shared/img/702e628-adapty_braze_events_names.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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 générateurs de revenus, comme les conversions d'essai et les renouvellements, Adapty envoie ces informations à Braze sous forme d'achats.

[Ici](messaging#event-properties) vous trouverez les spécifications complètes des propriétés d'événements envoyées à Braze.

:::note
Attributs utilisateur utiles

Adapty envoie par défaut certains attributs utilisateur pour l'intégration Braze. Vous pouvez consulter la liste ci-dessous pour déterminer ceux qui 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](profiles-crm) 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](profiles-crm) Adapty. |
| `environment` | String | <p>Indique si l'utilisateur opère dans un environnement sandbox ou de production.</p><p></p><p>Les valeurs sont soit `Sandbox` soit `Production`</p> |
| `store` | String | <p>Contient le nom du Store utilisé pour effectuer l'achat.</p><p></p><p>Valeurs possibles :</p><p>`app_store` ou `play_store`.</p> |
| `vendor_product_id` | String | <p>Contient la valeur de l'ID produit dans le store Apple/Google.</p><p></p><p>ex. : org.locals.12345</p> |
| `subscription_expires_at` | String | <p>Contient la date d'expiration du dernier abonnement.</p><p></p><p>Le format de la valeur est :</p><p>YYYY-MM-DDTHH:mm:ss.SSS+TZ</p><p>ex. : 2023-02-15T17:22:03.000+0000</p> |
| `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 | <p>Indique le dernier type de période pour l'achat ou le renouvellement.</p><p></p><p>Les valeurs possibles sont</p><p>`trial` pour une période d'essai ou `normal` pour le reste.</p> |

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](segments#custom-attributes) 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](https://app.adapty.io/integrations/braze).

## Configuration du SDK \{#sdk-configuration\}

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()` :

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="iOS (Swift)" default>
```swift showLineNumbers
let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")
```
</TabItem>
<TabItem value="kotlin" label="Android (Kotlin)" default>
```kotlin showLineNumbers
Braze.getInstance(context).changeUser("adapty_customer_user_id")
```
</TabItem>
</Tabs>

## Dépannage \{#troubleshooting\}

### `access_level_updated` s'affiche comme ayant échoué dans le fil d'événements \{#access-level-updated-shows-as-failed-in-the-event-feed\}

`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.