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

Braze est une plateforme d’engagement client qui alimente en temps réel les interactions centrées sur le client entre les consommateurs et les marques. Utilisation 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.

La variable Braze Track Events API transfert d’événement l’extension 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 la variable Braze User Track API.

Ce document couvre 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 un transfert d’événement. règle.

Cas d’utilisation

Cette extension doit être utilisée si vous souhaitez utiliser les données du réseau Edge dans Braze pour tirer parti de ses capacités de ciblage et d’analyse client.

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. Utiliser divers tag règles, ces données sont envoyées au réseau Edge en temps réel. À partir de là, le Braze l’extension de transfert d’événement 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 tirer parti des Braze’s fonctionnalités permettant de traiter les jeux de données et d’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. Voir 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 Braze afin d'utiliser ses technologies. Si vous ne disposez pas d’un compte, accédez à la Page Prise en main on Braze pour se connecter à Braze Sales et démarrez le processus de création de compte.

Protections des API

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

API
Limites de taux
User Track
50 000 demandes par minute.
Voir User Track Documentation de l’API pour plus d’informations.
User Identify
20 000 demandes par minute.
Voir User Identify Documentation de l’API pour plus d’informations.
NOTE
Reportez-vous au guide sur Braze Limites de l’API pour plus de détails sur les limites qu'ils imposent.

Points de données facturables

Envoyer des attributs personnalisés supplémentaires à Braze peut augmenter votre Braze consommation des points de données. Consultez votre Braze gestionnaire de compte avant d’envoyer des attributs personnalisés supplémentaires. Voir Braze documentation sur points de données facturables pour plus d’informations.

Collecte des détails de configuration requis configuration-details

Pour connecter le réseau Edge à Braze, les entrées suivantes sont requises :

Type de clé
Description
Exemple
Braze Instance
Le point de terminaison REST associé à la variable Braze compte . Voir Braze documentation sur instances pour obtenir des conseils.
https://rest.iad-03.braze.com
Clé API
La variable Braze Clé API associée à Braze compte .
Voir Braze la documentation relative à la Clé API REST pour obtenir des conseils.
YOUR-BRAZE-REST-API-KEY

Créer un secret

Créer 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é.

Installez et configurez le Braze extension install

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

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

Installez le Braze extension .

Dans l’écran suivant, saisissez ce qui suit : valeurs de configuration que vous avez précédemment rassemblé à partir de Braze:

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

Lorsque vous avez terminé, cliquez sur Enregistrer.

La variable Braze page de configuration de l’extension.

Créez un Send Event règle tracking-rule

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

Ajoutez une configuration d’action 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 convention d’affectation des noms d’utilisateur suggérée.
Braquer l’identifiant utilisateur
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 la variable Identifiant utilisateur externe ou la variable Identifiant utilisateur de braquage ou le champ Alias utilisateur .

Données d’événement

Entrée
Description
Obligatoire
Nom de l’événement ​
Nom de l’événement.
Oui
Heure de l’événement
Date-time sous forme de chaîne dans ISO 8601 ou dans yyyy-MM-dd'T'HH:mm:ss:SSSZ format.
Oui
Identifiant de l’application
L’identifiant de l’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’identificateur d’API.
Propriétés de l’événement ​
Objet JSON contenant des propriétés personnalisées de l’événement.
NOTE
La variable Événement d’envoi de braquage une action ne requiert qu’un Nom de l’événement et Heure de l’événement à 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 la variable Braze , voir documentation officielle.

Attributs d’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
Pays
Pays sous forme de chaîne dans ISO-3166-1 alpha-2 format.
Langue
Langue sous forme de chaîne dans ISO-639-1 format.
Date de naissance
Chaîne au format "AAAA-MM-JJ" (par exemple, 1980-12-21).
Fuseau horaire
Nom du fuseau horaire à partir de Base de données des fuseaux horaires 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éez un Send Purchase Event règle purchase-rule

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

Ajoutez une configuration d’action de règle de transfert d’événement de type Action de blocage des achats .

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 convention d’affectation des noms d’utilisateur suggérée.
Braquer l’identifiant utilisateur
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 effectuer l’une des opérations suivantes : Identifiant utilisateur externe , le champ Identifiant utilisateur de braquage ou la variable Alias utilisateur .

Données d’achat

Entrée
Description
Obligatoire
​ d’ID de produit
Identifiant de l’achat. (par exemple, Nom du produit ou Catégorie de produit)
Oui
Temps d’achat
Date-time sous forme de chaîne dans ISO 8601 ou dans yyyy-MM-dd'T'HH:mm:ss:SSSZ format.
Oui
​ de devise
Devise en tant que chaîne dans ISO 4217 Format de code de devise alphabétique.
Oui
​ des 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 de l’application
L’identifiant de l’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’identificateur d’API.
Propriétés d’achat ​
Objet JSON contenant les propriétés personnalisées de l’achat.
NOTE
La variable Événement d’envoi de braquage une action ne requiert qu’un Nom de l’événement et Heure de l’événement à 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 la variable Braze , voir documentation officielle.

Attributs d’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
Pays
Pays sous forme de chaîne dans ISO-3166-1 alpha-2 format.
Langue
Langue sous forme de chaîne dans ISO-639-1 format.
Date de naissance
Chaîne au format "AAAA-MM-JJ" (par exemple, 1980-12-21).
Fuseau horaire
Nom du fuseau horaire à partir de Base de données des fuseaux horaires 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 Adobe Experience Platform l’intégration a réussi, vous verrez des événements dans la variable Braze lors de la console affichage des profils utilisateur. Plus précisément, les nouvelles données d’événement envoyées à Braze est reflété dans la variable Purchases de l’utilisateur onglet aperçu.

Étapes suivantes

Ce guide explique comment envoyer des événements de conversion à 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, reportez-vous au documentation officielle.

Pour plus d’informations sur les fonctionnalités de transfert d’événement dans Experience Platform, reportez-vous à la section transfert d’événement - Aperçu.

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