Comment s’intégrer à Volusion

Objectif de cet article

Découvrez comment intégrer Volusion à 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.

Depuis Volusion, Klaviyo suit les indicateurs Ordered Product et Placed Order. Grâce au code supplémentaire de cet article, vous pouvez également suivre les événements Started Checkout afin de déclencher des rappels de panier abandonné.

Avant de commencer

Volusion exige une mise à jour du mot de passe du compte administrateur de votre boutique Volusion tous les 90 jours. Lorsque vous modifiez ce mot de passe dans Volusion, votre intégrations Klaviyo a également besoin de la clé d’API/du mot de passe chiffré mis à jour. Si vous avez besoin d’aide pour remplacer les identifiants de l’intégrations, contactez l’assistance Klaviyo en utilisant le lien dans la section de résolution des problèmes. Vous pouvez également créer une clé d’API permanente en suivant les étapes de la section correspondante de cet article.

Avant de commencer la configuration, munissez-vous de l’URL de votre boutique Volusion, de votre e-mail de connexion administrateur, et de votre clé d’API/mot de passe chiffré. Si vous avez besoin d’une clé d’API, suivez d’abord Comment créer une clé d’API permanente dans Volusion ci-dessous. Vous avez également besoin de l’autorisation de gérer les intégrations dans Klaviyo.

Ajouter l’intégration Volusion dans Klaviyo

1. Dans Klaviyo, sélectionnez l’onglet Intégrations.
2. Sélectionnez Découvrir les applications.
3. Recherchez Volusion et cliquez sur la carte, puis sur Installer.
4. Sur la page suivante, saisissez l’ URL de votre boutique, l’e-mail de connexion et la clé d’API / le mot de passe chiffré. Ensuite, cliquez sur Connecter à Volusion.

5. Sur la page suivante, sélectionnez Ajouter de nouveaux clients Volusion à une liste Klaviyo si vous souhaitez que les clients marqués comme abonnés aux e-mails dans Volusion soient ajoutés à une liste Klaviyo lorsque leurs commandes se synchronisent. Ensuite, choisissez la liste sous Sélectionner une liste.
6. Enfin, cliquez sur Terminer la configuration.

Désactiver le tracking des e-mails vers le site web dans Klaviyo

Le tracking e-mail vers site web identifie les visiteurs qui arrivent sur votre site web via un lien dans un e-mail Klaviyo Email.

Volusion ne prend pas en charge le format d’URL utilisé par notre tracking des clics et génère une erreur lorsqu’un utilisateur essaie de visiter votre boutique via l’un de ces liens. Vous devrez donc désactiver cette fonctionnalité dans Klaviyo afin de vous assurer que les liens dans votre e-mail redirigent correctement vers votre boutique Volusion.

1. Cliquez sur le nom de votre compte, puis sélectionnez Paramètres > E-mail > Tracking.
2. Désélectionnez Activer le tracking de l’activité depuis l’e-mail vers le site web, puis cliquez sur Enregistrer.

La désactivation de ce paramètre empêche les liens d’e-mail d’identifier les visiteurs sur votre site web. Le tracking sur site peut toutefois associer l’activité à des visiteurs identifiés dans leur navigateur, par exemple via un formulaire d’inscription Klaviyo ou l’extrait de code de paiement ci-dessous. La synchronisation d’une commande Volusion seule n’identifie pas le navigateur du visiteur.

Ajouter le tracking sur site à votre boutique Volusion

Klaviyo fournit 2 extraits de tracking sur site pour vous aider à recueillir des informations précieuses sur vos clients :

• Active on Site
  Cet extrait de code suit le moment où vos clients visitent votre site. Cet extrait de code doit être ajouté au site pour que d’autres extraits de code, tels que Viewed Product, fonctionnent.
• Produit consulté
  Cet extrait suit le moment où vos clients consultent des produits spécifiques. Vous pouvez suivre cet événement en ajoutant l’extrait de code Produit consulté à votre boutique.

Ajouter le tracking d’activité sur le site

Ajoutez l’extrait de code Klaviyo.js suivant afin qu’il apparaisse sur chaque page de votre site web. Cela activera le tracking Active on Site et les formulaires Klaviyo. Assurez-vous de 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 to initialize Klaviyo object on page load
!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 tracking des produits consultés

Pour activer le tracking Produit consulté, vous devrez ajouter l’extrait de code ci-dessous à la page de modèle de votre boutique dans l’éditeur de fichiers de Volusion, que vous pouvez trouver en cliquant sur Design > Éditeur de fichiers.

<script type="text/javascript">
// Check to see if the customer is on the product page before executing code.
    if ($("meta[property='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a product is viewed
        var trackViewedProduct = function(item) {
            klaviyo.track("Viewed Product", item);
            klaviyo.trackViewedItem({
                "Title": item.ProductName,
                "ItemId": item.ProductID,
                "ImageUrl": item.ImageURL,
                "Url": item.URL,
                "Metadata": {
                    "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 ?
                Number(`${$("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 ?
                Number(`${$("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 ?
                Number(`${$("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 ?
                Number(`${$("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 de panier abandonné

Volusion ne propose pas de méthode prête à l’emploi pour suivre les paniers abandonnés via nos intégrations, mais nous avons créé un script personnalisé que vous pouvez ajouter à votre boutique Volusion, ce qui vous permettra d’utiliser cette fonctionnalité dans Klaviyo. Cela nécessitera certaines connaissances en matière d’ajout de code au modèle de votre boutique. Si vous avez un développeur, vous pouvez lui envoyer ce document pour l’accompagner dans l’ajout du code.

1. Après avoir ajouté l’extrait de code Klaviyo.js ci-dessus, ajoutez l’extrait de code de paiement ci-dessous à la page de modèle de votre boutique dans l’éditeur de fichiers de Volusion, sous Design > File Editor, puis enregistrez vos modifications.

<script type="text/javascript">
    // Check to see if the customer is on the checkout page before executing code.
    if (window.location.pathname == "/one-page-checkout.asp") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a checkout is started.
        var trackStartedCheckout = function() {
            $.post('/AjaxCart.asp', function(data) {
                if (!data || !data.Products || !data.Products.length) {
                    return;
                }
                var items = [],
                    names = [],
                    skus = [];
                // Grab each product and its SKU/Name/Quantity/Price/Total price/Image url
                $.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);
                });
                // Push Started Checkout metric to Klaviyo with the customers data.
                klaviyo.track("Started Checkout", {
                    $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                    Items: items,
                    ProductNames: names,
                    SKUs: skus
                });
            }, 'json');
        };
        $(function() {
            // Grab the email form to get your customers email and tie the event to that email in Klaviyo.
            $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                var email = $(this).val();
                // Do some light validation. Klaviyo will do more validation when the data is received.
                if (email && /@/.test(email)) {
                    klaviyo.identify({
                        $email: email
                    });
                    trackStartedCheckout();
                }
            });
        });
} </script>

Ce code pourra uniquement suivre les événements de paiement à l’avenir ; vous ne pourrez pas alimenter rétroactivement les flux de panier abandonné dans Klaviyo.

1. Testez votre paiement sur une seule page avec un produit dans le panier. Saisissez une adresse e-mail valide, puis quittez le champ e-mail. Ouvrez Analyse > Indicateurs dans Klaviyo, puis recherchez Démarrage du paiement. Cet événement est déclenché par la modification du champ e-mail, et vous pouvez l’utiliser pour déclencher un flux de panier abandonné.

Suivre la synchronisation Klaviyo

1. Une fois intégré à Volusion, Klaviyo aura besoin de temps pour synchroniser vos données avant qu’elles ne soient prêtes à être utilisées. Pour vérifier la synchronisation, ouvrez Intégrations, sélectionnez Volusion, puis ouvrez l’onglet Données.
2. Sous données historiques, vérifiez progression de la synchronisation. Plus votre boutique est grande, plus une synchronisation peut prendre du temps. Une fois l’importation terminée, cette section confirme que vos commandes historiques et vos clients ont été synchronisés.
3. Klaviyo importe les commandes historiques et les données client associées lorsque vous activez les intégrations pour la première fois. Une fois la synchronisation terminée, comparez le nombre de commandes d’un jour donné avec l’interface Volusion. Par exemple, lorsque vous explorez l’indicateur Placed Order (sous Analytics > Indicateurs dans Klaviyo), vous pouvez survoler le point de données d’hier avec la souris ou consulter le tableau de données sous le graphique pour voir combien de commandes ont été signalées hier.
4. Comparez ce chiffre avec les commandes Volusion pour la même journée. Si les totaux diffèrent, vérifiez que la synchronisation est terminée, et que les fuseaux horaires correspondent. Klaviyo ignore également les commandes sans montant de paiement, ou sans adresse e-mail de client valide ; une différence n’indique donc pas toujours un problème de fuseau horaire.
5. Pour vérifier ou mettre à jour le fuseau horaire de votre compte :
   1. Cliquez sur le nom de votre compte dans la partie inférieure gauche.
   2. Sélectionnez Paramètres > Général > Compte.
   3. Faites défiler jusqu’à Fuseau horaire. Si vous modifiez la sélection, cliquez sur Enregistrer.

Données synchronisées depuis Volusion

Accédez à Analytics > Indicateurs pour trouver tous les indicateurs de votre compte. Les indicateurs avec une icône Volusion sont synchronisés à partir de votre intégration Volusion. Après la synchronisation initiale, Klaviyo vérifie toutes les heures les nouvelles commandes et les propriétés client associées.

Commande passée

Cet événement est suivi lorsque Klaviyo synchronise une commande depuis votre boutique Volusion avec un montant de paiement et une adresse e-mail client valide. L’événement utilise la date et l’heure d’origine de la commande. 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 suivi pour chaque unité achetée dans une commande. Par exemple, si quelqu’un achète un t-shirt et un pantalon, 1 événement Placed Order est suivi et 2 événements Ordered Product : 1 pour le t-shirt et 1 pour le pantalon. S’il achète 2 fois le même t-shirt, Klaviyo enregistre également 2 événements Ordered Product.

L’événement Ordered Product inclut des informations détaillées sur chaque produit acheté. C’est utile lors de la création de segments comportementaux basés sur les produits achetés par une personne. Vous pouvez filtrer et cibler les événements Ordered Product 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é
  Cette valeur est de 1 pour chaque événement Ordered Product, car Klaviyo enregistre un événement distinct pour chaque unité achetée.

Données clients synchronisées depuis Volusion

En plus des indicateurs ci-dessus que Klaviyo synchronise à partir de Volusion, des propriétés client sont également ajoutées à chaque profil Klaviyo. Vous pouvez utiliser ces propriétés dans les segments et les flux. Voici les propriétés synchronisées automatiquement depuis Volusion :

• E-mail
• Prénom
• Nom de famille
• City
• État/Département
• Zip Code
• Pays
• Phone Number
• Source (Klaviyo suivra les clients de Volusion avec une propriété Source sur leur profil définie sur "Volusion")

Résolution de problèmes

Les données Placed Order de Volusion ne remontent pas dans Klaviyo

Cela peut être un problème avec les paramètres de votre API Volusion qui permettent d’exporter des données.

1. Pour corriger cela, accédez à l’onglet Inventory 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 d’ exécuter l’exportation des Générique/Commandes de votre boutique. Une fois l’exportation exécutée, la page s’actualise.
   

4. Sélectionnez toutes les colonnes en cliquant sur la case à cocher de la colonne nommée *, puis cliquez sur Exécuter.
   

5. Après avoir cliqué sur Exécuter pour exporter vos commandes génériques, une URL d’API est générée en haut de la page. Par exemple, l’URL s’afficherait comme suit : https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=Generic%5COrders.
   

6. La valeur après EncryptedPassword= et avant le & suivant correspond à votre clé d’API (mise en évidence dans la capture d’écran ci-dessus). Si votre intégration Klaviyo nécessite des identifiants mis à jour, utilisez le lien Assistance à l’étape suivante pour obtenir de l’aide afin de les remplacer.
7. Une fois les paramètres d’exportation et les identifiants corrigés, laissez s’exécuter la prochaine synchronisation horaire, puis ouvrez Analytics > Indicateurs. Consultez l’activité récente de l’indicateur Volusion Placed Order pour voir si de nouvelles données se sont synchronisées. Si des commandes manquent toujours ou si de nouvelles commandes n’apparaissent pas, contactez notre équipe d’assistance pour obtenir de l’aide afin de rétablir la synchronisation et de combler les lacunes dans votre historique de commandes.
8. Pour en savoir plus sur l’exportation de données à l’aide de l’API Volusion, veuillez consulter l’assistance Volusion.

Les utilisateurs voient une erreur « Saisie non valide » lorsqu’ils cliquent sur mes liens d’e-mail

Le tracking e-mail vers site web identifie les visiteurs qui arrivent sur votre site web via un lien dans un e-mail Klaviyo Email.

Volusion ne prend pas en charge le format d’URL utilisé par notre tracking des clics et génère une erreur lorsqu’un utilisateur essaie de visiter votre boutique via l’un de ces liens. Vous devrez donc désactiver cette fonctionnalité dans Klaviyo afin de vous assurer que les liens dans votre e-mail redirigent correctement vers votre boutique Volusion.

Pour résoudre ce problème, désactivez le tracking des e-mails vers le site web sous Paramètres > E-mail > Tracking, comme décrit au début de cet article.

Comment créer une clé d’API permanente dans Volusion

Normalement, Volusion vous demandera de réinitialiser votre clé d’API tous les 90 jours lorsque vous réinitialisez le mot de passe de votre compte, ce qui vous obligera à reconfigurer vos intégrations Volusion dans Klaviyo. Les étapes suivantes vous permettront de créer une clé d’API sans expiration à la place ; cela implique de générer des identifiants API pour un compte administrateur auquel vous ne vous connectez jamais :

1. Dans votre panneau d’administration Volusion, accédez à Customers > Administrators et créez un nouveau compte administrateur.
2. Accédez à Inventaire > Importer/Exporter et sélectionnez l’onglet API Volusion.
3. Dans la section Generic, 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 le menu déroulant.
5. Développez la zone "URL avec chaîne de requête..." pour trouver votre URL permanente, votre identifiant de connexion et votre mot de passe chiffré (clé d’API).

Ne vous connectez pas avec ce compte, il ne sera utilisé que pour l’accès à l’API. En vous connectant à ce compte, le mot de passe expirera au bout de 90 jours. Vous devrez refaire ces étapes pour générer une nouvelle Clé d'API permanente.

Résultat

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

Ressources supplémentaires