Extension de transfert d’événement Braze Track Events API

Braze est une plateforme d’engagement client qui alimente les interactions centrées sur les clients entre les consommateurs et les marques en temps réel. En utilisant Braze, vous pouvez effectuer les opérations suivantes :

  • Diffusez des données (comme des messages marketing) à des utilisateurs ciblés en fonction de leurs préférences linguistiques, de leurs préférences d’emplacement, etc., afin d’augmenter les taux de conversion et de prendre en charge les principaux objectifs de l’entreprise.
  • Envoyez aux clients des messages personnalisés sur plusieurs canaux, y compris des e-mails, des notifications push et des messages in-app, au bon moment et dans les langues de leur choix.
  • Ciblez des utilisateurs spécifiques pour les campagnes marketing et promotionnelles afin d’augmenter le nombre de clients réguliers.
  • Étudiez le comportement et les schémas des utilisateurs pour cibler des audiences spécifiques avec des messages personnalisés, ce qui peut contribuer à augmenter les recettes.

L’extension Braze Track Events API de transfert d’événement vous permet d’exploiter les données capturées dans l’Edge Network Adobe Experience Platform et de les envoyer à Braze sous la forme d’événements côté serveur à l’aide de l’API Braze User Track.

Ce document couvre les cas d’utilisation de l’extension, comment l’installer dans vos bibliothèques de transfert d’événement et comment utiliser ses fonctionnalités dans un transfert d’événement rule.

Cas d’utilisation

Cette extension doit être utilisée si vous souhaitez utiliser les données de l’Edge Network dans Braze pour tirer parti de ses fonctionnalités d’analyse et de ciblage des clients.

Prenons l’exemple d’une entreprise de vente au détail présente sur plusieurs canaux (site web et mobile) et qui capture des entrées transactionnelles ou conversationnelles en tant que données d’événement de son site web et de ses plateformes mobiles. En utilisant diverses règles tag, ces données sont envoyées à l’Edge Network en temps réel. À partir de là, l’extension de transfert d’événement Braze envoie automatiquement les événements pertinents à Braze du côté serveur.

Une fois les données envoyées, les équipes d’analyse de l’entreprise peuvent alors exploiter les fonctionnalités Braze’s pour traiter les jeux de données et obtenir des informations sur l’entreprise afin de générer des graphiques, des tableaux de bord ou d’autres visualisations pour informer les parties prenantes de l’entreprise. Consultez la page Braze clients pour plus d’informations sur les différents cas d’utilisation de la plateforme.

Braze conditions préalables et barrières de sécurité prerequisites

Vous devez disposer d’un compte Braze pour pouvoir utiliser ses technologies. Si vous ne disposez pas d’un compte, accédez à la page de prise en main sur Braze pour vous connecter à Braze Sales et lancer le processus de création de compte.

Protections des API

L’extension utilise deux des API de Braze et leurs limites sont décrites ci-dessous :

API
Limites de taux
User Track
50 000 demandes par minute.
Pour plus d’informations, consultez la User Track documentation de l’API.
User Identify
20 000 demandes par minute.
Pour plus d’informations, consultez la User Identify documentation de l’API.
NOTE
Pour plus d’informations sur les limites qu’elles imposent, consultez le guide sur les Braze limites de l’API .

Points de données facturables

L’envoi d’attributs personnalisés supplémentaires à Braze peut augmenter la consommation de vos points de données Braze. Consultez votre gestionnaire de compte Braze avant d’envoyer des attributs personnalisés supplémentaires. Pour plus d’informations, consultez la documentation Braze sur les points de données facturables.

Collecte des détails de configuration requis configuration-details

Pour connecter l’Edge Network à Braze, les entrées suivantes sont requises :

Type de clé
Description
Exemple
Braze Instance
Point de terminaison REST associé au compte Braze. Pour plus d'informations, reportez-vous à la documentation Braze sur instances .
https://rest.iad-03.braze.com
Clé API
La clé d’API Braze associée au compte Braze.
Reportez-vous à la documentation Braze sur la clé API REST pour obtenir des conseils.
YOUR-BRAZE-REST-API-KEY

Créer un secret

Créez un nouveau secret de transfert d'événement 🔗et définissez la valeur sur votre Braze clé API. Elle sera utilisée pour authentifier la connexion à votre compte tout en conservant la valeur en sécurité.

