Comment utiliser les événements eCommerce

Les événements recommandés pour le commerce électronique utilisent un schéma partagé au niveau de la commande, ce qui permet à Braze de construire des fonctionnalités fiables à partir de vos données eCommerce, notamment les profils utilisateur, la segmentation, l’envoi de messages, le reporting et les recommandations basées sur l’IA. Les sections de cet article expliquent comment utiliser chaque fonctionnalité dans Braze.

Consultez les schémas d’événements pour les exigences de propriétés et les types de données, et Validation et résolution des problèmes des événements pour savoir ce qui se passe lorsqu’un événement échoue à la validation.

Comme les événements eCommerce suivent un schéma prévisible, Braze peut construire des fonctionnalités fiables par-dessus, du suivi du chiffre d’affaires et des modèles de Canvas prêts à l’emploi aux recommandations basées sur l’IA. Les sections suivantes vous offrent un aperçu rapide de chaque fonctionnalité avec des liens vers la documentation complète.

Remarque

Les événements eCommerce de Braze et leurs propriétés d’événement segmentables ne sont pas comptabilisés dans les points de donnée.

Onglet Commerce

L’onglet Commerce de chaque profil utilisateur regroupe deux modules : Activité des commandes (indicateurs calculés de chiffre d’affaires et de commandes) et Panier actif (le dernier panier issu des événements ecommerce.cart_updated).

Activité des commandes

Le module Activité des commandes affiche trois indicateurs calculés, mis à jour en temps réel à mesure que les événements sont traités. Ces calculs reposent sur un modèle au niveau de la commande, qui distingue clairement les prix des produits de la valeur totale de la commande.

Panier actif

Le module Panier actif affiche le dernier panier enregistré sur le profil utilisateur. Cette vue est particulièrement utile pendant vos tests. Vous pouvez l’utiliser pour confirmer le contenu du panier, valider les parcours basés sur le panier ou vérifier que les événements ecommerce.cart_updated mettent bien à jour le profil comme prévu.

Le module Panier actif comprend les éléments suivants :

• ID du panier — Identifiant du panier ayant reçu le dernier événement ecommerce.cart_updated.
• Dernière mise à jour — Horodatage de la mise à jour la plus récente du panier.
• Valeur totale du panier — Valeur totale des articles du panier actuel.
• Voir les produits — Lien permettant d’ouvrir la liste des produits du panier (jusqu’à 50 produits).

Orchestration eCommerce

Segmentation

Braze propose trois façons de segmenter les utilisateurs à partir des données eCommerce :

• Filtres eCommerce : Utilisez la catégorie eCommerce du segmenteur. Elle contient des filtres alimentés par les événements eCommerce recommandés, comme Dernière commande passée, Chiffre d’affaires total et Valeur moyenne des commandes. Pour obtenir la liste complète des filtres disponibles, consultez Filtres de segmentation.
• Filtres d’événements personnalisés : Les événements eCommerce se comportent comme des événements personnalisés. Tous les filtres d’événements personnalisés existants fonctionnent donc immédiatement. Vous pouvez par exemple filtrer sur « A effectué l’événement personnalisé ecommerce.order_placed plus de X fois » ou « A effectué pour la première fois l’événement personnalisé ecommerce.order_placed ».
• Extensions de segments : Pour segmenter selon des propriétés d’événement imbriquées, comme le tableau imbriqué des produits ou les propriétés des objets de métadonnées, utilisez les extensions de segments avec le filtrage par propriétés d’événement imbriquées. Vous pouvez ainsi créer des audiences comme « utilisateurs ayant acheté le produit SKU-123 au cours des 90 derniers jours » ou combiner des critères portant sur différentes propriétés d’une même commande.

Si vous devez filtrer sur des propriétés personnalisées qui ne font pas partie du schéma d’événement documenté, imbriquez-les sous metadata lorsque vous enregistrez l’événement (par exemple, metadata.color au lieu de color). Les propriétés personnalisées de premier niveau envoyées via l’API ou le SDK ne sont pas valides pour les filtres de propriétés des extensions, même si elles apparaissent dans vos données d’événement. Une propriété de premier niveau absente de la liste autorisée empêche l’extension d’être enregistrée ou désarchivée.

