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 combine 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 qui se mettent à jour en temps réel au fur et à mesure du traitement des événements. Le modèle au niveau de la commande de ces calculs sépare clairement les prix des produits de la valeur totale de la commande.

Remarque

Les événements recommandés pour le commerce électronique ne remplissent pas la section Historique des achats de l’onglet Commerce. L’historique des achats est alimenté par les événements d’achat hérités. Utilisez les indicateurs du tableau suivant pour le chiffre d’affaires et l’activité de commande provenant des événements recommandés.

Panier actif

Le module Panier actif affiche le dernier panier 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 Panier actif inclut les éléments suivants :

• ID du panier — Identifiant du panier ayant reçu en dernier un é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 dans le panier actuel.
• Voir les produits — Un lien pour ouvrir la liste des produits dans le panier (jusqu’à 50 produits).

Orchestration eCommerce

Segmentation

Braze propose trois méthodes pour segmenter les utilisateurs en fonction des données eCommerce :

• Filtres eCommerce : Utilisez la catégorie eCommerce dans le segmenteur, qui contient des filtres basés sur les événements eCommerce recommandés (tels que Dernière commande passée, Chiffre d’affaires total et Valeur moyenne de commande). Pour la liste complète des filtres disponibles, consultez Filtres de Segment.
• Filtres d’événements personnalisés : Comme les événements eCommerce se comportent comme des événements personnalisés, tous les filtres d’événements personnalisés existants fonctionnent immédiatement. Par exemple, vous pouvez filtrer par « 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, y compris le tableau de produits imbriqué 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. Cela vous permet de créer des audiences comme « utilisateurs ayant acheté le produit SKU-123 au cours des 90 derniers jours » ou de combiner des critères sur différentes propriétés de la 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 que vous envoyez via l’API ou le SDK ne sont pas valides pour les filtres de propriétés d’extension, même si ces propriétés apparaissent dans vos données d’événement. L’utilisation d’une propriété de premier niveau non autorisée empêche l’enregistrement ou le désarchivage de l’extension.

Important

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

Déclenchement

Vous pouvez utiliser des déclencheurs d’événements personnalisés avec les événements eCommerce dans tout Braze, comme avec les autres événements personnalisés. Pour les flux de panier abandonné, utilisez le déclencheur Mettre à jour le panier pour capturer correctement les mises à jour du panier.

De plus, Braze propose un déclencheur dédié Passer une commande, qui vous permet de démarrer 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 également filtrer sur les propriétés portées par l’événement, de sorte qu’un déclencheur ne se déclenche 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. Comme chaque produit porte ses propres propriétés, products[].metadata.category correspond lorsque n’importe quel produit de la commande ou du panier satisfait 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, donc un filtre sur celle-ci ne correspond jamais.

Par exemple, combiner total_value est supérieur à 1000 avec products[].metadata.category égal à shoes ne déclenche que pour les commandes de haute valeur contenant des chaussures. Avant les filtres de propriétés, vous pouviez déclencher sur le passage d’une commande, mais pas sur ce que la commande contenait.

Les filtres de propriétés sont disponibles sur les surfaces suivantes :

• Passer une commande : Déclencheurs de Campaign et Canvas, événements d’exception, critères de sortie de Canvas, étapes de 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. Sur 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 Campaign et Canvas, événements d’exception, critères de sortie de Canvas et étapes de parcours d’action. Les propriétés de base et imbriquées sont prises en charge. Sur 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 s’appuie 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 lorsque aucun élément du tableau ne correspond. Un panier filtré sur products[].metadata.category n’est pas égal à shoes ne correspond que lorsque toutes les paires de chaussures ont été retirées du panier, et non lorsque le panier contient également d’autres catégories.

Les déclencheurs de messages in-app sont évalués sur l’appareil, donc Passer une commande ne peut pas cibler un produit spécifique ni filtrer sur des propriétés imbriquées à cet endroit. L’option Passer une commande pour un produit spécifique est désactivée dans le composeur. Pour agir sur un produit spécifique, utilisez une Campaign dans un autre canal ou un Canvas à la place.

Cibler une commande sur un produit spécifique

Pour ne déclencher que lorsqu’une commande contient un produit spécifique, ajoutez un filtre de propriété imbriquée sur le déclencheur Passer une commande. Ce n’est pas disponible sur les déclencheurs de messages in-app.

Comportements enregistrés avec ciblage de produit

Si vous avez configuré un comportement Passer une commande avant que les filtres de propriétés ne soient disponibles, 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 de correspondre exactement comme avant, de sorte que les Campaigns et Canvas existants ne sont pas affectés.

