Configurer Braze

Braze est une solution d'analyse et un réseau publicitaire intégré dans Adjust. Notre intégration permet à Braze de recevoir les données d'événement in-app et d'attribution via des callbacks automatisés.

Dans cet article, découvrez comment configurer la mesure avec Braze pour votre application. Pour cela, vous devez activer l'intégration, envoyer des callbacks à Braze et choisir les données que Adjust peut partager avec Braze.

Avant de commencer

Prérequis

• Autorisations Administrateur, Éditeur ou Éditeur personnalisé dans Adjust.
• Adjust SDK v4.0.0+ pour mapper les paramètres du SDK avec les paramètres Braze. Suivez les guides ci-dessous pour utiliser cette fonctionnalité :

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade / Xamarin | Cocos2d-x | Titanium | Corona

Dans le dashboard Braze

Avant d'activer l'intégration Adjust avec Braze, complétez les étapes suivantes :

1. Mapper les ID d'appareil

Android

Si vous avez une application Android, vous devez transmettre un ID d'appareil Braze unique à Adjust. Utilisez la méthode addSessionPartnerParameter() dans le SDK Adjust pour définir cette valeur. Vous devez inclure ce snippet de code avant d'initialiser le SDK Android Braze sur Adjust.onCreate().

Adjust.addSessionPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId()););

iOS

Objective-C

Adjust collecte l'IDFV de votre application iOS et l'envoie à Braze. Braze mappe ensuite cet ID à un ID d'appareil unique.

Braze stocke les valeurs d'IDFA des utilisateurs consentants si vous collectez l'IDFA avec Braze. Dans les autres cas, l'IDFV est utilisé comme identifiant de fallback pour mapper les utilisateurs.

Swift

Si vous avez une application iOS, vous pouvez choisir de collecter l'IDFV en définissant le champ useUUIDAsDeviceId dans le SDK Braze Swift sur false. Si le champ n'est pas défini, l'attribution iOS ne sera pas mappée précisément d'Adjust vers Braze. Pour plus d'informations, reportez-vous à Collecte de l'IDFV dans la documentation Braze.

2. Générer la clé d'importation des données Braze

1. Dans Braze, accédez à Technology Partners , puis sélectionnez Adjust .
2. Vous y trouverez le REST Endpoint et pourrez générer votre Data Import Key Braze.

Après sa génération, vous pouvez créer une nouvelle clé ou invalider la clé existante. Utilisez la clé d'importation des données et le endpoint REST pour configurer l'intégration d'Adjust avec Braze. Pour plus d'informations, consultez la documentation Braze.

Sélectionnez Braze et votre application dans Campaign Lab

1. Sous Campaign Lab , sélectionnez Partenaires .
2. Sélectionnez Nouveau partenaire > Braze . Sélectionnez Suivant pour passer à l'écran suivant.
3. Dans l'écran Sélection d'app , choisissez l'application pour laquelle vous souhaitez créer le lien, puis activez l'intégration pour partager des données avec Braze.
4. Sélectionnez Suivant .

Activer le partage des données

Activez le partage des données pour activer l'intégration avec Braze. Pour activer le partage des données :

1. Saisissez votre clé d'importation des données et le endpoint.

Lorsque vous avez activé le partage des données avec Braze, Adjust envoie automatiquement à Braze les données suivantes par défaut :

• Installations

Remarque : Lorsque Braze reçoit des données sur une installation attribuée depuis Adjust, l'indicateur de connexion du statut dans la page des partenaires technologiques Adjust dans Braze passe de « Not Connected » à « Connected ». L'horodatage de la dernière requête réussie est également inclus.

Configurez vos options de partage de données

Si vous utilisez une application multiplateforme dont le partage des données est activé pour plusieurs plateformes, vous pouvez :

1. Séparer les options de partage des données au niveau de chaque plateforme en sélectionnant Utiliser les paramètres spécifiques à la plateforme .
2. Définir les mêmes paramètres de partage des données pour plusieurs plateformes en sélectionnant Utiliser les paramètres globaux .

Maintenant, sous Quelles sont les données partagées par défaut ? , vérifiez les activités partagées par défaut par Adjust avec Braze.

• Installations

Envoyer des données supplémentaires

Choisissez la quantité et le type de données que vous souhaitez partager avec Braze à travers les callbacks. Braze peut utiliser ces informations afin d'optimiser les performances.

Revenus in-app (issus des achats in-app)

Le transfert des revenus in-app permet Braze de recevoir les quantités de revenus avec vos données d'événements de revenus. Vous devez mapper les événements qui génèrent des revenus pour partager ces données.

Mapper les événements

Mappez les événements que vous souhaitez partager avec les valeurs que Braze peut recevoir. Les données des événements non mappés ne sont pas partagées avec Braze.

Mapper les événements individuels

Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec Braze. Cela vous permet de :

• Configurer des événements individuels afin de piloter les stratégies de campagne pour chaque plateforme.
• Personnaliser le partage des données par plateforme.

