Comment intégrer Spree

Vous apprendrez

Découvrez comment intégrer Spree à Klaviyo. Une fois ces étapes franchies, vous serez en mesure de personnaliser et de cibler les e-mails en fonction des achats et de l'activité du site Web de chaque client. Voici les données que nous synchronisons avec Spree :

• Données relatives aux ventes et aux commandes, y compris les produits achetés, les images des produits, les détails des variantes et les éventuelles remises appliquées
• Informations sur les clients, notamment leur nom et prénom, leur lieu de résidence et la manière dont ils ont trouvé votre magasin.
• Données relatives aux commandes exécutées

Ajoutez l'intégration Spree à Klaviyo

1. Pour connecter Spree à votre compte, naviguez sur Klaviyo et cliquez sur votre nom de compte dans le coin inférieur gauche, puis sélectionnez Intégrations.
2. Cliquez sur Ajouter des intégrations, recherchezSpree et cliquez sur la carte. Ensuite, cliquez sur Installer.
3. Sur la page suivante, vous devrez fournir l'URL de votre magasin et une clé API Spree / un mot de passe crypté. Vous pouvez générer cette clé API dans votre administration Spree en naviguant vers Utilisateurs, en choisissant un compte, puis en sélectionnant Générer une clé API.
4. De retour dans Klaviyo, collez l'URL de votre boutique et la clé API/le mot de passe crypté dans les cases.
   
5. Si vous utilisez une version de l'API Spree (v1), cochez la case correspondante.
6. Cliquez sur Connect to Spree. 
7. Si vous souhaitez ajouter à une liste dans Klaviyo les clients qui acceptent de recevoir des e-mails de votre magasin Spree, cochez la case Ajouter de nouveaux clients Spree à une liste Klaviyo sur la page suivante. Après avoir coché cette case, sélectionnez une liste à laquelle les nouveaux opt-ins seront ajoutés.
8. Lorsque vous êtes prêt, cliquez sur Terminer la configuration. Vous devriez alors voir un message de réussite indiquant que l'intégration s'est déroulée avec succès.

Installez Klaviyo onsite tracking

Pour installer le suivi sur site, qui consiste en deux événements - Actif sur le site et Produit vu, commencez par trouver votre clé API publique. Connectez-vous à votre compte Klaviyo et allez sur Nom du compte > Paramètres > Clés API. Votre clé publique comporte six caractères. Copiez cette clé en toute sécurité pour l'utiliser à l'étape suivante. 

Il existe deux types de suivi sur site que vous pouvez exploiter :

• Actif sur le site
  Cette mesure est suivie chaque fois qu'un navigateur identifiable visite votre site web.
• Produit consulté
  Cette mesure est suivie chaque fois qu'un navigateur identifiable consulte une page de produit sur votre site web.

"Actif sur le site" suivi

Cette mesure est suivie chaque fois qu'un navigateur identifiable visite votre site web.

1. Pour commencer à suivre l'activité Active on Site, ajoutez l'extrait de code suivant au modèle de votre magasin principal afin qu'il soit inclus dans toutes les pages. Vous devez placer cet extrait soit avec d'autres scripts d'analyse que vous utilisez, soit juste avant la </body>balise de fermeture</body >.
2. Veillez à remplacer Clé API publique par la clé API publique de votre compte Klaviyo :

   <script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   <script type="text/javascript"> 
   //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>

3. Selon les types de modèles que vous utilisez pour votre site web, les syntaxes {% if user.is_logged_in %} et {{ user.email }} sont probablement différentes. En utilisant le modèle de langue disponible, vous souhaitez vérifier si la personne qui consulte la page en cours est connectée. Si c'est le cas, vous devez indiquer leur adresse électronique et leur nom, s'ils sont disponibles. Si vous n'avez pas d'informations sur le nom, supprimez ces deux lignes et la virgule qui suit la ligne email $email.
4. Ce code de suivi Klaviyo vous permettra de suivre un Actif sur Sitemetricafin que vous puissiez voir et exploiter les données relatives aux visites du site et au comportement des visiteurs. Grâce à cette mesure, Klaviyo suivra l'activité sur le site pour les navigateurs connus.
5. Pour vérifier que votre suivi sur site est correctement configuré, allez sur une page de votre magasin et ajoutez ?utm_email=email@example.com à la fin de l'URL en remplaçant email@example.com par votre adresse électronique. Après avoir rechargé la page, recherchez votre adresse e-mail dans Klaviyo. Vous devriez voir qu'un profil a été créé et qu'il a suivi l'activité de votre site. 

"Produit consulté" tracking

Si vous souhaitez mettre en place un flux d'abandon de la navigation ou créer des segments basés sur les données de navigation des produits, vous devez ajouter le suivi des événements JavaScript pour une mesure Produit consulté.

1. Sur le modèle de votre page produit, ajoutez l'extrait suivant :

   <script type="text/javascript">
    var klaviyo = window.klaviyo || [] ;
    klaviyo.track("Visualisé Produit", {
       Titre : '{{ product.name }}',
       ItemId : {{ product.id }},
       Categories : {{ category in product.categories|json }}, // La liste des catégories est un tableau de chaînes.
       ImageUrl : '{{ product.image_url }}',
       Url : '{{ product.permalink }}',
       Metadata : {
       Marque : '{{ product.brand }}',
       Prix : {{ product.price }},
       OnSale : {{ product.on_sale }},
       Prix normal : {{ product.regular_price }},
       SalePrice : {{ product.sale_price }}
    }
    }) ;
   </script>

2. L'extrait ci-dessus utilise la syntaxe de l'espace réservé {{ }} qui peut être différente pour votre boutique Spree. Ce qui est important, c'est que les champs de produits sont rendus de manière dynamique en fonction de la page de produit que vous consultez.
3. Une fois que le suivi des produits v us a été configuré pour votre site, les données relatives aux produits vus devraient commencer à s'afficher dans votre compte Klaviyo au fur et à mesure que des visiteurs connus parcourent vos pages de produits.

Comment fonctionne le suivi sur place ?

Lorsque vous ajoutez le suivi sur site de Klaviyo à votre site, nous ne pouvons suivre que l'activité de navigation de "navigateurs connus" - c'est-à-dire les navigateurs qui ont visité et engagé au moins une fois auparavant. Il y a deux façons principales d'identifier un visiteur du site à des fins de suivi sur le site :

• Si quelqu'un a, à un moment ou à un autre, cliqué sur un e-mail de Klaviyo pour accéder à votre site web
• Si quelqu'un s'est, à un moment donné, abonné/opté par le biais d'un formulaire Klaviyo

Klaviyo ne suit pas les navigateurs anonymes.

Surveillez la synchronisation de Klaviyo 

Pour vérifier votre intégration :

1. Cliquez sur le menu déroulant Analytics dans Klaviyo et sélectionnez Metrics. Ici, vous pouvez filtrer pour afficher toutes les mesures de Spree.
2. Trouvez l'ordonnée placéede Spree et cliquez sur l'icône du flux d'activité. Si votre intégration a commencé à synchroniser les données, vous commencerez à voir les événements de commandes passées s'afficher ici.
3. Nous synchroniserons automatiquement toutes les données historiques des commandes. Pour le vérifier, vous pouvez comparer le nombre d'événements d'un jour donné dans Klaviyo avec ce qui figure dans votre interface Spree et confirmer qu'ils correspondent. Par exemple, lorsque vous explorez l'indicateur des commandes passées, 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é déclarées hier.
4. Comparez ce chiffre à celui qui est stocké dans Spree depuis hier et vous devriez constater 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 votre compte Spree.
5. Pour vérifier votre fuseau horaire dans Klaviyo :
   • 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.
6. Une fois la synchronisation historique terminée, vous verrez un cadre vert clair autour de votre intégration Spree dans l'onglet Intégrations.

Données synchronisées à partir de Spree

Vous trouverez ci-dessous une liste d'indicateurs que Spree synchronise avec Klaviyo. Vous pouvez consulter tous les indicateurs Spree synchronisés avec votre compte sous Analytics > Metrics. 

Commande passée 

Cet indicateur enregistre un événement chaque fois qu'une personne passe une commande et la paie avec succès. Il correspond aux commandes dans Spree qui sont complètes, ce qui signifie que le client a terminé l'ensemble du processus de paiement. Grâce à cette mesure, vous pouvez facilement créer des listes dynamiques de personnes en fonction du nombre de commandes qu'elles ont passées ou de leur valeur à vie. Vous pouvez également créer des e-mails pour relancer les anciens clients ou envoyer des e-mails de remerciement aux nouveaux acheteurs. Vous pouvez filtrer et cibler les événements de commande passée en fonction des critères suivants :

• IsDiscounted
  Si une commande a fait l'objet d'une remise, par exemple, true ou false.
• ItemNames
  Les noms des produits achetés dans le cadre de cet événement.

Produit commandé

Cette mesure est similaire à la mesure des commandes passées, mais un événement est enregistré pour chaque article commandé par une personne. Par exemple, si quelqu'un a acheté un t-shirt et un short, cela apparaîtra dans Klaviyo comme un événement " Commande passée" et deux événements " Produit commandé ", l'un pour le t-shirt et l'autre pour le short. Cette mesure est utile pour établir des listes ciblant les clients qui ont acheté (ou n'ont pas acheté) des articles spécifiques ou des articles appartenant à des catégories spécifiques. Vous pouvez également utiliser l'indicateur Produit commandé comme déclencheur de flux pour envoyer des e-mails sur des produits connexes qui vont naturellement ensemble, mais que certains clients n'ont pas encore achetés.

• Catégories
  Les catégories auxquelles appartient le produit commandé, par exemple Chemises, Hommes ou Soldes.
• Nom
  Nom du produit acheté, par exemple T-shirt rouge pour homme.
• ProductId
  L'identifiant de votre produit tel qu'il est défini dans votre magasin, par exemple 2022, 2023, 2024.
• Quantité
  La quantité d'un produit commandé.
• SKU
  Le SKU du produit tel qu'il est défini dans votre magasin.
• Option de variante : Couleur
  La couleur du produit, si elle est disponible, par exemple, rouge ou bleu.
• Variante Option : Taille
  La taille du produit, si elle est disponible, par exemple, moyen ou grand.

Commande exécutée

Cette mesure enregistre un événement lorsque la commande d'un client est expédiée. L'événement dans Klaviyo inclut le numéro de suivi pour tous les envois, de sorte que vous pouvez utiliser cette métrique comme déclencheur pour les e-mails de confirmation d'expédition. Un autre e-mail courant basé sur l'indicateur de commandes honorées est l'e-mail d'évaluation des produits, dans lequel vous demandez aux clients de laisser un avis sur les articles qu'ils ont récemment achetés. L'utilisation de la métrique " Fulfilled Order " vous permet de programmer ces e-mails en fonction de la date de réception de la commande, de sorte que vous n'avez pas à vous soucier d'envoyer un courriel à une personne avant qu'elle n'ait reçu son colis. Vous pouvez filtrer et cibler les événements de commande exécutée en fonction des critères suivants :

• IsDiscounted
  Si une commande a fait l'objet d'une remise, par exemple, true ou false.
• ItemNames
  Les noms des articles achetés dans le cadre de cet événement.

Début de l'encaissement

Cette mesure enregistre un événement chaque fois qu'une personne commence à passer à la caisse et qu'elle a saisi son adresse électronique. La principale utilisation de cette mesure est l'envoi de e-mails concernant les paniers abandonnés. Avec Klaviyo, vous pouvez facilement configurer un flux d'e-mails pour envoyer un rappel de panier si quelqu'un a commencé à passer à la caisse mais n'a pas passé commande au bout de quelques heures. L'événement Started Checkout contient toutes les informations relatives au panier d'une personne, ce qui vous permet d'afficher les produits contenus dans son panier ainsi que des images de ces produits. Pour les utilisateurs plus expérimentés, vous pouvez mettre en place deux flux de panier abandonné - l'un pour les nouveaux clients qui inclut un code de réduction, et l'autre pour les acheteurs récurrents qui n'inclut pas de code de réduction. Vous pouvez filtrer et cibler les événements Started Checkout en fonction des critères suivants :

• IsDiscounted
  Si une commande a fait l'objet d'une remise, par exemple, true ou false.
• ItemNames
  Les noms des articles achetés dans le cadre de cet événement.

Données sur les clients

Outre les indicateurs synchronisés par Klaviyo à partir de Spree, des propriétés clients 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 qui sont automatiquement synchronisées à partir de Spree :

• Courriel
• Prénom
• Nom de famille
• Ville
• État/Région
• Code postal
• Pays
• Numéro de téléphone

Résultats

Vous avez maintenant intégré votre compte Klaviyo à Spree, installé le suivi sur site et examiné vos données synchronisées.

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