Configurer Shopify

Présentation de l’intégration

Pushwoosh s’intègre parfaitement à 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’app Pushwoosh dans votre boutique Shopify, la mise en place de l’identification des utilisateurs, et l’utilisation des notifications et outils d’automatisation pour engager les clients via des canaux comme le push, l’e-mail, le 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
• L’accès à votre panneau d’administration Shopify
• Le Jeton API Appareil Pushwoosh et le Application Code
• Une boutique Shopify avec des données clients et de commandes disponibles
• L’approbation du scope d’accès read_orders pour les événements de commande/panier, et de write_pixels plus read_customer_events pour le suivi des étapes du checkout

Déjà connecté ? Vous serez invité à réapprouver l'accès

Si vous avez connecté l’app Pushwoosh avant l’existence du suivi des commandes, paniers et checkout, Shopify vous demandera d’approuver les nouveaux scopes la prochaine fois que vous ouvrirez l’app — c’est la façon habituelle dont Shopify déploie des permissions supplémentaires, pas une erreur. Approuvez-les pour commencer à recevoir les événements de commande, panier et checkout.

Entités synchronisées

• Clients : utilisés pour attribuer et identifier les User ID Pushwoosh via les métachamps Shopify

Note

Approches de synchronisation des clients dans Pushwoosh

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

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

Comment cela fonctionne-t-il ?

Le processus de synchronisation fonctionne comme suit :

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

• Segments clients : utilisés pour le ciblage et la messagerie basés sur des groupes
• Événements et déclencheurs (par exemple, commandes passées, tags appliqués) : utilisés dans Shopify Flow pour automatiser la messagerie sur différents canaux
• Storefront : utilisé pour capturer les inscriptions au web push 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 Pushwoosh lorsque vous connectez l’app, et se déconnecte automatiquement si vous la désinstallez.
• Commandes et paniers : événements serveur à serveur provenant des webhooks Shopify orders/paid, checkouts/create et checkouts/update. Voir Événements et campagnes Shopify.
• Comportement de navigation sur la vitrine : vues de produits et actions d’ajout au panier, collectées par le même embed de thème utilisé pour les inscriptions au web push.
• Étapes du checkout : informations de contact saisies et informations de paiement soumises, collectées via un Shopify Web Pixel.

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

Shopify	Pushwoosh
Customer	User ID
Webhook orders/paid	Événement PW_OrderCreated — partagé avec d’autres intégrations e-commerce (par exemple Magento)
Webhook checkouts/create	Événement PW_AbandonedCart — le même événement partagé, également utilisé par la source Cart du bloc Products
Webhook checkouts/update	Événement PW_AbandonedCartUpdate — se déclenche pendant que l’acheteur continue de modifier le même checkout, écrasant le panier stocké depuis PW_AbandonedCart
Vue de la page produit	Événement PW_ProductViewed
Ajout au panier (sans rechargement de page)	Événement PW_AddToCart
Web Pixel checkout_contact_info_submitted	Événement PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Événement PW_PaymentInfoSubmitted

Comment fonctionne l’intégration

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

Composants clés de l’intégration

1. Identification des clients via les métachamps Chaque client Shopify se voit attribuer un User ID unique, stocké dans un métachamp (custom.pushwoosh_userid). Cet ID permet à Pushwoosh de reconnaître et de contacter les utilisateurs de manière cohérente sur toutes les plateformes.

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

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

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

4. Messagerie manuelle 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 by Customer : pour des suivis personnels ou des tests
   • Notification by Segment : pour des messages basés sur des campagnes

Notifications web push via l’embed de la vitrine

En activant l’embed Pushwoosh dans votre thème Shopify, vous pouvez inviter les visiteurs du site à s’inscrire aux notifications push du navigateur, sans app mobile requise.

Vue d’ensemble du flux de données

Données clients et événements Shopify
         ↓
