Événements et campagnes Shopify

Après avoir connecté l’app et approuvé les permissions demandées par Shopify pour le suivi des commandes, paniers et checkout (read_orders, write_pixels, read_customer_events), les événements de commande, checkout et étapes de checkout commencent à arriver sans écran de suivi Pushwoosh séparé. Voir Prérequis et Partie 1 pour l’étape d’approbation. La navigation sur la vitrine (vues de produit et ajout au panier) nécessite aussi Push Init Embed activé.

Le suivi couvre trois groupes d’événements indépendants. Chacun nécessite un accès différent, donc désactiver l’un ne met pas les autres en pause :

• Commande payée et checkout : arrivent depuis Shopify même si l’embed de thème est désactivé
• Navigation sur la vitrine (vues de produit et ajout au panier) : nécessite que l’embed de thème soit activé
• Étapes de checkout : nécessitent les permissions de suivi de checkout de Shopify de la Partie 1 (write_pixels et read_customer_events), approuvées séparément de la permission de suivi de commande (read_orders) ci-dessus

Avant de connecter l’app, vérifiez comment Pushwoosh gère les types d’attributs monétaires et de date pour PW_OrderCreated et PW_AbandonedCart. Un type incorrect envoyé avant que vous ne le remarquiez ne peut pas être corrigé rétroactivement.

Événements de commande payée et de checkout

Utilisez-les pour la messagerie post-achat (PW_OrderCreated), les journeys ou segments de checkout abandonné (PW_AbandonedCart / PW_AbandonedCartUpdate), et le mapping de conversion d’achat. Ils arrivent depuis Shopify même si l’acheteur bloque le suivi du navigateur :

Nécessite l'app connectée et read_orders approuvé

Aucun interrupteur supplémentaire au-delà de cela : connectez l’app dans la Partie 1 et approuvez la permission de suivi de commande de Shopify (read_orders). Contrairement à la navigation sur la vitrine, ces événements ne dépendent pas de l’activation de l’embed de thème.

Nom de l’événement dans Pushwoosh	Quand il se déclenche
PW_OrderCreated	Une commande est payée
PW_AbandonedCart	Un acheteur démarre le checkout
PW_AbandonedCartUpdate	L’acheteur ajoute, supprime ou modifie des articles pendant un checkout existant

Ceux-ci correspondent aux notifications de commande et de checkout que Shopify envoie automatiquement à Pushwoosh (les webhooks orders/paid, checkouts/create et checkouts/update, listés dans Entités synchronisées).

La propre condition de Shopify Flow, le webhook checkouts/create, et la source Cart du bloc Products sont trois choses différentes qui sont toutes appelées abandon de panier. Choisissez celle qui correspond à ce que vous construisez, en utilisant le tableau ci-dessous.

Ce que vous voulez construire	Ce qu’il faut utiliser
Rappel depuis Shopify Flow (la propre condition Cart abandonment de Shopify)	Shopify Flow + action Pushwoosh send notification. Pas les noms d’événement PW_AbandonedCart.
Rappel ou segment dans Pushwoosh sur checkout démarré ou panier modifié	Customer Journey ou segment sur PW_AbandonedCart / PW_AbandonedCartUpdate
Afficher les articles du panier de l’acheteur dans un e-mail	Source Cart du bloc Products (utilise le tag PW_AbandonedCartID au moment de l’envoi). Indépendant du déclencheur ayant démarré le journey.

Comment ces événements se comportent. checkouts/create signifie seulement qu’un checkout a été démarré. Shopify n’a pas encore décidé qu’il est abandonné, et aucune commande n’a été confirmée non plus.

Pendant que l’acheteur modifie le checkout, PW_AbandonedCartUpdate se déclenche à nouveau pour le même checkout et écrase le panier stocké depuis PW_AbandonedCart. Les e-mails de rappel qui utilisent la source Cart récupèrent les derniers articles au moment de l’envoi. Vous n’avez pas besoin d’un second déclencheur de journey juste pour actualiser le panier.

PW_AbandonedCart et PW_AbandonedCartUpdate définissent le tag PW_AbandonedCartID sur l’acheteur, que la source Cart lit au moment de l’envoi. PW_OrderCreated l’efface immédiatement, de sorte qu’un acheteur ayant déjà finalisé son checkout saute le bloc au lieu de recevoir un rappel pour un panier qu’il n’a plus. Voir Ce qui se passe quand vous envoyez PW_OrderCreated pour le comportement exact d’effacement.

