Intégration Shopify

Aperçu de l’intégration

Pushwoosh s’intègre de manière transparente avec Shopify, une plateforme de commerce électronique de premier plan qui permet aux entreprises de créer, gérer et développer des boutiques en ligne. Ce guide vous accompagne dans l’installation et la configuration de l’application Pushwoosh dans votre boutique Shopify, la mise en place de l’identification des utilisateurs, et l’utilisation des notifications et des outils d’automatisation pour engager les clients sur des canaux tels que les notifications push, les e-mails, les SMS et WhatsApp.

Type d’intégration

• Destination : Shopify envoie les données clients à Pushwoosh, où elles sont utilisées pour le ciblage et la messagerie.

Prérequis

• Un compte Pushwoosh
• Accès à votre panneau d’administration Shopify
• Le jeton d’accès à l’API de l’appareil et le code d’application de Pushwoosh
• Une boutique Shopify avec des données clients et de commandes disponibles
• L’approbation des portées d’accès read_orders, write_pixels et read_customer_events demandées par l’application, nécessaires pour les événements de commande/panier, le suivi des étapes de paiement et les événements comportementaux de la vitrine

Déjà connecté ? Il vous sera demandé de ré-approuver l'accès

Si vous avez connecté l’application Pushwoosh avant que le suivi des commandes, des paniers et des paiements n’existe, Shopify vous demande d’approuver les nouvelles portées la prochaine fois que vous ouvrez l’application — c’est la manière attendue dont Shopify déploie les autorisations supplémentaires, pas une erreur. Approuvez-les pour commencer à recevoir les événements de commande, de panier et de paiement.

Entités synchronisées

• Clients : Utilisés pour attribuer et identifier les UserID de Pushwoosh via les méta-champs de Shopify

Note

Approches de synchronisation des clients dans Pushwoosh

En raison de limitations techniques, Pushwoosh propose plusieurs méthodes de synchronisation des clients, en fonction du canal de communication utilisé pour les notifications :

• E-mail, Web, SMS & WhatsApp : Les appareils/utilisateurs sont automatiquement enregistrés dans l’application Pushwoosh.
• Applications mobiles & de bureau : Les appareils/utilisateurs peuvent être synchronisés manuellement via les panneaux d’administration de Pushwoosh et de Shopify.
• Plateformes Web (Chrome, Firefox, Safari) : Les appareils/utilisateurs sont gérés par l’intégration du thème Shopify elle-même.

Comment ça marche ?

Le processus de synchronisation fonctionne comme suit :

1. Le système tente de récupérer la session utilisateur actuelle pour obtenir une adresse e-mail ou un numéro de téléphone (identifiants qui fonctionnent sans configuration supplémentaire).
2. En cas de succès, l’adresse e-mail ou le numéro de téléphone est défini comme l’identifiant userID à la fois pour Pushwoosh et pour la propriété pushwoosh_userid dans les données client.
3. Si ce n’est pas possible, le userID par défaut du SDK Pushwoosh est attribué comme identifiant à la fois pour Pushwoosh et pour la propriété pushwoosh_userid.
4. Dans tous les cas, un userID sera attribué des deux côtés, assurant une synchronisation cohérente.

• Segments de clients : Utilisés pour le ciblage et la messagerie basés sur des groupes
• Événements et déclencheurs (par ex., commandes passées, tags appliqués) : Utilisés dans Shopify Flow pour automatiser la messagerie sur tous les canaux
• Vitrine : Utilisée pour capturer les opt-ins aux notifications push web via des scripts intégrés
• Flux de produits : Le flux de la vitrine de votre boutique (products.json) se connecte automatiquement au Catalogue de produits de Pushwoosh lorsque vous connectez l’application, et se déconnecte automatiquement si vous la désinstallez.
• Commandes et paniers : Événements de serveur à serveur provenant des webhooks orders/paid et checkouts/create de Shopify. Voir Suivre les commandes, les paniers et les étapes de paiement.
• Comportement de navigation sur la vitrine : Vues de produits et actions d’ajout au panier, collectées par la même intégration de thème utilisée pour les opt-ins aux notifications push web.
• Étapes de paiement : Informations de contact saisies et informations de paiement soumises, collectées via un Web Pixel de Shopify.

Glossaire (correspondance des noms d’entités s’ils sont différents)