Sous Mapper les événements , procédez comme suit pour choisir les événements in-app à envoyer directement à Braze.

1. Sélectionnez Mapper l'événement .

2. Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec Braze.

3. Dans la section Événement partenaire , il est nécessaire de choisir l’événement Braze correspondant à l’événement Adjust.

   1. Pour les applications monoplateformes et les applications multiplateformes avec partage de données activé pour une seule plateforme, vous mappez les événements uniquement à cette plateforme. Pour les applications multiplateformes dont le partage des données est activé pour plusieurs plateformes, vous pouvez :

      • Choisissez l’option Utiliser le mappage spécifique à la plateforme pour mapper des événements distincts à chaque plateforme ou pour ne pas mapper d’événements à certaines plateformes.
      • Choisissez l’option Utiliser le mappage global pour mapper les mêmes événements à l’ensemble des plateformes.

   2. Dans la liste Événement partenaire , choisissez ou saisissez un nom d'événement personnalisé auquel vous souhaitez mapper l'événement Adjust.

4. Sélectionnez Appliquer .

À partir de là, Braze recevra les données des événements in-app pour chacun de vos événements liés.

Mapper tous les événements

Si Braze prend automatiquement en charge le mappage de tous les événements, dans la section Mapper les événements , sélectionnez l’option Mapper tous les événements . Cette manipulation permet de gagner du temps lors du mappage des événements individuels.

À partir de là, Braze recevra les données des événements in-app pour chacun des événements associés.

Mapper les paramètres

Vous devez généralement mapper les paramètres pour partager des données personnalisées avec Braze.

Les paramètres de partenaire (disponibles à partir de la version 4.0 du SDK Adjust) permettent à Adjust de collecter des points de données personnalisés à partir de votre application et de les transmettre directement à Braze. Braze reçoit alors le détail des événements personnalisés pour chacun de vos événements liés.

Avant d'ajouter de nouveaux paramètres de partenaire au SDK Adjust, assurez-vous qu'aucun autre paramètre de partenaire prédéfini ne satisfait déjà vos exigences.

Pour partager les paramètres de partenaire avec Braze, procédez comme suit :

1. Configurez les paramètres partenaires dans le SDK Adjust.

   • Effectuez la vérification avant de commencer pour tous les liens de la plateforme de développement du SDK.

2. Sous Définir vos options de partage des données , sélectionnez Paramètres .

3. Sous Mapper les paramètres , vous pouvez spécifiez la façon dont vous souhaitez envoyer les paramètres partenaires définis dans le SDK au réseau :

   1. Sélectionnez Mapper le paramètre .
   2. Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
   3. Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.

Activer Braze pour votre application

Dans l'écran Vérification de la configuration , vérifiez vos choix. Vous pouvez revenir en arrière et modifier les éléments suivants :

• L'application sélectionnée.
• Options de partage des données

Sélectionnez Activer le partenaire pour activer Braze pour votre application. Les partenaires d'analyses ne fonctionnent pas avec les liens pour les campagnes. Après activation, notre intégration envoie les données d'attribution et d'événements in-app à travers des callbacks automatisés.

Instructions de configuration spécifiques aux partenaires

Remarque : Le protocole Endpoint ne doit pas être saisi ; veillez donc à ne pas inclure https:// dans le champ d'activation. Enfin, notez que Braze nécessite des paramètres spécifiques pour recevoir les données de callback.

Paramètres prédéfinis

Braze vous permet d'envoyer un ensemble de paramètres prédéfinis. Si vous joignez certains de ces paramètres à un événement dans votre SDK Adjust, ils seront transférés vers Braze. Vous obtiendrez davantage d'informations sur l'association de paramètres de partenaire dans le fichier readme SDK spécifique au(x) SDK que vous utilisez. Voici une liste des paramètres définis acceptés par Braze :

Clé de paramètre> valeur

• external_id > obligatoire pour envoyer les événements à Braze.
• braze_device_id > obligatoire pour envoyer des données Android à Braze.
• product_id > obligatoire pour envoyer des événements de revenus à Braze Pour envoyer des callbacks d'événement à Braze, vous devez implémenter external_id comme paramètre de partenaire dans le SDK Adjust. Pour le transfert des événements de revenus, vous devez également configurer product_id comme paramètre de partenaire pour les événements.

Pour les applications Android, vous devez également implémenter braze_device_id comme paramètre de partenaire de session et d'événement. Enfin, pour le transfert des événements de revenus, vous devez également configurer product_id comme paramètre de partenaire pour les événements de revenus. Notez que Braze ne prend pas en charge les données organiques, Facebook ou Twitter ; les callbacks de ces campagnes ne seront pas envoyés.

Callbacks
Actuellement, Adjust ne transfère pas les données de campagnes organiques, Facebook et Twitter à Braze.

Pour découvrir comment tirer le meilleur parti de cette intégration, consultez notre page sur Braze. En cas de question concernant les informations fournies dans ce document, veuillez contacter partners@adjust.com.

Liste des paramètres transférés à Braze.

Braze demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :