Comment s'intégrer à Volusion

Vous apprendrez

Apprenez à intégrer Volusion avec Klaviyo. Une fois ces étapes franchies, vous serez en mesure de personnaliser et de cibler les e-mails en fonction des données de commande synchronisées et des propriétés des clients.

A partir de Volusion, Klaviyo suit les indicateurs de produits commandés et de commandes passées; avec l'ajout d'un code supplémentaire, nous pouvons également suivre les informations sur les paniers abandonnés.

Avant de commencer

Volusion demande une mise à jour du mot de passe du compte administrateur de votre boutique Volusion tous les 90 jours. Lorsque vous faites cette mise à jour dans votre compte Volusion, vous devez également faire cette mise à jour de votre intégration Volusion dans votre compte Klaviyo. Vous pouvez également créer une clé API permanente en suivant les étapes de la section correspondante de cet article.

Ajouter l'intégration de Volusion dans Klaviyo

1. Dans Klaviyo, sélectionnez l’onglet Intégrations.
2. Sélectionnez Ajouter des intégrations.
3. Recherchez Volusion et cliquez sur la carte, puis sur Installer.
4. Sur la page suivante, saisissez l'URL de votre magasin, votre adresse électronique de connexion et votre clé API/mot de passe crypté. Ensuite, cliquez sur Connecter à Volusion.
   
5. Sur la page suivante, vous verrez une case à cocher pour Ajouter de nouveaux clients Volusion à une liste Klaviyo. Si vous cochez cette case, vous pouvez choisir une de vos listes dans Klaviyo à laquelle les futurs clients seront ajoutés lorsqu'ils passeront une commande.
6. Enfin, cliquez sur Terminer la configuration.

Désactiver le suivi de l'email vers le web dans Klaviyo

1. La fonction "email to web tracking" de Klaviyo utilise le suivi des clics pour identifier un utilisateur qui arrive sur votre site web par le biais d'un email Klaviyo avant que nous puissions l'identifier (par exemple lorsqu'il effectue un achat ou s'inscrit à votre liste d'emails).
2. Volusion ne prend pas en charge le format d'URL que notre suivi des clics utilise et produit une erreur lorsqu'un utilisateur tente de visiter votre boutique par le biais de l'un de ces liens. Cette fonction devra donc être désactivée dans Klaviyo afin de s'assurer que les liens dans votre courrier électronique mènent correctement à votre boutique Volusion.
3. Vous pouvez désactiver ce suivi dans les paramètres de votre compte sous Nom du compte > Paramètres > Email > Attribution.
4. La seule fonctionnalité perdue en désactivant cette fonction est la possibilité de suivre un nouveau profil sur votre site web par le biais d'un e-mail sur lequel il a cliqué. Tant que vous disposez de l'outil d'analyse Klaviyo onsite tracking sur votre site web (que nous ajouterons dans la section suivante), nous serons toujours en mesure de suivre les utilisateurs dès que nous recevons leur adresse e-mail, soit par le biais d'un achat dans votre magasin, soit lorsqu'ils s'inscrivent à une liste d'e-mails.

Ajouter un suivi sur site à votre boutique Volusion

Klaviyo propose deux snippets de suivi sur site pour vous aider à collecter des informations précieuses sur vos clients :

• Active on Site
  Cet extrait permet de savoir quand vos clients visitent votre site. Cet extrait doit être ajouté au site pour que d'autres extraits tels que Viewed Product fonctionnent.
• Produits consultés
  Cet extrait permet de savoir quand vos clients consultent des produits spécifiques. Vous pouvez suivre cet événement en ajoutant l'extrait de code Viewed Product à votre boutique.

Ajouter le suivi des personnes actives sur le site

Ajoutez l'extrait Klaviyo.js suivant pour qu'il apparaisse sur chaque page de votre site web. Cela permettra d'activer le suivi actif sur le site et les formulaires Klaviyo. Veillez à remplacer PUBLIC_API_KEY par votre clé d'API publique Klaviyo.

<script type="application/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> //Script pour initialiser l'objet Klaviyo au chargement de la page !function(){if(!window.Klaviyo){window._klOnsite=window._klOnsite||[];try{window.Klaviyo=new Proxy({},{get:function(n,i){return"Push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.Push([i].concat(o,[function(i){t&&t(i),n(i)}]))});return e}}})}catch(n){window.Klaviyo=window.Klaviyo[],window.Klaviyo.Push=function(){var n ;(n=window._klOnsite).Push.apply(n,arguments)}}}}() ; </script>