Shopify	Pushwoosh
Client	UserID
Webhook orders/paid	Événement PW_OrderCreated — partagé avec d’autres intégrations e-commerce (par ex. Magento)
Webhook checkouts/create	Événement PW_AbandonedCart — même événement partagé, également utilisé par la source Panier du bloc Produits
Vue de la page produit	Événement PW_ProductViewed

Comment fonctionne l’intégration

Pushwoosh agit comme une destination de messagerie pour Shopify. Une fois intégrée, Shopify envoie les données clients et comportementales à Pushwoosh, où elles alimentent les notifications en temps réel, la segmentation des clients et la messagerie personnalisée sur tous les canaux.

Composants clés de l’intégration

1. Identification du client via les méta-champs Chaque client Shopify se voit attribuer un UserID unique, stocké dans un méta-champ (custom.pushwoosh_userid). Cet ID permet à Pushwoosh de reconnaître et d’envoyer des messages aux utilisateurs de manière cohérente sur toutes les plateformes.

2. Automatisation basée sur les événements via Shopify Flow Pushwoosh fournit des actions Flow qui vous permettent d’automatiser la messagerie (push, e-mail, SMS, WhatsApp) en fonction des événements Shopify, tels que :

   • Nouvelle commande passée
   • Tag appliqué à un client
   • Abandon de panier

3. Ciblage basé sur les segments Les segments de clients de Shopify peuvent être utilisés pour envoyer des notifications spécifiques à des groupes sur tous les canaux, comme des promotions pour les nouveaux acheteurs ou des campagnes de réactivation pour les utilisateurs inactifs.

4. Messagerie manuelle et en temps réel Depuis la vue client ou segment de Shopify, vous pouvez déclencher manuellement des notifications à l’aide des extensions Pushwoosh :

   • Notification par client : Pour des suivis personnels ou des tests
   • Notification par segment : Pour des messages basés sur des campagnes

Notifications push web via l’intégration à la vitrine

En activant l’intégration Pushwoosh dans votre thème Shopify, vous pouvez inciter les visiteurs de votre site web à s’inscrire aux notifications push basées sur le navigateur — aucune application mobile n’est requise.

Aperçu du flux de données

Données client et d'événements Shopify
         ↓