Un acheteur qui démarre le checkout deux fois ne rentre dans le journey que si vous l'autorisez

Par défaut, un Customer Journey ne fait pas rentrer quelqu’un qui s’y trouve déjà, donc un second checkouts/create du même acheteur pendant que son premier journey de panier abandonné est encore en cours est ignoré, et non redémarré. Activez Allow re-entry sur le déclencheur si vous voulez que chaque nouveau checkout réinitialise le minutage de son rappel. Voir Contrôler si les utilisateurs peuvent rentrer dans la campagne.

Attributs des événements de commande et de checkout

PW_OrderCreated et PW_AbandonedCart incluent :

Attribut	Description
orderId	L’identifiant de la commande ou du checkout
email	L’e-mail de l’acheteur
totalPrice	Le total de la commande ou du panier
shippingAmount	Le coût de livraison
taxAmount	Le montant de la taxe
discountAmount	Le montant de la remise
currency	Le code de devise
items	Les lignes d’articles du panier
customerId	Seulement pour les clients enregistrés, absent pour les checkouts invités
orderUrl	La page de statut de commande pour PW_OrderCreated, ou l’URL de récupération du checkout abandonné pour PW_AbandonedCart et PW_AbandonedCartUpdate. Utilisez-la pour créer un lien ou bouton « Finaliser votre achat ».
createdDate	Quand la commande ou le checkout a été créé
abandonedDate	Seulement pour PW_AbandonedCart et PW_AbandonedCartUpdate. Quand le panier a été modifié pour la dernière fois, pas quand il a été créé pour la première fois

Obtenez les bons types d'attributs monétaires et de date

Pushwoosh déduit le type de chaque attribut à partir du premier événement qu’il voit, et cette déduction n’est pas fiable pour les champs monétaires et de date comme totalPrice, shippingAmount, taxAmount, discountAmount et createdDate/abandonedDate ci-dessus. Un prix en nombre entier comme 129 est déduit comme entier, ce qui tronque ensuite 129.90 à 129 à chaque événement ultérieur.

Vous n’avez pas encore connecté l’app ? Déclarez PW_AbandonedCart et PW_OrderCreated avec les bons types avant de le faire, en utilisant le tableau dans Créez les événements dans votre Control Panel. Ignorez l’étape Send the events from your backend de ce guide. L’intégration Shopify les envoie déjà pour vous.

Déjà connecté ? Vérifiez les types maintenant : allez dans Audience → Events dans le Control Panel, ouvrez PW_AbandonedCart et PW_OrderCreated, et comparez chaque attribut au même tableau. Corriger un type incorrect là-bas le corrige pour l’avenir, mais toute valeur déjà envoyée avec le mauvais type est perdue définitivement.

Les checkouts invités peuvent toujours envoyer des événements de commande et de panier, mais sans ID client enregistré sur l’événement.

PW_AbandonedCartUpdate porte les mêmes attributs. Si votre compte a aussi l’intégration Magento connectée, ses commandes et paniers abandonnés publient vers ces mêmes noms d’événement, donc un segment ou journey construit sur PW_OrderCreated / PW_AbandonedCart capture les deux boutiques, et les types d’attributs ci-dessus s’appliquent aussi aux deux. Magento n’a pas d’équivalent à PW_AbandonedCartUpdate, car il ne suit pas les modifications de checkout en cours.

items en particulier arrive depuis Shopify avec seulement quelques champs renseignés.

Les articles du panier sont enrichis depuis votre Catalogue de produits

Les items que Shopify envoie sur PW_AbandonedCart et PW_AbandonedCartUpdate ne portent que productId, name, sku, quantity et price. Pushwoosh complète tout ce qui manque encore pour cet article, comme description, imageUrl, productUrl, category et d’autres champs de catalogue, à partir du produit correspondant dans votre Catalogue de produits connecté (voir Connexion automatique du catalogue de produits), chaque fois qu’un productId correspond. Il n’y a rien de plus à envoyer pour cela. Un produit absent du catalogue continue simplement de s’afficher avec les champs envoyés par Shopify.

Événements de navigation sur la vitrine

Utilisez-les pour les segments ou journeys d’abandon de navigation, et pour les stratégies de recommandation par e-mail nécessitant des vues de produit (par exemple Based on what they viewed). Voir Comment configurer les recommandations de produits dans l’e-mail.