API Pushwoosh (via l'app)
         ↓
User ID → Segmentation → Notifications déclenchées ou manuelles

Cette intégration vous permet d’envoyer 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

Connectez-vous à Shopify

1. Allez sur Shopify Admin
2. Sélectionnez votre boutique dans le tableau de bord

Note

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

Installez l’app Pushwoosh

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

Connectez votre app Pushwoosh

Après l’installation, vous serez redirigé vers l’app Pushwoosh dans Shopify.

1. Cliquez sur Connect.

2. Saisissez l’Application Code et l’API Key, que vous trouverez dans Pushwoosh Control Panel → Settings → API Access. L’API Key ici est votre Jeton API Appareil.

Une fois connecté, un message de succès apparaîtra : « Pushwoosh app connected. »

Lorsque Shopify demande des permissions (commandes, pixels, événements clients), approuvez-les. Ces scopes sont requis pour le suivi des Événements et campagnes Shopify. Si vous avez connecté l’app plus tôt, voir Déjà connecté ? Vous serez invité à réapprouver l’accès.

Connexion automatique du catalogue de produits

Connecter l’app connecte également automatiquement le flux de la vitrine de votre boutique au Catalogue de produits 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 modifiez la devise de votre boutique par la suite.

Souscrivez à un plan

1. Cliquez sur Upgrade Subscription
2. Un plan unique basé sur l’usage 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 : User ID du client via les métachamps

Pour livrer des notifications à des utilisateurs identifiés sur différents canaux (push, e-mail, SMS, WhatsApp), Pushwoosh utilise un User ID unique par client. Shopify stocke cette valeur dans les métachamps client de Shopify.

1. Allez dans Settings → Metafields and metaobjects → Customers

2. Cliquez sur Add definition et utilisez ces valeurs :

Champ	Valeur
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

Définissez Customer accounts access et Storefront API access comme dans le tableau ci-dessus.

Pourquoi c'est important

Ce métachamp 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 par segment, l’automatisation (Flow) et les notifications spécifiques aux clients.

Extension 1. Send notification by customer

Cas d’usage

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

Étapes

1. Ouvrez Customers → Sélectionnez un client
2. Cliquez sur More actions → Notification by customer
   
3. Sélectionnez la plateforme de messagerie (par exemple, E-mail) et un preset de contenu.
4. Cliquez sur Send

Conseil

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

Extension 2. Notification by segment

Cas d’usage

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

Étapes

1. Allez dans Customers → Segments

2. Choisissez un segment → Cliquez sur Use Segment

3. Sélectionnez Notification by Segment
4. Sélectionnez le canal de communication souhaité et le preset de message. Cliquez sur Send.

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’usage

Automatiser la messagerie dans les parcours clients à l’aide de 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 Pushwoosh send notification

3. Configurez le message et les champs dynamiques

Par exemple :

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

• Rappeler à l’utilisateur en cas d’abandon de panier

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

Partie 4. Activez le web push (et les événements de navigation sur la vitrine)

Optionnel pour le web push seul. Requis si vous avez besoin des événements de vue de produit et d’ajout au panier dans les Événements et campagnes Shopify.

Activez l’embed de thème pour le web push du navigateur sur votre vitrine :

1. Allez dans Online Store → Themes → Customize
   
2. Ouvrez App Embeds dans le menu de gauche
3. Activez Push Init Embed

Note

Maintenant votre boutique peut inviter les utilisateurs à s’inscrire au web push directement depuis la vitrine. Si vous ignorez ce bouton, vous n’obtiendrez pas non plus les événements de navigation sur la vitrine dans Événements et campagnes Shopify. Les événements de commande payée et de checkout arrivent quand même sans cela.

Conformité des données

Shopify exige que chaque app publique réponde à ses webhooks obligatoires RGPD/CCPA. Pushwoosh les traite comme suit :

• customers/redact : lorsqu’un acheteur demande à la boutique d’effacer ses données, Pushwoosh efface les enregistrements Pushwoosh correspondants selon 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 apps répondent à ces demandes dans les 30 jours.
• shop/redact : Shopify envoie ceci 48 heures après qu’une boutique désinstalle l’app, demandant l’effacement des données de la boutique. Pushwoosh relance la même suppression que celle déclenchée par la désinstallation elle-même, nettoyant toute session restante et effaçant l’enregistrement d’intégration de la boutique (y compris la clé API Appareil, le code d’application et les ID de facturation). Cela existe comme filet de sécurité pour le cas où la désinstallation n’aurait pas tout nettoyé la première fois.

Récapitulatif des cas d’usage

Après la configuration, les façons courantes d’envoyer des messages depuis Shopify :

Scénario	Outil utilisé
Suivi personnalisé	Notification by Customer
Promotion basée sur un segment	Notification by Segment
Message de bienvenue après inscription	Flow + suivi de métachamp
Rappel de panier abandonné	Shopify Flow + action Pushwoosh
Inscription au push	Embed de thème + interrupteur Push Init

Pour les journeys et segments basés sur les événements de commande, panier, checkout et vitrine, voir Événements et campagnes Shopify.