Important

Les extensions de segments pour les événements eCommerce recommandés sont une fonctionnalité payante, disponible en accès anticipé. Si vous souhaitez participer à l’accès anticipé, contactez votre gestionnaire de la satisfaction client. Vérifiez que votre forfait inclut cet accès avant de recommander la segmentation par propriétés imbriquées à votre équipe.

Déclenchement

Vous pouvez utiliser les déclencheurs d’événements personnalisés effectués avec les événements eCommerce partout dans Braze, comme pour tout autre événement personnalisé. Pour les flux de panier abandonné, utilisez le déclencheur Mettre à jour le panier afin de bien capturer les mises à jour du panier.

Braze propose également un déclencheur dédié, Passer une commande, qui vous permet de lancer des parcours ou d’effectuer des actions lorsqu’un utilisateur passe une commande. Pour en savoir plus, consultez Livraison par événement.

Filtres de propriétés

Les déclencheurs Passer une commande et Mettre à jour le panier peuvent aussi filtrer sur les propriétés transmises par l’événement. Le déclencheur ne se lance alors que pour les commandes ou les paniers qui vous intéressent :

• Les propriétés de base correspondent à une propriété de premier niveau de l’événement, comme total_value ou currency.
• Les propriétés imbriquées examinent le contenu du tableau products. Chaque produit ayant ses propres propriétés, products[].metadata.category correspond dès qu’un produit de la commande ou du panier remplit la condition.

Imbriquez les champs de produit personnalisés sous metadata (par exemple, products[].metadata.brand). Une propriété de produit qui ne fait pas partie du schéma d’événement échoue à la validation : un filtre sur cette propriété ne correspondra donc jamais.

Par exemple, en combinant total_value supérieur à 1000 et products[].metadata.category égal à shoes, le déclencheur ne se lance que pour les commandes de grande valeur contenant des chaussures. Avant les filtres de propriétés, vous pouviez déclencher un envoi lorsqu’une commande était passée, mais pas en fonction de son contenu.

Les filtres de propriétés sont disponibles aux emplacements suivants :

• Passer une commande : déclencheurs de campagne et de Canvas, événements d’exception, critères de sortie de Canvas, étapes Parcours d’action, événements de conversion et événements de suppression de Content Card. Les propriétés de base et imbriquées sont prises en charge. Pour les déclencheurs de messages in-app, Passer une commande ne prend en charge que les propriétés de base.
• Mettre à jour le panier : déclencheurs de campagne et de Canvas, événements d’exception, critères de sortie de Canvas et étapes Parcours d’action. Les propriétés de base et imbriquées sont prises en charge. Pour les événements de conversion, les événements de suppression de Content Card et les déclencheurs de messages in-app, Mettre à jour le panier repose sur l’événement personnalisé ecommerce.cart_updated et ne prend en charge que les propriétés de base.

Remarque

Sur un filtre imbriqué, n’est pas égal à correspond lorsqu’aucun élément du tableau ne correspond. Un panier filtré sur products[].metadata.category n’est pas égal à shoes ne correspond qu’une fois toutes les paires de chaussures retirées du panier, et non lorsque le panier contient aussi d’autres catégories.

Les déclencheurs de messages in-app sont évalués sur l’appareil : Passer une commande ne peut donc pas y cibler un produit spécifique ni filtrer sur des propriétés imbriquées. L’option Passer une commande pour un produit spécifique est désactivée dans l’éditeur. Pour agir sur un produit spécifique, utilisez plutôt une campagne sur un autre canal ou un Canvas.

Limiter une commande à un produit spécifique

Pour déclencher un envoi uniquement lorsqu’une commande contient un produit spécifique, ajoutez un filtre de propriété imbriquée au déclencheur Passer une commande. Cette option n’est pas disponible pour les déclencheurs de messages in-app.

Comportements enregistrés limités à un produit

Si vous avez configuré un comportement Passer une commande avant la mise à disposition des filtres de propriétés, il utilise peut-être encore Passer une commande pour un produit spécifique avec un Identifiant de produit (nom du produit, product_id ou variant_id). Ces comportements enregistrés continuent de fonctionner et correspondent exactement comme avant : vos campagnes et Canvas existants ne sont pas affectés.