Nécessite Push Init Embed activé

Activez Push Init Embed dans la Partie 4. Le même embed de thème que pour le web push. Rien d’autre à ajouter au thème.

Si l’embed est désactivé, ou qu’un acheteur bloque son script, vous perdez uniquement les vues de produit et l’ajout au panier. PW_OrderCreated et PW_AbandonedCart arrivent quand même depuis Shopify.

Les deux événements sont collectés par le même embed de thème. Rien d’autre à ajouter au thème une fois que Push Init Embed est activé :

• PW_ProductViewed : l’acheteur ouvre une page produit.
• PW_AddToCart : l’acheteur ajoute un article au panier sans recharger la page, ce qui est la façon dont procèdent la plupart des thèmes Shopify.

Deux choses à vérifier avant de construire sur ces événements

• PW_ProductViewed compte chaque chargement de page, sans filtrage. Les rechargements, les vues répétées lors de la même visite, et même le trafic de bots comptent tous comme une vraie vue de produit. Une stratégie de recommandation construite sur cet événement hérite de ce bruit.
• PW_AddToCart ne se déclenche que si le bouton Add to cart de votre boutique ne recharge pas la page. Testez-le vous-même : cliquez sur Add to cart dans votre boutique et observez ce qui se passe. Seul le compteur du panier se met-il à jour, ou toute la page se recharge-t-elle ? La plupart des thèmes Shopify font le premier, mettant à jour le compteur sans rechargement (une requête en arrière-plan vers /cart/add). Si votre thème recharge la page à la place, PW_AddToCart ne se déclenchera jamais, mais PW_ProductViewed et les événements de commande/checkout fonctionneront quand même correctement.

Attributs des événements de navigation sur la vitrine

Les deux événements incluent :

Attribut	Description
items	Le(s) produit(s) vu(s) ou ajouté(s), chacun avec productId, name, sku, quantity, price
totalPrice	Le prix combiné des items
productUrl	La page sur laquelle se trouvait l’acheteur
currency	Seulement quand la vitrine l’expose

Un message affichant totalPrice a besoin d’une solution de repli pour le cas où currency est manquante, car le nombre seul n’indique pas dans quelle devise il est.

Aucun des deux événements ne porte email ni customerId comme attribut. L’acheteur est identifié de la même manière que le reste de l’embed de thème le fait, via la session SDK liée au User ID du métachamp (voir Partie 2), et non via la charge utile de l’événement.

Les items de PW_ProductViewed et PW_AddToCart portent les mêmes champs que Shopify envoie avant enrichissement : productId, name, sku, quantity, price. Pushwoosh ne complète pas le reste des champs du catalogue pour ces deux événements, contrairement à ce qu’il fait pour les items de PW_AbandonedCart (voir Les articles du panier sont enrichis depuis votre Catalogue de produits ci-dessus).

Une stratégie de recommandation nécessitant des détails complets sur le produit, comme Based on what they viewed, les recherche dans votre Catalogue de produits par productId au moment du rendu du message. Voir Comment configurer les recommandations de produits dans l’e-mail pour savoir ce dont chaque stratégie a besoin.

Événements des étapes de checkout

Utilisez-les pour voir où les gens abandonnent avant l’achat, et pour envoyer des messages aux personnes ayant démarré le checkout sans atteindre une commande payée.

Nécessite des permissions d'app liées aux pixels

Approuvez les permissions de suivi de checkout que Shopify demande lors de la connexion de l’app (write_pixels et read_customer_events). Voir la Partie 1 pour cette étape. Aucune étape d’embed de thème. Shopify signale ces étapes automatiquement une fois ces permissions approuvées (techniquement, via le Web Pixel de Shopify).

• PW_CheckoutContactInfo : l’acheteur a saisi ses informations de contact.
• PW_PaymentInfoSubmitted : l’acheteur a soumis ses informations de paiement.

Une vente complétée est PW_OrderCreated de la section ci-dessus, pas ces deux événements.

PW_AbandonedCart vous indique seulement qu’un checkout a démarré. Ces deux événements marquent deux points ultérieurs du même checkout, dans cet ordre : d’abord les informations de contact, puis les informations de paiement. Un acheteur ayant atteint PW_PaymentInfoSubmitted sans jamais obtenir un PW_OrderCreated suivant est allé plus loin que celui n’ayant déclenché que PW_AbandonedCart, donc un message construit sur cette étape peut adresser spécifiquement un paiement bloqué, plutôt qu’un rappel de panier générique.