API Pushwoosh (via l'application)
         ↓
UserID → Segmentation → Notifications déclenchées ou manuelles

Cette intégration vous permet de délivrer des messages pertinents et opportuns qui améliorent la rétention des utilisateurs, augmentent les conversions et améliorent l’expérience client — automatiquement ou à la demande.

Partie 1. Installation

Se connecter à Shopify

1. Allez à l’administration Shopify
2. Sélectionnez votre boutique depuis le tableau de bord

Note

Ce guide suppose que vous avez déjà un compte Pushwoosh. Sinon, créez-en un

Installer l’application Pushwoosh

1. Visitez la page de l’App Store de Pushwoosh
2. Cliquez sur Installer
3. Confirmez l’installation dans la boîte de dialogue de Shopify

Connecter votre application Pushwoosh

Après l’installation, vous serez redirigé vers l’application Pushwoosh à l’intérieur de Shopify.

1. Cliquez sur Connecter.

2. Saisissez le Code d’application et le Jeton d’accès à l’API de l’appareil, que vous pouvez trouver dans le Panneau de contrôle Pushwoosh → Paramètres → Accès API.

Une fois connecté, un message de succès apparaîtra : “Application Pushwoosh connectée.”

Connexion automatique du catalogue de produits

La connexion de l’application connecte également automatiquement le flux de la vitrine de votre boutique au Catalogue de produits de Pushwoosh — aucune configuration de flux séparée n’est nécessaire. La devise de votre boutique est capturée en même temps, et se met à jour automatiquement si vous changez la devise de votre boutique par la suite.

S’abonner à un plan

1. Cliquez sur Mettre à niveau l’abonnement
2. Un seul plan basé sur l’utilisation sera affiché.
3. Confirmez la facturation.

Note

La facturation est requise pour utiliser les fonctionnalités de livraison de messages et de segmentation.

Partie 2. Configuration : ID utilisateur du client via les méta-champs

Pour délivrer des notifications à des utilisateurs identifiés sur tous les canaux (push, e-mail, SMS, WhatsApp), Pushwoosh utilise un ID utilisateur unique par client. Shopify stocke cette valeur dans les Méta-champs client de Shopify.

1. Allez dans Paramètres → Méta-champs et méta-objets → Clients

2. Cliquez sur Ajouter une définition et utilisez ces valeurs :

Champ	Valeur
Espace de noms et clé	custom.pushwoosh_userid
Espace de noms	custom
Type	Texte sur une seule ligne
Validation	Aucune
Accès au compte client	Lecture et écriture
Accès à l’API de la vitrine	Activé

Pourquoi c'est important

Ce méta-champ est un identifiant utilisateur persistant sur les appareils mobiles/web pour les notifications et la segmentation.

Partie 3. Utilisation des extensions Pushwoosh

Pushwoosh inclut des extensions Shopify pour le ciblage de segments, l’automatisation (Flow) et les notifications spécifiques aux clients.

Extension 1. Envoyer une notification par client

Cas d’utilisation

Envoyer manuellement des messages personnalisés ou tester des notifications à un utilisateur spécifique.

Étapes

1. Ouvrez Clients → Sélectionnez un client
2. Cliquez sur Plus d’actions → Notification par client
3. Sélectionnez la plateforme de messagerie (par ex., E-mail) et un préréglage de contenu.
4. Cliquez sur Envoyer

Conseil

Utilisez ceci pour les rappels post-achat, les remerciements personnels ou les incitations à la réactivation.

Extension 2. Notification par segment

Cas d’utilisation

Cibler des groupes de clients — paniers abandonnés, nouveaux acheteurs, gros dépensiers.

Étapes

1. Allez dans Clients → Segments

2. Choisissez un segment → Cliquez sur Utiliser le segment

3. Sélectionnez Notification par segment
4. Sélectionnez le canal de communication souhaité et le préréglage de message. Cliquez sur Envoyer.

Conseil

Les segments peuvent être créés en fonction de l’historique d’achat, de la localisation, de l’activité ou des tags.

Extension 3. Pushwoosh dans Shopify Flow

Cas d’utilisation

Automatiser la messagerie dans les parcours clients en utilisant des déclencheurs comme les commandes, les tags ou le comportement.

Étapes

1. Créez un nouveau Flow dans Shopify Flow
2. Ajoutez une action → Choisissez Notifications Pushwoosh

3. Configurez le message et les champs dynamiques

Par exemple :

• Envoyer un message après une commande passée

• Rappeler à l’utilisateur lorsque le panier est abandonné

• Envoyer une notification push de réactivation après 30 jours d’inactivité

Partie 4. Activer les notifications push web (facultatif mais recommandé)

Pour prendre en charge les notifications push web basées sur le navigateur sur votre vitrine, procédez comme suit :

1. Allez dans Boutique en ligne → Thèmes → Personnaliser
2. Ouvrez Intégrations d’applications dans le menu de gauche
3. Activez Push Init Embed

Note

Votre boutique peut maintenant inviter les utilisateurs à s’inscrire aux notifications push web directement depuis la vitrine.

Partie 5. Suivre les commandes, les paniers et les étapes de paiement

Une fois que vous avez approuvé les portées read_orders, write_pixels et read_customer_events (voir Prérequis), Pushwoosh commence à recevoir trois types d’événements de commerce de votre boutique. Ils proviennent de différents endroits et s’arrêtent indépendamment les uns des autres — ne les traitez pas comme un seul flux.

Événements de commande et de panier côté serveur

Shopify envoie les événements de commande payée (webhook orders/paid, événement PW_OrderCreated) et de paiement créé (webhook checkouts/create, événement PW_AbandonedCart) directement à Pushwoosh, de serveur à serveur. Les deux sont partagés avec d’autres intégrations e-commerce — Magento utilise les deux mêmes noms d’événements. Comme d’autres événements de webhook entrant (Stripe fonctionne de la même manière), ils apparaissent dans le menu déroulant Événement lorsque vous créez un segment ou configurez un déclencheur de Parcours Client, et vous pouvez mapper l’un ou l’autre comme source pour les événements de conversion pour intégrer les revenus de Shopify dans la segmentation RFM, l’attribution de parcours et les statistiques des blocs Produits que vous envoyez dans les e-mails.

Parce que ceux-ci proviennent du serveur de Shopify, et non du navigateur de l’acheteur, ils continuent d’arriver même pour les acheteurs qui bloquent les traqueurs ou utilisent un bloqueur de publicités.

L'abandon de panier signifie trois choses différentes ici

• Le déclencheur Abandon de panier dans Shopify Flow (voir Automatisation basée sur les événements via Shopify Flow) est une condition native de Shopify, sans rapport avec les événements Pushwoosh.
• Le webhook checkouts/create ci-dessus signifie seulement qu’un paiement a été initié — Shopify n’a pas décidé qu’il est “abandonné”, et aucune commande n’a été confirmée non plus.
• La source Panier du bloc Produits lit le panier du destinataire via le tag PW_AbandonedCartID, indépendamment de ces événements.

Choisissez celui qui correspond à ce que vous construisez réellement, pas le nom qui semble le plus proche.

Événements de navigation sur la vitrine

Les vues de produits (événement PW_ProductViewed) et les actions d’ajout au panier sont collectées par la même intégration de thème que vous avez déjà installée pour les opt-ins aux notifications push web — il n’y a rien de nouveau à ajouter à votre thème, mais l’intégration doit être activée (voir Activer les notifications push web) pour que ces événements arrivent. Si vous avez sauté cette étape, vous ne recevrez ni les opt-ins aux notifications push web, ni les événements de la vitrine.

Les événements de la vitrine nécessitent l'activation de l'intégration du thème

Les vues de produits et les événements d’ajout au panier proviennent du navigateur de l’acheteur. Si un acheteur bloque le script de l’intégration, ou si vous laissez l’intégration du thème désactivée, vous cessez de recevoir ces deux événements — mais les événements de commande payée et de paiement créé continuent d’arriver indépendamment, car ils proviennent du serveur de Shopify. Ne supposez pas qu’une intégration de thème désactivée met également en pause le suivi des commandes.

PW_ProductViewed n'a pas de déduplication

PW_ProductViewed se déclenche à chaque chargement de page produit — y compris les visites répétées dans la même session, les rechargements de page et le trafic des robots ou des crawlers. Il n’y a pas de déduplication ou de limitation. Comme les stratégies telles que Basé sur ce qu’ils ont vu se construisent à partir de cet événement, le trafic bruyant alimente également ces recommandations.

Événements des étapes de paiement

Un Web Pixel de Shopify signale deux étapes clés du paiement au fur et à mesure que l’acheteur remplit le formulaire de paiement :

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

L'achat finalisé ne fait pas partie de ce pixel

Le Web Pixel ne suit intentionnellement pas l’achat finalisé — c’est l’événement de commande payée côté serveur mentionné ci-dessus. Utilisez les événements du Web Pixel pour voir où les acheteurs abandonnent pendant le processus de paiement, et l’événement de commande pour savoir qu’une vente a réellement eu lieu.

Partie 6. Conformité des données

Shopify exige que chaque application publique réponde à ses webhooks obligatoires RGPD/CCPA. Pushwoosh les gère comme suit :

• customers/redact : Lorsqu’un acheteur demande à la boutique d’effacer ses données, Pushwoosh efface les enregistrements Pushwoosh correspondants par les identifiants que Shopify envoie — e-mail, téléphone et ID client Shopify.
• customers/data_request : Lorsqu’un acheteur demande une copie de ses données, Pushwoosh publie une notification sur le canal interne du support, et une personne traite la demande manuellement. Shopify exige que les applications répondent à ces demandes dans les 30 jours.
• shop/redact : Shopify envoie ceci 48 heures après qu’une boutique a désinstallé l’application, demandant d’effacer les données de la boutique. Pushwoosh n’a pas de gestionnaire séparé pour cela par conception — la désinstallation supprime déjà l’intégralité de l’enregistrement d’intégration de la boutique (y compris la clé API de l’appareil, le code d’application et les ID de facturation), il ne reste donc plus rien à effacer pour ce webhook au moment où il arrive.

Résumé des cas d’utilisation

Scénario	Outil utilisé
Suivi personnalisé	Notification par client
Rappel de panier abandonné	Shopify Flow + action Pushwoosh
Promotion basée sur un segment	Notification par segment
Message de bienvenue après l’inscription	Flow + Suivi des méta-champs
Opt-in aux notifications push	Intégration de thème + Activation de Push Init
Attribution des revenus et segmentation RFM	Événements de commande/paiement mappés aux événements de conversion
Analyse de l’abandon de paiement	Événements PW_CheckoutContactInfo / PW_PaymentInfoSubmitted
Segments d’abandon de navigation ou de panier	Événements de vue de produit / d’ajout au panier de la vitrine