# 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 explique comment installer et configurer l'application Pushwoosh dans votre boutique Shopify, comment configurer l'identification des utilisateurs et comment utiliser les notifications et les 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](https://www.pushwoosh.com/)
* Accès à votre panneau d'administration Shopify
* Le [Jeton d'accès à l'API de l'appareil](/fr/developer/api-reference/api-access-token/#device-api-token) Pushwoosh et le **Code d'application**
* Une boutique Shopify avec des données clients et commandes disponibles
### Entités synchronisées
* **Clients** : Utilisés pour attribuer et identifier les UserIDs Pushwoosh via les méta-champs Shopify
* **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 pour les notifications push web via des scripts intégrés
### Glossaire (correspondance des noms d'entités s'ils sont différents)
| **Shopify** | **Pushwoosh** |
| -------------------------- | --------------------------------------------------------- |
| Client | UserID |
## 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
* Panier abandonné
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 inviter les visiteurs de votre site web à s'inscrire aux notifications push basées sur le navigateur, sans qu'aucune application mobile ne soit requise.
#### Aperçu du flux de données
```
Données client et événementielles de Shopify
↓
API Pushwoosh (via l'application)
↓
UserID → Segmentation → Notifications déclenchées ou manuelles
```
Cette intégration vous permet de délivrer des messages opportuns et pertinents 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'[Admin Shopify](https://admin.shopify.com/)
2. Sélectionnez votre boutique depuis le tableau de bord
### Installer l'application Pushwoosh
1. Visitez la [page de l'App Store de Pushwoosh](https://apps.shopify.com/pushwoosh-notifications)
2. Cliquez sur **Installer**
3. Confirmez l'installation dans la boîte de dialogue 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. Entrez le **Code d'application** et le [Jeton d'accès à l'API de l'appareil](/fr/developer/api-reference/api-access-token/#device-api-token), 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."
### 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.
## Partie 2. Configuration : User ID 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 **User ID** unique par client. Shopify stocke cette valeur dans les **méta-champs Client** de Shopify.
1. Allez à **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é |
## 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 des notifications de test à 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](/fr/product/content/push-presets/).
4. Cliquez sur **Envoyer**
### Extension 2. Notification par segment
#### Cas d'utilisation
Cibler des groupes de clients — paniers abandonnés, nouveaux acheteurs, gros dépensiers.
#### Étapes
1. Allez à **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**.
### 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 flux 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 qu'une commande a été 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 à **Boutique en ligne → Thèmes → Personnaliser**
2. Ouvrez **Intégrations d'applications** dans le menu de gauche
3. Activez **Push Init Embed**
## 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 pour les notifications push | Intégration de thème + Activation de Push Init |