Les événements produit vous permettent de suivre précisément comment vos contacts interagissent avec vos produits : consultation, ajout au panier, achat, etc. Ces informations peuvent ensuite être utilisées dans vos automatisations, segments et statistiques afin de mieux comprendre le comportement de vos clients et personnaliser vos messages.
Cet article vous explique comment envoyer des événements produit et présente les bonnes pratiques à suivre pour garantir un enregistrement correct de vos données.
Pour en savoir plus sur les événements produit, consultez l’article “Qu’est-ce qu’un événement produit ?”.
Vous pouvez envoyer des événements produit de deux manières :
Via le SDK Javascript
Via l’API REST
L’envoi d’événements produit est similaire à celui des événements classiques, avec quelques spécificités . Pour envoyer un événement produit, vous devez :
Utiliser le mot-clé product_event.
Inclure les attributs obligatoires : “product_id” and “event_type”.
Le nom du produit est facultatif. S’il n’est pas renseigné et que le produit n’existe pas encore, il sera créé sans nom.
La liste des types d’événements est fixe et ne peut pas être modifiée. Les types d’événements produit disponibles sont :
click
promo click
view
detail
liking
add to observation
reservation
add
add to cart
remove
checkout
checkout option
order
purchase
return
refund
Vous pouvez enrichir ces événements avec des attributs produit, comme “product name”, “category”, ou tout autre attribut personnalisé dont vous avez besoin.
Positive User ne conserve pas l’historique des valeurs des attributs d’événements produit (à l’exception de event_type). Chaque nouvel événement met à jour les valeurs dans la fiche du produit et remplace les anciennes.
Les attributs reflètent donc toujours la dernière valeur connue. Si vous devez suivre différentes variantes d’un même produit (par exemple, une paire de chaussures en plusieurs tailles), créez un produit distinct pour chaque variante avec un product_id unique.
Pour garantir une structure de données claire et exploitable, créez vos attributs produit avant de les envoyer. Cela vous permet de définir à l’avance le type de donnée le plus adapté (integer, boolean, date, etc.).
Si un attribut est envoyé sans avoir été préalablement crée, il sera défini automatiquement comme une chaîne de caractères (string). Les filtres seront alors moins pertinents, ce qui peut réduire la qualité de vos segments.
Pour connaître les types d’attributs disponibles et choisir le plus adapté, consultez l’article suivant.
Endpoints API REST pour envoyer un événement produit :
Exemple d’envoi d’un événement produit via l’API REST :
curl -X POST
"https://<your_app_subdomain>.user.com/api/public/products-by-id/"
-H 'authorization: Token <your_64_char_api_key>'
-H 'content-type: application/json'
-d '{
"name": "my product",
"custom_id": "my_product_id",
"product_url": "https://myshop.com/products/my_product/",
"image_url": "https://myshop.com/media/products/myproduct.jpg"
}'Si vous n’indiquez pas de nom pour le produit, le système vérifie d’abord si un produit avec ce “product_id” existe déjà.
Si ce n’est pas le cas, un nouveau produit sera créé avec ce “product_id”, mais sans nom.
Vous pouvez également déclencher un événement produit directement depuis le HTML, par exemple lorsqu'un contact clique sur un bouton ou un lien.
<a href="#"
onclick="userengage('product_event', {
product_id: 'the_id',
event_type: 'add to cart',
name: 'product name',
my_attribute: 'value',
my_attribute_2: 'value_2'
})">
CLICK ME!
</a>Pour conserver des données claires et exploitables, il est recommandé de définir vos attributs produit avant de les envoyer. Cela vous permet de choisir dès le départ le bon type de donnée (integer, boolean, date, etc).
Si un attribut est envoyé sans avoir été préalablement crée, il sera automatiquement défini comme une chaîne de caractères (string). Cela peut rendre les filtres moins efficaces et réduire la pertinence de vos segments.
Pour connaître les types d’attributs disponibles et choisir le plus adapté, consultez l’article suivant.
Pour envoyer des événements produit via JavaScript, assurez-vous que la requête inclut les paramètres requis.
Champs obligatoires :
product_id
event_type
Champs facultatifs :
name
description
tout autre attribut pertinent
Pour “event_type”, utilisez l’une des valeurs listées plus haut.
Exemple:
userengage("product_event", {
product_id: "12345",
event_type: "add to cart",
name: "Product Name",
description: "Product description"
});Comprendre l’intérêt et l’intention d’achat : Suivez les vues produit, clics, ajouts au panier et achats pour identifier les produits qui intéressent vos contacts et les étapes où ils quittent le parcours client.
Augmenter les conversions avec des suivis automatisés en temps réel : Utilisez les événements produit pour déclencher des automatisations basées sur le comportement client. Par exemple, envoyer des rappels ou des offres lorsqu'un contact ajoute un article au panier sans finaliser son achat.
Créer des segments plus précis pour un marketing ciblé : Segmentez vos contacts en fonction de leurs interactions réelles avec vos produits afin d’envoyer les bons messages aux bonnes audiences.
Mesurer l’engagement et optimiser la performance : Analysez les données pour identifier les produits populaires, suivre les tendances et repérer les produits à améliorer afin d’orienter vos décisions marketing et commerciales.
Augmenter le chiffre d’affaires avec des recommandations personnalisées : Appuyez-vous sur les événements d’achat passés pour proposer des produits pertinents, favoriser les ventes additionnelles et augmenter la valeur moyenne des commandes.
Utilisez le bon type de donnée pour chaque attribut afin de garantir la cohérence de vos données (par exemple, définir “Prix” comme floating-point number).
Personnalisez vos données produit en ajoutant des attributs adaptés aux besoins de votre entreprise, afin d’améliorer le suivi et l’analyse.
Une bonne gestion de vos données produit vous permettra de mieux les exploiter et d’optimiser l’efficacité de vos actions marketing.
Qu'est-ce qu'un produit ?
Tout savoir sur le flux de produits