Installation et configuration de l’extension Braze install

Pour installer l’extension, créez une propriété de transfert d’événement ou choisissez une propriété existante à modifier à la place.

Sélectionner Extensions dans le volet de navigation de gauche. Dans l’onglet Catalogue , sélectionnez Installer sur la carte de l’extension Braze.

Installez l’extension Braze.

Sur l’écran suivant, saisissez les valeurs de configuration suivantes que vous avez précédemment collectées à partir de Braze :

  • Braze Rest Endpoint URL : vous pouvez saisir la valeur de votre URL de point d’entrée rest Braze en tant que texte brut dans l’entrée fournie.
  • Clé API : sélectionnez l’ élément de données secret que vous avez créé précédemment, qui contient votre clé d’API Braze.

Lorsque vous avez terminé, cliquez sur Enregistrer.

La page de configuration de l’extension Braze.

Création d’une règle Send Event tracking-rule

Après avoir installé l’extension, créez un transfert d’événement rule et configurez ses conditions selon vos besoins. Lors de la configuration des actions pour la règle, sélectionnez l’extension Braze, puis sélectionnez Envoyer l’événement pour le type d’action.

Ajoutez une configuration daction de règle de transfert dévénement.

Identification de l’utilisateur

Entrée
Description
Identifiant utilisateur externe
UUID ou GUID longs, aléatoires et bien répartis. Si vous choisissez une autre méthode pour nommer vos ID utilisateur, ceux-ci doivent également être longs, aléatoires et bien répartis. En savoir plus sur la convention d’affectation de nom d’utilisateur suggérée.
Braze User ID
Identifiant de l’utilisateur de Braze.
Alias utilisateur
Un alias sert d’autre identifiant d’utilisateur unique. Utilisez des alias pour identifier les utilisateurs selon différentes dimensions que votre ID utilisateur principal.

L’objet user alias se compose de deux parties : un nom_alias pour l’identifiant lui-même et un libellé_alias indiquant le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias par alias_label.
NOTE
Pour lier l’événement à un utilisateur, vous devez renseigner le champ Identifiant utilisateur externe, le champ Identifiant utilisateur de braze ou la section Alias utilisateur.

Event Data

Entrée
Description
Obligatoire
Nom de l’événement ​
Nom de l’événement.
Oui
Heure de l’événement
Date-time sous la forme d’une chaîne au format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Oui
Identifiant d’application
L’identifiant d’application ou app_id est un paramètre qui associe une activité à une application spécifique de votre groupe d’applications. Il désigne l’application dans le groupe d’applications avec lequel vous interagissez. En savoir plus sur les types d’identifiants d’API.
Propriétés de l’événement ​
Objet JSON contenant des propriétés personnalisées de l’événement.
NOTE
L’action Braze Send Event ne nécessite qu’un Event Name et une Event Time à spécifier, mais vous devez inclure autant d’informations que possible dans le champ des propriétés personnalisées. Pour plus d’informations sur l’objet d’événement Braze, reportez-vous à la documentation officielle.

Attributs de l’utilisateur

Les attributs utilisateur peuvent être un objet JSON contenant des champs qui créeront ou mettront à jour un attribut avec le nom et la valeur fournis sur le profil utilisateur spécifié. Les propriétés suivantes sont prises en charge :

Attribut utilisateur
Description
Prénom
Nom
Phone
E-mail.
Genre
Une des chaînes suivantes : "M", "F", "O" (autre), "N" (non applicable), "P" (préférez ne pas dire).
Ville
Country
Pays sous forme de chaîne au format ISO-3166-1 alpha-2.
Langue
Langue sous forme de chaîne au format ISO-639-1.
Date de naissance
Chaîne au format "AAAA-MM-JJ" (par exemple, 1980-12-21).
Fuseau horaire
Nom du fuseau horaire de la base de données du fuseau horaire IANA (par exemple, "Amérique/New_York" ou "Heure de l’Est (États-Unis et Canada)").
Facebook
Hachage contenant n’importe quel identifiant (chaîne), mentions "J’aime" (tableau de chaînes), num_friend (entier).
Twitter
Hachage contenant n’importe quel ID (entier), screen_name (chaîne, nom du Twitter), followers_count (entier), friend_count (entier), statuses_count(entier).

Création d’une règle Send Purchase Event purchase-rule

