Démarrer avec Shopware

Objectif de cet article

Découvrez comment intégrer Shopware 6 afin d’importer les données d’activité du site, de commande, de catalogue et des abonnés dans Klaviyo.

Avant de commencer

Veuillez noter les éléments suivants :

• Avant d’effectuer l’intégration, assurez-vous d’être connecté au compte Klaviyo que vous souhaitez intégrer.
• L’intégration Shopware 6 est prise en charge par Klaviyo via un tiers. Si vous devez contacter l’assistance, consultez la section ci-dessous pour savoir comment procéder.

Ajoutez le plug-in à votre compte Shopware.

1. Accédez à la page du plug-in Klaviyo dans la boutique en ligne Shopware.
2. Connectez-vous lorsque vous y êtes invité, puis sélectionnez Ajouter au panier.
3. Passez au paiement et finalisez votre commande.
4. Une fois la commande confirmée, cliquez sur l’option pour accéder à votre compte Shopware.
5. Dans votre compte Shopware, accédez à Merchant > Shops.
6. Sélectionnez la boutique pour laquelle vous avez acheté le plug-in.
7. Dans la section Licences, repérez le plug-in Klaviyo et ouvrez la page des détails du plug-in.

Téléchargez et installez l’extension

Vous pouvez installer l’extension via l’une des deux méthodes suivantes : via Composer ou en téléchargeant notre extension. Après avoir sélectionné une méthode d’installation, vous devez utiliser cette même méthode à chaque mise à jour.

Installer via Composer

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

Utilisez-vous une version de Shopware comprise entre 6.4.4.0 et 6.4.XX.XX ? Exécutez la commande avec la version d’extension suivante :

composer require klaviyo/shopware-klaviyo:1.23.0

Utilisez-vous une version de Shopware comprise entre 6.5.0.0 et 6.5.XX.XX ? Exécutez la commande avec la version d’extension suivante :

composer require klaviyo/shopware-klaviyo:2.23.0

Utilisez-vous une version de Shopware comprise entre 6.6.0.0 et 6.6.XX.XX ? Exécutez la commande avec la version d’extension suivante :

composer require klaviyo/shopware-klaviyo:3.7.0

Utilisez-vous Shopware version 6.7.0.0 ou une version ultérieure ? Exécutez la commande avec la version d’extension suivante :

composter require klaviyo/shopware-klaviyo:4.3.0

Installer via le téléchargement

1. Ouvrez la page des détails du plug-in et téléchargez la dernière version disponible (ou toute version requise) :
   
   • Vous utilisez une version de Shopware comprise entre 6.4.4.0 et 6.4.XX.XX ? Téléchargez la version 1.23.0 de l’extension Klaviyo.
   • Vous utilisez une version de Shopware comprise entre 6.5.0.0 et 6.5.XX.XX ? Téléchargez la version 2.23.0 de l’extension Klaviyo.
   • Vous utilisez une version de Shopware comprise entre 6.6.0.0 et 6.6.XX.XX ? Téléchargez la version 3.7.0 de l’extension Klaviyo.
   • Vous utilisez Shopware version 6.7.0.0 ou une version ultérieure ? Téléchargez la version 4.3.0 de l’extension Klaviyo.
2. Connectez-vous à l’interface d’administration Shopware de la boutique que vous souhaitez intégrer.
3. Cliquez sur Extensions > Mes extensions.
4. Cliquez sur Téléverser une extension et sélectionnez le fichier ZIP que vous avez téléchargé depuis votre compte Shopware. Il est possible que vous voyiez un message d’avertissement pendant le téléversement. Cliquez sur Confirmer pour continuer.
   

5. Une fois l’extension affichée dans votre liste d’extensions, cliquez sur Installer.
   

6. Activez l’extension Klaviyo.
   

Configurer l’extension dans Shopware

1. Dans l’administration de votre boutique Shopware, accédez à Paramètres et cliquez sur l’onglet Extensions .
2. Sélectionnez Klaviyo. Vous accéderez à la page des paramètres de l’extension Klaviyo.
3. Sous Canaux de vente, sélectionnez le canal de vente que vous souhaitez intégrer à Klaviyo dans la liste déroulante. N’intégrez qu’un seul canal de vente à 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 aux cookies que vous souhaitez utiliser avec cette intégration. Notez que les visiteurs qui n’acceptent pas les cookies Klaviyo ne seront pas suivis par Klaviyo et ne pourront pas afficher les formulaires Klaviyo. Les options de l’outil de consentement aux cookies sont les suivantes :
   • Rien
     Si cette option est sélectionnée, Klaviyo a un accès libre aux cookies de la boutique.
   • Shopware par défaut
     Si cette option est sélectionnée, la gestion des cookies 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, recherchez la section Sécurité et confidentialité, puis activez Utiliser la notification de cookies par défaut.
   • CookieBot
     Si cette option est sélectionnée, la gestion des cookies sera mise en œuvre par CookieBot. Si vous souhaitez sélectionner CookieBot, vous devez déjà l’avoir installé sur votre boutique Shopware.
   • Gestionnaire du consentement
   • Si cette option est sélectionnée, la gestion du consentement sera mise en œuvre via Consent Manager. Si vous souhaitez sélectionner Consent Manager, vous devez l’avoir déjà installé sur votre boutique 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 boutique Shopware.
