Démarrer avec Shopware

Vous apprendrez

Apprenez à intégrer Shopware 6 afin d'introduire dans Klaviyo les données relatives à l'activité du site, aux commandes, au catalogue et aux abonnés.

Avant de commencer

Avant de procéder à l'intégration, assurez-vous que

• Vous vous êtes connecté au compte Klaviyo que vous souhaitez intégrer.

Téléchargez et installez l'extension

Vous pouvez l'installer via l'une des deux méthodes suivantes : via Composer, ou en téléchargeant notre extension depuis Github, puis en la téléchargeant sur Shopware. 

Installation via Composer

Lors de l'installation via Composer, vous devrez spécifier la version de l'extension Klaviyo ; toutes les extensions ne fonctionnent pas pour toutes les versions de Shopware. 

Utilisez-vous une version de Shopware comprise entre 6.4.4.0 et 6.4.20.2 ? Exécutez la commande avec la version d'extension suivante :

composer require Klaviyo/shopware-Klaviyo:1.14.3

Utilisez-vous une version de Shopware comprise entre 6.5.0.0 et 6.5.8.10 ? Exécutez la commande avec la version d'extension suivante :

composer require Klaviyo/shopware-Klaviyo:2.16.3

Utilisez-vous la version 6.6.0.0 ou supérieure de Shopware ? Exécutez la commande avec la version d'extension suivante :

composer require Klaviyo/shopware-Klaviyo:3.3.3

Installation par téléchargement

1. Trouvez l'extension gratuite de Klaviyo sur ces liens et cliquez sur le bouton Télécharger:
   
   • Vous utilisez une version de Shopware comprise entre 6.4.4.0 et 6.4.20.2 ? Téléchargez l'extension Klaviyo version 1.14.3.
   • Vous utilisez une version de Shopware comprise entre 6.5.0.0 et 6.5.8.10 ? Téléchargez l'extension Klaviyo version 2.16.3.
   • Vous utilisez la version 6.6.0.0 ou supérieure de Shopware ? Téléchargez l'extension Klaviyo version 3.2.2.
2. Connectez-vous à votre administrateur Shopware pour le magasin que vous souhaitez intégrer.
3. Cliquez sur Extensions > Mes extensions.
4. Cliquez sur Télécharger l'extension.
   
5. Sélectionnez l'extension Klaviyo dans vos fichiers.
6. Une fois que l'extension apparaît dans votre liste d'extensions, cliquez sur Installer.
   
7. Activez l'extension Klaviyo.
   

Configurer l'extension dans Shopware

1. Dans votre administration Shopware point de vente, naviguez vers Paramètres et cliquez sur l'onglet Extensions .
2. Sélectionnez Klaviyo. Vous serez amené à la page des paramètres de l'extension Klaviyo.
3. Sous Canaux de vente, sélectionnez dans le menu déroulant le canal de vente que vous souhaitez intégrer à Klaviyo. N'intégrez qu'un seul canal de vente avec Klaviyo par boutique Shopware. Vous devez également configurer vos paramètres pour chaque canal de vente individuellement.
4. Sous Paramètres d'interaction, sélectionnez l'outil de consentement cookie que vous souhaitez utiliser avec cette intégration. Notez que les visiteurs qui n'acceptent pas le cookie Klaviyo ne seront pas suivis par Klaviyo et ne pourront pas non plus consulter les formulaires Klaviyo. Les options de l'outil de consentement cookie sont les suivantes :
   • Rien
     Si cette option est sélectionnée, Klaviyo a un accès libre au cookie du point de vente.
   • Shopware par défaut
     Si cette option est sélectionnée, la gestion de cookie sera mise en œuvre via la méthode par défaut de Shopware, à condition qu'elle soit activée. Pour l'activer, accédez à Paramètres > Boutique > Informations de base, trouvez la section Sécurité et confidentialité, puis bouton bascule sur Utiliser la notification de cookie par défaut.
   • CookieBot
     Si cette option est sélectionnée, la gestion de cookie sera mise en œuvre par CookieBot. Si vous souhaitez sélectionner CookieBot, vous devez déjà l'avoir installé sur votre point de vente Shopware.
   • Gestionnaire des consentements
   • Si cette option est sélectionnée, la gestion du consentement sera mise en œuvre via le gestionnaire de consentement. Si vous souhaitez sélectionner Consent Manager, vous devez déjà l'avoir installé sur votre point de vente Shopware.
   • Usercentrics CMP
     Si cette option est sélectionnée, la gestion du consentement sera mise en œuvre via Usercentrics CMP. Si vous souhaitez sélectionner Usercentrics CMP, vous devez déjà l'avoir installé sur votre point de vente Shopware.
5. Si vous n'utilisez pas d'outil de gestion des cookies (qui bloque déjà le chargement du script de Klaviyo) et que vous souhaitez accélérer le temps de chargement des pages, activez le paramètre Initialiser Klaviyo après la première interaction avec la page. Cela permet d'obtenir le comportement suivant :
   • Lorsque le client commence à interagir avec la page, les scripts Klaviyo sont initialisés.
   • Lors des transitions de page suivantes, les scripts seront initialisés immédiatement.
     
6. Pour continuer, obtenez vos clés d'API publiques et privées auprès de Klaviyo. Pour ce faire, ouvrez un nouvel onglet et connectez-vous au compte Klaviyo que vous souhaitez intégrer à Shopware. 
   1. Cliquez sur le nom de votre compte en bas à gauche et sélectionnez Paramètres.
   2. Sélectionnez les clés API.
   3. Cliquez sur Créer une clé d'API privée. Donnez un nom à la clé, sélectionnez Clé d'accès complet et cliquez sur Créer. Sur la page suivante, cliquez sur Copier la clé.
   4. Collez la clé privée de l'API dans le paramètre correspondant dans Shopware.
   5. De retour dans Klaviyo, cliquez sur Terminé. Copiez ensuite votre clé d'API publique à partir de la page.
   6. Collez la clé API publique de Shopware dans la case correspondante.