Attributs des événements d’étapes de checkout

Les deux événements incluent :

Attribut	Description
items	Les lignes d’articles du checkout, chacune avec productId, name, sku, quantity, price
orderId	Le token de checkout, ou l’ID de commande Shopify une fois que le checkout en a un
totalPrice	Le total du checkout
email	Seulement quand le checkout en a un. Un checkout basé sur le téléphone (sans e-mail saisi) envoie l’événement sans lui.
currency	Seulement quand le checkout en a une

Vérifiez que ça fonctionne

Effectuez l’action correspondante dans la boutique, puis confirmez que le nom de l’événement apparaît dans Pushwoosh. L’événement lui-même est traité en temps réel, mais les deux endroits où vous le vérifieriez réagissent différemment à un nom que Pushwoosh n’a pas encore vu :

• Dans le menu déroulant Event lorsque vous créez un segment par événements, un nouveau nom apparaît immédiatement.
• Dans le menu déroulant Event lorsque vous ajoutez un déclencheur Customer Journey, un nouveau nom peut prendre jusqu’à 10 minutes pour apparaître (ce menu déroulant est mis en cache). Si vous ne le voyez pas encore, attendez plutôt que de supposer que l’intégration est cassée.

Action de test	Événement
Payer une commande de test	PW_OrderCreated
Démarrer un checkout	PW_AbandonedCart
Modifier des articles dans ce checkout	PW_AbandonedCartUpdate
Ouvrir une page produit (Push Init Embed activé)	PW_ProductViewed
Ajouter un article au panier	PW_AddToCart
Saisir les informations de contact au checkout	PW_CheckoutContactInfo
Soumettre les informations de paiement au checkout	PW_PaymentInfoSubmitted

Utilisez les événements

Une fois que vous savez de quel événement vous avez besoin, utilisez-le à deux endroits :

• Comme déclencheur ou condition de segment : choisissez-le dans le menu déroulant Event lorsque vous créez un segment par événements ou ajoutez un déclencheur Customer Journey.
• Dans le texte du message : à l’étape du message, activez Personalize message with event attributes et choisissez l’attribut (par exemple le total de la commande depuis PW_OrderCreated). Vous pouvez aussi insérer l’attribut avec un placeholder Liquid. Voir Contenu dynamique et modèles Liquid dans les journeys.

Pour les commandes payées, vous pouvez aussi mapper PW_OrderCreated comme événement de conversion afin que les achats Shopify alimentent la segmentation RFM, l’attribution de journey et les statistiques du bloc Product.

Exemples de campagnes

Chacune se déclenche à un point différent du parcours de l’acheteur, atteignant ainsi des audiences différentes : jusqu’où quelqu’un est allé avant d’abandonner, ou s’il a atteint le checkout, détermine laquelle s’applique.

• Rappel de panier abandonné. Capture tout acheteur ayant démarré le checkout, peu importe jusqu’où il est allé : l’audience la plus large ici. Construisez-le comme un Customer Journey : déclenchez sur PW_AbandonedCart, attendez PW_OrderCreated, puis envoyez un e-mail avec un bloc de source Cart à quiconque n’a pas payé. Voir Comment configurer une campagne de panier abandonné pour la configuration complète.
• Suivi pour checkouts bloqués. Capture uniquement les acheteurs ayant saisi leurs informations de contact mais n’ayant jamais payé, une tranche plus étroite de l’audience ci-dessus. Segmentez sur PW_CheckoutContactInfo, puis excluez ceux ayant aussi PW_PaymentInfoSubmitted ou PW_OrderCreated.
• Récupération d’un paiement bloqué. Capture les acheteurs ayant atteint le paiement mais n’ayant jamais complété la commande, plus avancés que le suivi ci-dessus et mutuellement exclusifs avec lui. Segmentez sur PW_PaymentInfoSubmitted, puis excluez ceux ayant aussi PW_OrderCreated.
• E-mail de recommandation de navigation. Capture les acheteurs ayant regardé des produits sans jamais démarrer de checkout, une audience différente des rappels ci-dessus. Utilisez PW_ProductViewed avec la stratégie Based on what they viewed du bloc Products. Voir Comment configurer les recommandations de produits dans l’e-mail.