Après avoir installé l’extension, créez un transfert d’événement rule et configurez ses conditions selon vos besoins. Lors de la configuration des actions pour la règle, sélectionnez l’extension Braze, puis sélectionnez Envoyer l’événement d’achat pour le type d’action.

Ajoutez une configuration daction de type Action de transfert dévénement de type Achat de braze.

Identification de l’utilisateur

Entrée
Description
Identifiant utilisateur externe
UUID ou GUID longs, aléatoires et bien répartis. Si vous choisissez une autre méthode pour nommer vos ID utilisateur, ceux-ci doivent également être longs, aléatoires et bien répartis. En savoir plus sur la convention d’affectation de nom d’utilisateur suggérée.
Braze User ID
Identifiant de l’utilisateur de Braze.
Alias utilisateur
Un alias sert d’autre identifiant d’utilisateur unique. Utilisez des alias pour identifier les utilisateurs selon différentes dimensions que votre ID utilisateur principal.

L’objet user alias se compose de deux parties : un nom_alias pour l’identifiant lui-même et un libellé_alias indiquant le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias par alias_label.
NOTE
Pour lier l’événement à un utilisateur, vous devez renseigner le champ External User ID, le champ Braze User Identifier ou la section User Alias .

Données d’achat

Entrée
Description
Obligatoire
ID de produit ​
Identifiant de l’achat. (par exemple, Nom du produit ou Catégorie de produit)
Oui
Temps d’achat
Date-time sous la forme d’une chaîne au format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Oui
​ de devise
Devise en tant que chaîne au format ISO 4217 Alphabétique du code de devise.
Oui
Prix ​
Prix.
Oui
Quantité ​
Si elle n’est pas fournie, la valeur par défaut est 1. La valeur maximale doit être inférieure à 100.
Identifiant d’application
L’identifiant d’application ou app_id est un paramètre qui associe une activité à une application spécifique de votre groupe d’applications. Il désigne l’application dans le groupe d’applications avec lequel vous interagissez. En savoir plus sur les types d’identifiants d’API.
Propriétés d’achat ​
Objet JSON contenant les propriétés personnalisées de l’achat.
NOTE
L’action Braze Send Event ne nécessite qu’un Event Name et une Event Time à spécifier, mais vous devez inclure autant d’informations que possible dans le champ des propriétés personnalisées. Pour plus d’informations sur l’objet d’événement Braze, reportez-vous à la documentation officielle.

Attributs de l’utilisateur

Les attributs utilisateur peuvent être un objet JSON contenant des champs qui créeront ou mettront à jour un attribut avec le nom et la valeur fournis sur le profil utilisateur spécifié. Les propriétés suivantes sont prises en charge :

Attribut utilisateur
Description
Prénom
Nom
Phone
E-mail.
Genre
Une des chaînes suivantes : "M", "F", "O" (autre), "N" (non applicable), "P" (préférez ne pas dire).
Ville
Country
Pays sous forme de chaîne au format ISO-3166-1 alpha-2.
Langue
Langue sous forme de chaîne au format ISO-639-1.
Date de naissance
Chaîne au format "AAAA-MM-JJ" (par exemple, 1980-12-21).
Fuseau horaire
Nom du fuseau horaire de la base de données du fuseau horaire IANA (par exemple, "Amérique/New_York" ou "Heure de l’Est (États-Unis et Canada)").
Facebook
Hachage contenant n’importe quel identifiant (chaîne), mentions "J’aime" (tableau de chaînes), num_friend (entier).
Twitter
Hachage contenant n’importe quel ID (entier), screen_name (chaîne, nom du Twitter), followers_count (entier), friend_count (entier), statuses_count(entier).

Validation des données dans Braze validate

Si la collecte d’événements et l’intégration de Adobe Experience Platform ont réussi, des événements s’affichent dans la console Braze lors de l’ affichage des profils utilisateur. Plus précisément, les nouvelles données d’événement envoyées à Braze sont reflétées dans la section Purchases de l’onglet aperçu d’un utilisateur particulier.

Étapes suivantes

Ce guide explique comment envoyer des événements de conversion vers Braze à l’aide du transfert d’événement. Pour plus d'informations sur les applications en aval pour les données d'événement envoyées à Braze, consultez la documentation officielle.

Pour plus d’informations sur les fonctionnalités de transfert d’événement en Experience Platform, consultez la présentation du transfert d’événement.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743