7. Ensuite, choisissez dans le menu déroulant une liste Klaviyo à laquelle seront ajoutés les profils qui s'inscrivent via un formulaire Shopware.
   
8. Sélectionnez un identifiant à utiliser pour le mappage des champs de variante de stock. Vous devez utiliser l'identifiant qui correspond à celui que vous utilisez dans votre catalogue.
9. Activez tous les indicateurs que vous souhaitez synchroniser entre Shopware et Klaviyo.
   
10. Si vous choisissez d'effectuer le suivi de Back in Stock, vous pouvez personnaliser la couleur du texte et l'arrière-plan du bouton d'ouverture de la fenêtre contextuelle de Back in Stock, du bouton de fermeture de la fenêtre contextuelle et du bouton d'abonnement. Cliquez sur le carré, puis utilisez le sélecteur pour choisir une couleur ou, si vous disposez des codes hexagonaux des couleurs de votre marque, collez-les dans la case correspondante.
    
11. Sous la rubrique Noms des extraits, vous trouverez une référence sur la manière de désigner les différents composants de Back in Stock en HTML. Vous pouvez choisir de les personnaliser dans le code de votre site.
    
12. Mappage des champs personnalisés : Ici, vous verrez les champs personnalisés que vous avez configurés dans Shopware (avec le nom technique en gris). Tout champ attribué à l'objet Client peut être synchronisé avec Klaviyo. Pour synchroniser ces champs personnalisés avec les profils Klaviyo, faites basculer le champ individuel sur Actif. Ensuite, sous Nom du champ, tapez le nom que vous souhaitez donner au champ dans Klaviyo.
    
13. Lorsque vous avez terminé, cliquez sur Enregistrer. 
14. Pour synchroniser les événements historiques, cliquez sur Synchroniser les événements historiques en haut de la page. 
15. Pour synchroniser les abonnés existants, cliquez sur Synchroniser les abonnés en haut de la page. 

Synchronisez le flux de votre catalogue

Pour compléter votre intégration avec Klaviyo, vous devez générer un flux de votre catalogue de produits, puis le synchroniser avec Klaviyo. Pour générer le flux :

1. Connectez-vous à l'administrateur de votre boutique Shopware.
2. Cliquez sur + en regard de Canaux de vente pour ajouter un nouveau canal.
3. À côté de Comparaison de produits, cliquez sur Ajouter un canal de vente.
4. Sous Modèle, choisissez Klaviyo XML.
5. Donnez un nom au canal, par exemple Klaviyo Export.
6. Sous Recouvrement de l'impôt, sélectionnez Calcul ligne par ligne (horizontal).
7. Sous le canal de vente Storefront:
   • Sélectionnez le canal de vente en vitrine auquel ce catalogue est destiné.
   • Sélectionnez le domaine Storefront.
   • Sélectionnez la devise.
   • Sélectionnez la langue.
   • Sélectionnez le groupe de clients.
8. Sous Exportation de produits:
   • Nommez le fichier (par exemple, klaviyo.xml).
   • Sélectionnez l'encodage UTF-8.
   • Sélectionnez le format de fichier XML.
9. Ne désactivez pas l'option Exporter les variantes en tant que produits distincts.
10. Sélectionnez l'intervalle : 1 jour.
11. Ne désactivez pas la fonction Générer via le planificateur. 
12. Sélectionnez votre groupe de produits dynamique.
13. Sous Statut, activez la case à cocher Actif. 
14. Cliquez sur Enregistrer en haut à droite.
15. Faites défiler vers le bas et copiez l'URL d'exportation, que vous utiliserez pour la synchronisation avec Klaviyo.
16. Maintenant que le flux est généré, vous devez le synchroniser avec Klaviyo. Suivez les instructions pour synchroniser un flux de catalogue personnalisé avec Klaviyo.

Données synchronisées à partir de Shopware

Pour tout savoir sur les données synchronisées à partir de Shopware et sur la manière d'y accéder dans Klaviyo, lisez notre référence sur les données Shopware.

Formulaires d'inscription Klaviyo

Vous pouvez ajouter des formulaires d'inscription Klaviyo à votre boutique Shopware afin de collecter des abonnés. Notez que seuls les visiteurs du site qui acceptent les cookies de Klaviyo pourront voir les formulaires d'inscription de Klaviyo. 

Comment contacter l'assistance

L'intégration de Klaviyo Shopware 6 est prise en charge par Klaviyo par l'intermédiaire d'Overdose Digital. Si vous avez des questions sur l'intégration et que vous avez besoin d'aide, vous pouvez contacter le service d'assistance spécifique à l'intégration en remplissant notre formulaire.

Si vous avez besoin d'une assistance générale pour des questions liées à Klaviyo, contactez l'assistance Klaviyo.

Résultats

Vous avez intégré Shopware 6 à Klaviyo pour intégrer les données relatives à l'activité du site, aux commandes, au catalogue et aux abonnés dans Klaviyo. Vous pouvez dès à présent utiliser Klaviyo pour vos besoins en owned marketing.

Ressources complémentaires

• Comment synchroniser un flux de catalogue personnalisé avec Klaviyo ?
• Référence des données de Shopware 6