Ajouter le suivi des produits consultés

Pour activer le suivi des produits visualisés, vous devrez ajouter l'extrait de code ci-dessous à la page modèle de votre magasin dans l'éditeur de fichiers de Volusion, que vous pouvez trouver en cliquant sur Conception > Éditeur de fichiers.

<script type="text/javascript">
// Vérifiez si le client se trouve sur la page du produit avant d'exécuter le code.
    if ($("meta[property='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [] ;
        // Fonction permettant de savoir quand un produit est consulté
        var trackViewedProduct = function(item) {
            klaviyo.track("Vu Produit", article) ;
            klaviyo.trackViewedItem({
                "Titre": item.ProductName,
               "ItemId": item.ProductID,
               "ImageUrl": item.ImageURL,
               "Url": item.URL,
               "Métadonnées": {
                    "Price": item.Price,
                    "Description": item.Description,
                    "CompareAtPrice": item.CompareAtPrice,
                    "YouSave": item.YouSave
                }
            }) ;
        } ;
        var item = {}
        $.get(`/ProductDetails.asp?ProductCode=${global_Current_ProductCode}`, function(data) {
            var product_saleprice = $("table.colors_pricebox div.product_saleprice").length ?
                Nombre(`${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null ;
            var product_listprice = $("table.colors_pricebox div.product_listprice").length ?
                Nombre(`${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null ;
            var product_productprice = $("table.colors_pricebox div.product_productprice").length ?
                Nombre(`${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null ;
            var product_yousave = $("table.colors_pricebox div.product_yousave").length ?
                Nombre(`${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : 0 ;
            item = {
                "ProductName": $("meta[property='og:title']").attr("content"),
                "ProductID": global_Current_ProductCode,
                "Description": $("meta[property='og:description']").attr("content"),
                "ImageURL": $("meta[property='og:image']").attr("content"),
                "URL": $("meta[property='og:url']").attr("content"),
                "Price": product_saleprice ? product_saleprice : product_productprice,
                "CompareAtPrice": product_listprice ? product_listprice : product_productprice,
                "YouSave": product_yousave
            };
            trackViewedProduct(item) ;
        }) ;
    } 
</script>

Ajouter des rappels pour les paniers abandonnés

Volusion n'offre pas de moyen prêt à l'emploi pour suivre les paniers abandonnés par le biais de notre intégration, mais nous avons créé un script personnalisé que vous pouvez ajouter à votre boutique Volusion et qui vous permettra d'utiliser cette fonction dans Klaviyo. Si vous avez un développeur, vous pouvez lui envoyer ce document pour l'aider à ajouter le code.

1. Vous devrez ajouter l'extrait de code ci-dessous à la page modèle de votre boutique dans l'éditeur de fichiers de Volusion, que vous pouvez trouver en cliquant sur Design > File Editor.

   <script type="text/javascript">
       // Vérifiez si le client se trouve sur la page de paiement avant d'exécuter le code.
       if (window.location.pathname == "/one-page-checkout.asp") {
           var klaviyo = window.klaviyo || [] ;
           // Fonction permettant de savoir quand une commande est lancée.
           var trackStartedCheckout = function() {
               $.post('/AjaxCart.asp', function(data) {
                   if (!data || !data.Products || !data.Products.length) {
                       return;
                   }
                   var items = [],
                       names = [],
                       skus = [] ;
                   // Récupérez chaque produit et son url SKU/Name/Quantity/Price/Total price/Image
                   $.each(data.Products, function(i, record) {
                       var item_price = +(record.ProductPrice.replace(/[\$,]+/g, '')) / record.Quantity ;
                       items.push({
                           SKU: record.ProductCode,
                           Name: record.ProductName,
                           Quantity: +record.Quantity,
                           ItemPrice: item_price,
                           RowTotal: item_price * record.Quantity,
                           ImageURL: record.ImageSource
                       }) ;
                       names.push(record.ProductName) ;
                       skus.push(record.ProductCode) ;
                   }) ;
                   // Poussez la métrique Started Checkout vers Klaviyo avec les données des clients.
                   klaviyo.track("Démarré Checkout", {
                       $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                       Items: items,
                       ProductNames: names,
                       SKUs: skus
                   }) ;
               }, 'json') ;
           } ;
           $(function() {
               // Saisissez le formulaire d'email pour obtenir l'email de vos clients et liez l'événement à cet email dans Klaviyo.
               $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                   var email = $(this).val() ;
                   // Effectuez une légère validation. Klaviyo procédera à une validation plus poussée lorsque les données seront reçues.
                   if (email && /@/.test(email)) {
                       klaviyo.identify({
                           $email: email
                       }) ;
                       trackStartedCheckout() ;
                   }
               }) ;
           }) ;
   } 
   </script>

2. Ce code permettra uniquement de suivre les événements de paiement à l'avenir ; vous ne pourrez pas remplir les flux de panier abandonné dans Klaviyo. 
3. Après avoir enregistré ce code dans votre boutique, Klaviyo commencera automatiquement à suivre un indicateur Started Checkout à partir duquel vous pourrez déclencher un flux de panier abandonné.

Surveillez la synchronisation de Klaviyo

1. Une fois intégré à Volusion, Klaviyo aura besoin de temps pour synchroniser vos données avant d'être prêt à être utilisé. Vous pouvez vérifier l'état de cette synchronisation en naviguant à nouveau vers l'onglet intégrations et en recherchant votre Volusion intégrations sur la liste des intégrations actives.
2. Si le contour est gris, cela signifie que l'intégration est toujours en cours de synchronisation. Plus votre magasin est grand, plus la synchronisation peut prendre du temps. Lorsque votre intégration s'affiche avec un cadre vert, vous êtes prêt à partir.
3. Klaviyo importe toutes les données historiques de Volusion lorsque vous activez l'intégration pour la première fois. Pour le vérifier, vous pouvez comparer le nombre de commandes d'un jour donné avec ce qui figure dans l'interface de Volusion et confirmer qu'ils correspondent. Par exemple, lorsque vous explorez la mesure des commandes passées (sous Analytics > Metrics dans Klaviyo), vous pouvez passer la souris sur le point de données d'hier ou consulter le tableau de données sous le graphique pour voir combien de commandes ont été signalées hier.
4. Comparez ce nombre à celui stocké dans Volusion depuis hier et vous devriez voir qu'ils correspondent exactement. Si ce n'est pas le cas, il est probable que le fuseau horaire de votre compte Klaviyo ne corresponde pas à celui de Volusion.
5. Pour vérifier ou mettre à jour le fuseau horaire de votre compte : 
   • Cliquez sur le nom de votre compte en bas à gauche.
   • Sélectionnez puis cliquez sur Settings > Organization.
   • Faites défiler vers le bas jusqu'à Fuseau horaire.

Données synchronisées depuis Volusion

Naviguez vers Analytics > Metrics pour trouver tous les indicateurs de votre compte. Les indicateurs avec une icône Volusion sont synchronisés à partir de votre intégration Volusion. Les mesures et les propriétés de profil de Volusion sont synchronisées dans l'heure qui suit le passage d'une commande.

Commande passée

Cet événement est suivi lorsqu'un client termine le processus de paiement et crée une commande dans votre boutique Volusion. L'événement Commande passée comprend toutes les informations pertinentes sur les articles achetés par le client, y compris les noms et codes des produits, les images et les informations sur les prix, afin que vous puissiez utiliser ces informations dans les e-mails de suivi des achats.

Produit commandé

Cet événement est également suivi lorsqu'un client passe une commande, mais un événement est suivi pour chaque article de la commande. Par exemple, si quelqu'un achète un t-shirt et un pantalon, un événement " Commande passée" est suivi et deux événements " Produit commandé " - un événement pour le t-shirt et un événement pour le pantalon.

L'événement Produit commandé contient des informations détaillées sur chaque produit acheté. Ceci est utile pour créer des segments comportementaux basés sur des options de variantes de produits et d'autres informations détaillées qui ne sont pas disponibles dans l'événement Commande passée. Vous pouvez filtrer et cibler les événements relatifs aux produits commandés en fonction des critères suivants :

• Nom
  Le nom ou le titre du produit dans Volusion, par exemple, t-shirt.
• Code produit
  Le code produit de votre produit dans Volusion.
• Quantité
  La quantité de l'article acheté dans une commande.

Données clients synchronisées à partir de Volusion

En plus des indicateurs ci-dessus que Klaviyo synchronise avec Volusion, il y a aussi des propriétés des clients qui sont ajoutées à chaque profil Klaviyo. Vous pouvez utiliser ces propriétés dans les segments et les flux. Voici les propriétés qui sont automatiquement synchronisées depuis Volusion :

• Courriel
• Prénom
• Nom de famille
• Ville
• État/Région
• Code postal
• Pays
• Numéro de téléphone
• Source (Klaviyo suivra les clients de Volusion dont la propriété Source de leur profil est définie sur "Volusion")

Dépannage

Les données des commandes passées sur Volusion ne sont pas affichées dans Klaviyo.

Il peut s'agir d'un problème lié aux paramètres de l'API de Volusion qui autorisent l'exportation des données.

1. Pour résoudre ce problème, rendez-vous dans l'onglet Inventaire de votre panneau d'administration Volusion. Sélectionnez Import/Export dans le menu déroulant.
   
2. Cliquez sur Volusion API pour accéder à la page principale de l'API.
3. Dans la section Générique, vous trouverez l'option permettant de lancer l'exportation des génériques/commandes de votre magasin. Une fois l'exportation lancée, la page est rafraîchie.
   
4. Sélectionnez toutes les colonnes en cliquant sur la case à cocher de la colonne nommée * et cliquez sur Exécuter.
   
5. Après avoir cliqué sur Exécuter pour exporter vos commandes génériques, une URL API est générée en haut de la page. Par exemple, l'URL serait la suivante : https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=GenericOrder.
   
6. La valeur qui apparaît entre "EncryptedPassword=" et "& EDI_Name=GenericOrders" (mise en évidence dans la capture d'écran ci-dessus) sert de clé API. Utilisez ceci pour rétablir vos paramètres d'intégration à partir de l'onglet Intégrations de votre tableau de bord Klaviyo. 
7. Une fois l'opération terminée, testez-la en cliquant sur Analytics > Metrics. Consultez l'activité récente de l'indicateur Volusion Placed Order pour voir si de nouvelles données ont été synchronisées dans Klaviyo. Si vous voyez de nouvelles données pour l'indicateur Commande passée, contactez notre équipe d'assistance pour combler les lacunes des commandes manquantes dans Klaviyo ou pour toute autre assistance.
8. Pour plus d'informations sur l'exportation de données à l'aide de l'API de Volusion, veuillez vous référer à l'assistance de Volusion.

Les internautes voient apparaître une erreur "Invalid Input" lorsqu'ils cliquent sur les liens de mon e-mail.

La fonction "email to web tracking" de Klaviyo utilise le suivi des clics pour lier l'activité d'un utilisateur qui arrive sur votre site web par le biais d'un email de Klaviyo avant que nous puissions l'identifier (par exemple lorsqu'il effectue un achat ou s'inscrit à votre liste d'emails).

Volusion ne prend pas en charge le format d'URL que notre suivi des clics utilise et produit une erreur lorsqu'un utilisateur tente de visiter votre boutique par le biais de l'un de ces liens. Cette fonction devra donc être désactivée dans Klaviyo afin de s'assurer que les liens dans votre courrier électronique mènent correctement à votre boutique Volusion.

Pour résoudre ce problème, veillez à désactiver le suivi de l'email vers le web dans Klaviyo comme décrit au début de cet article.

Comment créer une clé API permanente dans Volusion ?

Normalement, Volusion vous demandera de réinitialiser votre clé API tous les 90 jours lorsque vous réinitialiserez le mot de passe de votre compte, ce qui vous obligera à reconfigurer l'intégration de Volusion dans Klaviyo. Les étapes suivantes vous permettront de créer une clé d'API qui n'expire pas ; il s'agissait de générer des identifiants d'API pour un compte d'administrateur auquel vous ne vous connectez jamais :

1. Depuis votre panneau d'administration Volusion, allez sur Clients > Administrateurs et créez un nouveau compte administrateur.
2. Naviguez vers Inventory > Import/Export et sélectionnez l'onglet Volusion API.
3. Dans la section Générique, cliquez sur le lien Aide à l'intégration de l'API Volusion.
4. Sélectionnez Exporter et sélectionnez le nouvel administrateur que vous avez créé dans la liste déroulante.
5. Développez le champ "URL with Query String..." pour trouver votre URL permanente, votre login et votre mot de passe crypté (clé API).

Ne vous connectez pas avec ce compte, il sera utilisé uniquement pour l'accès à l'API. Si vous vous connectez avec ce compte, le mot de passe expirera au bout de 90 jours et vous devrez refaire ces étapes pour générer une nouvelle clé API permanente.

Résultats

Vous avez maintenant intégré Klaviyo à Volusion, ajouté le suivi sur site, examiné vos données synchronisées et appris à créer une clé API permanente.

Ressources complémentaires

• Fréquence de synchronisation de la référence des intégrations
• Vous avez besoin d'aide pour intégrer Klaviyo ? Découvrez les agences partenaires de Klaviyo