5. Si vous n’utilisez pas d’outil de gestion des cookies (qui empêche déjà le script Klaviyo de se charger) et que vous souhaitez accélérer les temps de chargement des pages, activez le paramètre Initialize Klaviyo After First Interaction With Page. Cela activera le comportement suivant :
   • Une fois que le client commence à interagir avec la page, les scripts Klaviyo seront 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 depuis 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 Clés d’API.
   3. Cliquez sur Créer une clé d’API privée. Nommez la clé « Intégration Shopware », puis 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é d’API privée dans le paramètre correspondant dans Shopware.
   5. De retour dans Klaviyo, cliquez sur Terminé. Ensuite, copiez votre clé d’API publique depuis la page.
   6. Collez la clé d’API publique dans Shopware dans le champ correspondant.
7. Ensuite, sélectionnez une liste Klaviyo dans la liste déroulante à laquelle ajouter les profils qui s’abonnent via un formulaire Shopware.
   

1. Sélectionnez un identifiant à utiliser pour le mappage du champ de variante pour le retour en stock. Vous devez utiliser l’identifiant qui correspond à celui que vous utilisez dans votre catalogue.
2. Activez tous les indicateurs que vous souhaitez synchroniser de Shopware vers Klaviyo.
   

3. Si vous choisissez de suivre le retour en stock, vous pouvez personnaliser la couleur du texte et l’arrière-plan du bouton d’ouverture de la fenêtre contextuelle de retour en 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 de couleur hexadécimaux des couleurs de votre marque, collez-les dans le champ correspondant.
   

4. Sous Snippet names, vous trouverez une référence indiquant comment faire référence à différents composants de retour en stock en HTML. Vous pouvez choisir de les personnaliser dans le code de votre site.
   

5. 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 associé à l’objet Customer peut être synchronisé avec Klaviyo. Pour synchroniser ces champs personnalisés avec les profils Klaviyo, basculez chaque champ sur Actif. Ensuite, sous Nom du champ, saisissez le nom correspondant que vous souhaitez donner au champ dans Klaviyo.
   

6. Lorsque vous avez terminé, cliquez sur Enregistrer.
7. Pour lancer une synchronisation des événements historiques, cliquez sur Synchroniser les événements historiques en haut de la page.
8. Pour exécuter une synchronisation des abonnés existants, cliquez sur Synchroniser les abonnés en haut de la page.

Synchroniser le flux de votre catalogue

Pour finaliser vos intégrations 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’interface d’administration de votre boutique Shopware.
2. Cliquez sur + à côté de Canaux de vente pour ajouter un nouveau canal.
3. À côté de Product comparison, 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 Tax collection, sélectionnez Calcul ligne par ligne (horizontal).
7. Sous Canal de vente de la vitrine:
   • Sélectionnez le canal de vente Storefront auquel ce catalogue est destiné.
   • Sélectionnez le domaine Storefront.
   • Sélectionnez la devise.
   • Sélectionnez la langue.
   • Sélectionner le groupe de clients.
8. Sous Exportation de produits:
   • Donnez un nom au fichier (par exemple, klaviyo.xml).
   • Sélectionnez l’encodage UTF-8.
   • Sélectionnez le format de fichier XML.
9. Laissez Exporter des variantes comme des produits distincts désactivé.
10. Sélectionnez l’intervalle : 1 jour.
11. Laissez l’option Générer via le planificateur désactivée.
12. Sélectionnez votre groupe de produits dynamique.
13. Sous Statut, activez Actif.
14. Cliquez sur Save (Enregistrer) en haut à droite.
15. Faites défiler vers le bas et copiez l’ URL d’exportation, que vous utiliserez pour la synchronisation 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 depuis Shopware

Pour tout savoir sur les données synchronisées depuis Shopware et sur la façon d’y accéder dans Klaviyo, consultez notre référence des 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 Klaviyo pourront voir les formulaires d’inscription Klaviyo.

Comment contacter l’assistance

L’intégration Klaviyo pour Shopware 6 est prise en charge par Klaviyo via un tiers. Si vous avez des questions sur l’intégration et avez besoin d’assistance, vous pouvez contacter l’assistance dédiée à 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ésultat

Vous avez intégré Shopware 6 à Klaviyo afin d’importer dans Klaviyo les données d’activité du site, de commande, de catalogue et d’abonné. Vous pouvez maintenant commencer à utiliser Klaviyo pour vos propres besoins marketing.

Ressources supplémentaires