Pour faire passer un comportement enregistré aux filtres de propriétés, sélectionnez Passer n’importe quelle commande. Les contrôles de limitation par produit sont alors remplacés par des filtres de propriétés. Utilisez le tableau suivant pour recréer la même limitation :

Important

Le passage d’un comportement à Passer n’importe quelle commande est irréversible. Si vous avez toujours besoin de la limitation, recréez-la sous forme de filtre de propriété imbriquée.

Personnalisation Liquid

Les événements eCommerce prennent en charge la personnalisation Liquid de la même manière que les événements personnalisés : vous pouvez référencer directement les propriétés d’événement dans vos messages. Pour intégrer des images de produits, des prix ou d’autres données de catalogue à vos messages, joignez votre catalogue à l’événement en utilisant product_id ou variant_id comme identifiant de liaison. L’étiquette Liquid {% shopping_cart %} vous permet de parcourir le contenu actuel du panier d’un utilisateur pour les rappels de panier abandonné, les incitations à finaliser l’achat ou les confirmations de commande. Pour des exemples de code prêts à l’emploi, consultez Cas d’usage eCommerce.

Pour une alternative sans code, les blocs de produits par glisser-déposer sont disponibles dans le cadre du programme d’accès anticipé.

Modèles de Canvas eCommerce

Braze propose des modèles de Canvas prêts à l’emploi, préconfigurés avec les événements eCommerce recommandés comme critères d’entrée, de sortie et de conversion. Vous pouvez ainsi lancer des flux de cycle de vie sans configuration personnalisée. Chaque modèle inclut des designs d’e-mail par glisser-déposer et prend en charge les blocs de produits par glisser-déposer (actuellement en accès anticipé). Pour des cas d’usage détaillés et des exemples Liquid, consultez Cas d’usage eCommerce.

Ces modèles couvrent les flux de cycle de vie eCommerce les plus courants. Utilisez-les comme point de départ, puis personnalisez le timing, les canaux et les créations selon votre audience.

• navigation abandonnée
• panier abandonné
• paiement abandonné
• confirmation de commande et enquête

Réengage les utilisateurs qui ont consulté un produit sans l’ajouter à leur panier.

Utilisez ce modèle pour inciter les visiteurs à reconsidérer des produits qu’ils ont récemment consultés sans passer à l’action.

Paramètre	Valeur
Événement d’entrée	ecommerce.product_viewed
Événements de sortie	ecommerce.product_viewed, ecommerce.cart_updated, ecommerce.checkout_started, Commande passée
Événement de conversion	Commande passée

Récupère les utilisateurs qui ont ajouté des articles à leur panier sans commencer le paiement.

Utilisez ce modèle pour rappeler aux utilisateurs les articles de leur panier et les inciter à revenir finaliser leur achat.

Paramètre	Valeur
Événement d’entrée	ecommerce.cart_updated
Événements de sortie	ecommerce.cart_updated, ecommerce.checkout_started, Commande passée
Événement de conversion	Commande passée

Conseil

L’événement ecommerce.cart_updated prend en charge le remplacement complet du panier (chaque événement peut décrire l’intégralité du panier) ou les mises à jour incrémentielles à l’aide des valeurs add et remove de la propriété facultative action. Choisissez une seule approche par panier et évitez de mélanger remplacement et mises à jour incrémentielles pour un même cart_id. Le panier enregistré conserve la currency du dernier événement de panier : une mise à jour du panier dans une autre devise remplace le panier enregistré au lieu de mélanger des valeurs dans deux devises. Utilisez l’étiquette Liquid {% shopping_cart %} dans votre message pour afficher dynamiquement le contenu actuel du panier au moment de l’envoi.

Récupère les utilisateurs qui ont commencé le paiement sans finaliser leur achat.

Utilisez ce modèle pour récupérer des achats à l’étape de l’entonnoir où l’intention est la plus forte.

Paramètre	Valeur
Événement d’entrée	ecommerce.checkout_started
Événement de sortie	Commande passée
Événement de conversion	Commande passée