Pour migrer un comportement enregistré vers les filtres de propriétés, sélectionnez Passer n’importe quelle commande. Cela remplace les contrôles de ciblage de produit par des filtres de propriétés. Utilisez le tableau suivant pour recréer le même ciblage :

Important

Le passage d’un comportement à Passer n’importe quelle commande ne peut pas être annulé. Si vous en avez encore besoin, recréez le ciblage 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 les propriétés d’événement directement dans vos messages. Pour intégrer des images de produits, des prix ou d’autres données de catalogue dans 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 au paiement ou les confirmations de commande. Pour des exemples de code prêts à l’emploi, consultez les cas d’usage eCommerce.

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

Modèles Canvas eCommerce

Braze fournit des modèles 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, afin que vous puissiez lancer des flux de cycle de vie sans configuration personnalisée. Chaque modèle est livré avec 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 les 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 le contenu créatif pour 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 lorsque vous souhaitez ramener les visiteurs pour qu’ils reconsidèrent des produits 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 lorsque vous souhaitez rappeler aux utilisateurs les articles dans leur panier et les inciter à 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 le panier entier) ou les mises à jour incrémentales en utilisant les valeurs add et remove pour la propriété optionnelle action. Choisissez une approche par panier et évitez de mélanger le remplacement et les mises à jour incrémentales pour le même cart_id. Le panier stocké conserve la currency du dernier événement de panier ; une mise à jour du panier dans une devise différente remplace le panier stocké au lieu de mélanger les valeurs de 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 l’achat.

Utilisez ce modèle lorsque vous souhaitez récupérer des achats à l’étape du tunnel 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 et envoie ensuite une enquête de satisfaction pour collecter des avis et favoriser l’engagement post-achat.

Utilisez ce modèle lorsque vous souhaitez simplifier la communication post-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 ou ecommerce.product_viewed

Personnaliser les modèles

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

• Personnaliser l’e-mail : Chaque modèle comprend un e-mail préconfiguré créé avec l’éditeur par glisser-déposer, entièrement modifiable pour correspondre à 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 : Segmentez les utilisateurs par comportement (par exemple, panier de haute valeur par rapport à un panier de faible valeur) ou définissez des périodes d’attente entre les messages.
• Changer le contenu créatif : Remplacez le modèle d’e-mail inclus par le style visuel de votre marque.
• Utiliser les blocs de produits : Utilisez les blocs de produits par glisser-déposer (dans le programme d’accès anticipé) pour afficher dynamiquement le contenu du panier abandonné ou les produits consultés sans écrire de code Liquid personnalisé.

Pour des stratégies de cycle de vie plus avancées, y compris des exemples de personnalisation Liquid, consultez les cas d’usage eCommerce.

Rapports eCommerce

Les événements recommandés eCommerce alimentent les mêmes surfaces de chiffre d’affaires que les clients utilisent déjà aujourd’hui. Lorsque votre intégration envoie des événements eCommerce, les rapports suivants incluent automatiquement le chiffre d’affaires eCommerce :

Pour les champs calculés non liés à l’utilisateur (par exemple, le chiffre d’affaires d’une Campaign ou d’un Canvas), le chiffre d’affaires est calculé de la même manière dans tous les rapports : price multiplié par quantity par produit dans la commande, sommé sur l’ensemble des produits de chaque événement order_placed.

Remarque

Les calculs de chiffre d’affaires plafonnent les quantités individuelles de produits à 1 000 unités par commande. Si le champ de quantité est manquant 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 le plafond.

Si vous migrez des événements d’achat hérités vers ecommerce.order_placed, coordonnez-vous avec l’équipe de votre compte Braze avant d’effectuer toute modification de l’intégration. Pendant la période de transition, envoyez à la fois les événements d’achat hérités et les événements ecommerce.order_placed pour confirmer qu’ils se déclenchent correctement et pour préparer la migration de vos Campaigns, Canvas et Segments actifs vers le nouvel événement. Votre équipe de compte peut ensuite vous aider à planifier le basculement du reporting du chiffre d’affaires des événements d’achat hérités vers ecommerce.order_placed.

BrazeAI^TM

Predictive Events, Prédiction du taux d’attrition et les recommandations d’articles prennent en charge les événements eCommerce en tant qu’événements cibles et signaux, et disposent d’une option dédiée « Order Placed ». Le schéma standardisé rend ces modèles plus fiables, car les données sont cohérentes sur l’ensemble de votre base d’utilisateurs.

Exporter les données

Braze propose plusieurs moyens d’exporter les données d’événements eCommerce pour les utiliser dans votre entrepôt de données, vos outils de BI ou vos systèmes en aval. Les événements recommandés eCommerce sont exportés via les mêmes canaux que vos autres données d’événements.

Comment segmenter les utilisateurs par produit spécifique ?

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