Extension de transfert d’événements de l’API d’événements de suivi
L’extension de transfert d’événements de l’API d’événements de suivi de Braze vous permet d’exploiter les données capturées dans Adobe Experience Platform Edge Network et de les envoyer à Braze sous la forme d’événements côté serveur à l’aide de l’
/users/trackAPI.
Ce document décrit les cas d’utilisation de l’extension, comment l’installer dans vos bibliothèques de transfert d’événements et comment utiliser ses fonctionnalités dans une règle de transfert d’événements.
L’utilisation du transfert d’événements Adobe peut augmenter votre consommation de points données Braze. Pour plus d’informations, reportez-vous à la documentation de Braze sur les points de données.
Cas d’utilisation
Cette extension utilise les données du réseau Edge dans Braze pour tirer parti de ses capacités d’analyse et de ciblage des clients.
Prenons l’exemple d’une organisation de retail ayant une présence multicanal (site web et mobile) et capturant des entrées transactionnelles ou conversationnelles sous forme de données d’événement à partir de son site web et de ses plateformes mobiles.
À l’aide de diverses règles debalises, ces données sont envoyées en temps réel au réseau Edge. À partir de là, l’extension de transfert d’événements de Braze envoie automatiquement les événements pertinents à Braze depuis le serveur.
Limites de débit
| API | Limites de débit |
|---|---|
| Suivi des utilisateurs | 50 000 requêtes par minute. Reportez-vous à la documentation de l’API de suivi des utilisateurs pour plus de détails. |
Intégration
Étape 1 : Rassembler les détails de la configuration requise
Pour connecter le réseau Edge à Braze, les éléments suivants sont nécessaires :
| Type de clé | Description |
|---|---|
| Instance de Braze | Votre instance Braze peut être obtenue auprès de votre gestionnaire d’onboarding Braze ou sur la page d’aperçu de l’API. |
| Clé API REST de Braze | Une clé API REST Braze avec toutes les permissions. Celle-ci peut être créée dans le tableau de bord de Braze à partir de Paramètres > Clés API. |
Étape 2 : Créer un secret
Créez un nouveau secret de transfert d’événement et définissez la valeur de votre clé API Braze. Cela permet d’authentifier la connexion à votre compte tout en sécurisant la valeur.
Étape 3 : Installer et configurer l’extension Braze
- Pour installer l’extension, créez une propriété d’acheminement des événements ou choisissez une propriété existante à modifier à la place.
- Ensuite, sélectionnez Extensions dans la navigation de gauche. Dans l’onglet Catalogue, sélectionnez Installer sur la carte pour l’extension Braze.
- Sur l’écran suivant, saisissez votre instance REST et votre clé API, puis sélectionnez Enregistrer lorsque vous avez terminé.
Étape 4 : Créer une règle d’envoi d’événement
Après avoir installé l’extension, créez une nouvelle règle de transfert d’événements et configurez ses conditions comme vous le souhaitez. Lors de la configuration des actions pour la règle, sélectionnez l’extension Braze, puis sélectionnez Envoyer un événement pour le type d’action.
| Entrée | Description |
|---|---|
| ID d’utilisateur externe | Un UUID ou GUID long, aléatoire et bien distribué. Si vous choisissez une autre méthode pour nommer vos ID d’utilisateur, ils doivent également être longs, aléatoires et bien répartis. En savoir plus sur la convention de dénomination suggérée pour les ID d’utilisateurs. |
| ID de l’utilisateur de Braze | Identifiant de l’utilisateur de Braze. |
| Alias d’utilisateur | Un alias sert d’identifiant unique alternatif pour l’utilisateur. Utilisez des aliases pour identifier les utilisateurs selon d’autres critères que votre ID principal. L’objet alias d’utilisateur se compose de deux parties : un alias_name pour l’identifiant lui-même et un alias_label indiquant le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias_name par alias_label. |
Pour lier l’événement à un utilisateur, vous devez remplir soit le champ External User ID, soit le champ Braze User Identifier, soit la section User Alias.
| Entrée | Description | Exigée |
|---|---|---|
| Nom de l’événement | Nom de l’événement. | Oui |
| Heure de l’événement | Date-heure sous forme de chaîne de caractères au format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ. |
Oui |
| Identifiant de l’application | L’identifiant de l’application ou app_id est un paramètre qui associe l’activité à une application spécifique dans votre espace de travail. Il désigne l’application avec laquelle vous interagissez au sein de l’espace de travail. |
Non |
| Propriétés d’événement | Un objet JSON contenant les propriétés personnalisées de l’événement. | Non |
L’action Envoyer un événement de Braze ne requiert que la spécification d’un nom d’événement et d’une heure d’événement, mais vous devriez inclure autant d’informations que possible dans le champ des propriétés personnalisées. Reportez-vous à l’objet événement pour plus de détails.
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 de l’utilisateur | Description |
|---|---|
| Prénom | Prénom de l’utilisateur. |
| Nom de famille | Nom de famille de l’utilisateur. |
| Téléphone | Numéro de téléphone de l’utilisateur. |
| Adresse e-mail de l’utilisateur. | |
| Sexe | Une des chaînes de caractères suivantes : “M”, “F”, “A” (autre), “N” (sans objet), “P” (préfère ne pas se prononcer). |
| Ville | La ville de l’utilisateur. |
| Pays | Le pays de l’utilisateur sous forme de chaîne de caractères au format ISO-3166-1 alpha-2. |
| Langue | La langue de l’utilisateur sous forme de chaîne de caractères au format ISO-639-1. |
| Date de naissance | Les données de naissance de l’utilisateur sous forme de chaîne de caractères au format “AAAA-MM-JJ” (par exemple, 1980-12-21). |
| Fuseau horaire | Nom du fuseau horaire de la base de données IANA Time Zone (par exemple, ’America/New_York’ ou “Eastern Time (US & Canada)”). |
Un hachage contenant l’une des chaînes suivantes : id (chaîne de caractères), likes (tableau de chaînes de caractères), num_friends (nombre entier). |
|
Hash contenant l’un des éléments suivants : ID (nombre entier), screen_name (chaîne de caractères, identifiant X (anciennement Twitter)), followers_count (nombre entier), friends_count (nombre entier), statuses_count(nombre entier). |
Tous les attributs ajoutés dans la configuration seront envoyés à chaque fois que l’événement est envoyé à Braze, que la valeur de l’attribut ait changé ou non. Lorsque vous configurez les attributs de l’utilisateur, assurez-vous que vous savez comment cela affectera l’utilisation de vos points de données.
Étape 5: Créer une règle d’envoi d’événement d’achat
Après avoir installé l’extension, créez une nouvelle règle de transfert d’événements et configurez ses conditions comme vous le souhaitez. Lors de la configuration des actions pour la règle, sélectionnez l’extension Braze, puis sélectionnez Envoyer un événement d’achat pour le type d’action.
| Entrée | Description |
|---|---|
| ID d’utilisateur externe | Un UUID ou GUID long, aléatoire et bien distribué. Si vous choisissez une autre méthode pour nommer vos ID d’utilisateur, ils doivent également être longs, aléatoires et bien répartis. En savoir plus sur la convention de dénomination suggérée pour les ID d’utilisateurs. |
| ID de l’utilisateur de Braze | Identifiant de l’utilisateur de Braze. |
| Alias d’utilisateur | Un alias sert d’identifiant unique alternatif pour l’utilisateur. Utilisez des aliases pour identifier les utilisateurs selon d’autres critères que votre ID principal. L’objet alias d’utilisateur se compose de deux parties : un alias_name pour l’identifiant lui-même et un alias_label indiquant le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias_name par alias_label. |
Pour lier l’événement à un utilisateur, vous devez remplir soit le champ External User ID, soit le champ Braze User Identifier, soit la section User Alias.
| Entrée | Description | Exigée |
|---|---|---|
| ID du produit | Identifiant de l’achat. (par exemple, le nom du produit ou la catégorie du produit) | Oui |
| Délai d’achat | Date-heure sous forme de chaîne de caractères au format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ. |
Oui |
| Devise | Devise sous forme de chaîne de caractères au format du code alphabétique de la devise ISO 4217. | Oui |
| Prix | Le prix de l’objet. | Oui |
| Quantité | La quantité achetée. Si elle n’est pas fournie, la valeur par défaut est 1. La valeur maximale doit être inférieure à 100. | Non |
| Identifiant de l’application | L’identifiant de l’application ou app_id est un paramètre qui associe l’activité à une application spécifique dans votre espace de travail. Il désigne l’application avec laquelle vous interagissez au sein de l’espace de travail. |
Non |
| Propriétés d’achat | Un objet personnalisé JSON contenant les propriétés personnalisées de l’achat. | Non |
L’action Envoyer un événement d’achat ne nécessite que la spécification des paramètres Product ID, Purchase Time, Currency et Price, mais vous devez inclure autant d’informations que possible dans le champ des propriétés d’achat. Reportez-vous à l’objet de l’achat pour plus de détails.
Vous pouvez choisir d’envoyer ou non des attributs avec chaque événement dans la vue de configuration.
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 de l’utilisateur | Description |
|---|---|
| Prénom | Prénom de l’utilisateur. |
| Nom de famille | Nom de famille de l’utilisateur. |
| Téléphone | Numéro de téléphone de l’utilisateur. |
| Adresse e-mail de l’utilisateur. | |
| Sexe | Une des chaînes de caractères suivantes : “M”, “F”, “A” (autre), “N” (sans objet), “P” (préfère ne pas se prononcer). |
| Ville | La ville de l’utilisateur. |
| Pays | Le pays de l’utilisateur sous forme de chaîne de caractères au format ISO-3166-1 alpha-2. |
| Langue | La langue de l’utilisateur sous forme de chaîne de caractères au format ISO-639-1. |
| Date de naissance | Les données de naissance de l’utilisateur sous forme de chaîne de caractères au format “AAAA-MM-JJ” (par exemple, 1980-12-21). |
| Fuseau horaire | Nom du fuseau horaire de la base de données IANA Time Zone (par exemple, ’America/New_York’ ou “Eastern Time (US & Canada)”). |
Un hachage contenant l’une des chaînes suivantes : id (chaîne de caractères), likes (tableau de chaînes de caractères), num_friends (nombre entier). |
|
Hash contenant l’un des éléments suivants : ID (nombre entier), screen_name (chaîne de caractères, identifiant X (anciennement Twitter)), followers_count (nombre entier), friends_count (nombre entier), statuses_count(nombre entier). |
Tous les attributs ajoutés dans la configuration seront envoyés à chaque fois que l’événement est envoyé à Braze, que la valeur de l’attribut ait changé ou non. Lorsque vous configurez les attributs de l’utilisateur, assurez-vous de savoir comment cela affectera l’utilisation de vos points de données.
Étape 6 : Valider les données dans Braze
Si la collecte des événements et l’intégration d’Adobe Experience Platform ont réussi, vous verrez les événements dans la console Braze lorsque vous consulterez les profils utilisateurs. Plus précisément, les nouvelles données d’événement envoyées à Braze sont reflétées dans la section Achats ou Événements personnalisés de l’onglet d’aperçu d’un utilisateur particulier.
Modifier cette page sur GitHub