Confirme un achat réussi, puis envoie une enquête de satisfaction pour favoriser la collecte d’avis et l’engagement après l’achat.

Utilisez ce modèle pour simplifier la communication après l’achat et recueillir les retours des clients dans un seul flux de travail.

Paramètre	Valeur
Événement d’entrée	ecommerce.order_placed
Événement de conversion	Démarrer une session

Personnaliser les modèles

Ces modèles sont conçus comme point de départ. Voici quelques personnalisations courantes :

• Personnaliser l’e-mail : Chaque modèle comprend un e-mail préconfiguré, créé avec l’éditeur par glisser-déposer et entièrement modifiable pour l’adapter à votre marque et à votre contenu.
• Ajouter des canaux : Associez l’e-mail à des notifications push, des SMS ou des messages in-app pour un renforcement cross-canal.
• Ajouter des délais et des arbres décisionnels : Répartissez les utilisateurs selon leur comportement (par exemple, panier de grande valeur par rapport à panier de faible valeur) ou ajoutez des temps d’attente entre les messages.
• Changer les créations : Remplacez le modèle d’e-mail inclus par le style visuel de votre marque.
• Utiliser des blocs de produits : Utilisez les blocs de produits par glisser-déposer (dans le cadre du programme d’accès anticipé) pour afficher dynamiquement le contenu des paniers abandonnés ou les produits consultés sans écrire de code Liquid personnalisé.

Pour des stratégies de cycle de vie plus avancées, notamment des exemples de personnalisation Liquid, consultez Cas d’usage eCommerce.

Rapports eCommerce

Les événements eCommerce recommandés alimentent les mêmes vues de chiffre d’affaires que vos équipes utilisent déjà. Dès que votre intégration envoie des événements eCommerce, les rapports suivants intègrent automatiquement le chiffre d’affaires eCommerce :

Pour les champs calculés qui ne sont pas liés à l’utilisateur (par exemple, le chiffre d’affaires d’une campagne ou d’un Canvas), le calcul est identique dans tous les rapports : price multiplié par quantity pour chaque produit de la commande, puis additionné pour l’ensemble des produits de chaque événement order_placed.

Remarque

Les calculs de chiffre d’affaires plafonnent la quantité de chaque produit à 1 000 unités par commande. Si le champ de quantité est absent pour un produit, la valeur par défaut est d’une unité. L’événement ecommerce.order_placed d’origine conserve la quantité complète que vous avez envoyée : seul le calcul du chiffre d’affaires applique ce plafond.

Si vous migrez des anciens événements d’achat vers ecommerce.order_placed, coordonnez-vous avec votre équipe de compte Braze avant toute modification de l’intégration. Pendant la période de transition, envoyez à la fois les anciens événements d’achat et les événements ecommerce.order_placed afin de vérifier qu’ils se déclenchent correctement et de préparer la migration de vos campagnes, Canvas et segments actifs vers le nouvel événement. Votre équipe de compte pourra ensuite vous aider à planifier la bascule du reporting du chiffre d’affaires des anciens événements d’achat vers ecommerce.order_placed.

BrazeAI^TM

Les événements prédictifs, la prédiction du taux d’attrition et les recommandations d’articles prennent en charge les événements eCommerce comme événements cibles et signaux, avec une option dédiée « Order Placed ». Grâce au schéma standardisé, ces modèles gagnent en fiabilité, car les données sont cohérentes sur l’ensemble de votre base d’utilisateurs.

Exporter des données

Braze propose plusieurs façons d’exporter les données d’événements eCommerce vers votre entrepôt de données, vos outils de BI ou vos systèmes en aval. Les événements eCommerce recommandés sont exportés par les mêmes canaux que vos autres données d’événements.

Comment segmenter les utilisateurs selon un produit spécifique ?

Le segmenteur vous permet de filtrer selon le nombre de fois où un utilisateur a réalisé un événement eCommerce. Pour filtrer selon des propriétés de produit spécifiques (comme product_id ou product_name), utilisez les extensions de segments, qui prennent en charge le filtrage par propriétés d’événement imbriquées. Vous pouvez par exemple retrouver tous les utilisateurs ayant acheté le produit « SKU-123 » au cours des 90 derniers jours.