Comment s'intégrer à OpenCart

Vous apprendrez

Apprenez à intégrer OpenCart avec Klaviyo. Une fois ces étapes franchies, vous serez en mesure de personnaliser et de cibler les e-mails en fonction des achats de chaque client et de l'activité du site Web. L'intégration d'OpenCart se synchronise toutes les heures.

Avant de commencer 

Veuillez noter que Klaviyo ne synchronise pas votre catalogue depuis OpenCart.

Ajouter l'intégration OpenCart

Le processus d'intégration de Klaviyo à OpenCart se fait en plusieurs étapes et nécessite de prendre des mesures à la fois dans OpenCart et dans Klaviyo.

Pour commencer, Klaviyo supporte actuellement OpenCart 1.4.x et 1.5.x. Téléchargez le module Klaviyo OpenCart à partir d'ici : https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Dézippez le fichier à la racine de votre installation OpenCart.
2. Connectez-vous à la section d'administration d'OpenCart et allez à la page Extensions > Modules.
3. Installez le module Klaviyo, puis cliquez sur Modifier pour le module Klaviyo.
4. La dernière chose à faire avec votre installation OpenCart est de copier et coller le code PHP suivant à la fin du fichier `upload/index.php`, juste avant la ligne `$response->getOutput();` :

   // [Klaviyo] Enregistrez le panier du client s'il existe.
   if ($registry->get('cart')->hasProducts()) {
    $registry->get('load')->model('module/klaviyo') ;
   
    if ($registry->get('customer')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } else if (array_key_exists('guest', $session->data)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. Dans Klaviyo, sélectionnez l’onglet Intégrations.
6. Cliquez sur Ajouter des intégrations et recherchez OpenCart, puis cliquez sur la carte. Ensuite, cliquez sur Installer.
7. Vous accédez à la page Paramètres d'intégration . Sur la page des paramètres, entrez l'URL de votre site OpenCart et cliquez sur Connect to OpenCart.
   
8. Sur la page suivante, copiez la clé API sous Klaviyo OpenCart Module et collez-la dans les paramètres du module Klaviyo dans OpenCart. Sauvegardez les paramètres du module Klaviyo dans l'administration d'OpenCart.
   
9. Si vous le souhaitez, cochez l'option Ajouter les nouveaux clients OpenCart à une liste Klaviyo, puis sélectionnez une liste dans le menu déroulant.
10. De retour dans Klaviyo, cliquez sur Terminer la configuration pour commencer à synchroniser les données.

Installez Klaviyo onsite tracking

Pour suivre l'activité sur site dans OpenCart, commencez par trouver votre clé API publique Klaviyo en vous connectant à votre compte, en cliquant sur votre nom de compte dans le coin inférieur gauche et en naviguant vers Paramètres > Clés API. Votre clé publique comporte six caractères. Il existe deux types de suivi sur site que vous pouvez installer :

• 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.

Ajouter "Active sur le site" tracking

Cette mesure est suivie chaque fois qu'un navigateur identifiable visite votre site web. Pour commencer à suivre l'activité d'Active on Site:

1. Ajoutez l'extrait de code suivant au modèle de votre boutique principale 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 >:
   

   <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>
   

2. Veillez à remplacer PUBLIC_API_KEY par la clé API publique de votre compte Klaviyo.
3. Si les visiteurs ou les clients peuvent créer des comptes pour votre magasin, ajoutez l'extrait suivant directement sous le premier extrait :

   <script type="text/javascript">
     var klaviyo = window.klaviyo || [] ;
     {% if user.is_logged_in %}
     klaviyo.identify({
       $email : '{{ user.email }}',
       $first_name : '{{ user.first_name }}',
       $last_name : '{{ user.last_name }}'
       }) ;
     {% endif %}
   </script>

4. 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.

Ajouter "Produit vu" 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 sur les produits, vous devez ajouter le suivi des événements JavaScript pour une mesure "Viewed Product".

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.title }}',
         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.url }}',
         Metadata : {
           Marque : '{{ product.brand }}',
           Prix : {{ product.price }},
           CompareAtPrice : {{ product.compare_at_price }} // Si vous disposez d'un comparateur de prix. Vous pouvez également l'inclure dans le cadre d'une vente ou d'un prix spécial.
         }
     }) ;
   </script>

2. L'extrait ci-dessus utilise la syntaxe de l'espace réservé {{ }} qui peut être différente pour votre boutique OpenCart. 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 web de Klaviyo à votre site, nous ne pouvons suivre que l'activité de navigation de "navigateurs connus" - c'est-à-dire les navigateurs qui ont été visités et engagés au moins une fois auparavant. Il y a deux façons principales d'identifier un visiteur du site à des fins de suivi du web :

• 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

Le temps nécessaire pour synchroniser toutes les données historiques des clients et des commandes de votre boutique OpenCart dépend de la taille de votre boutique. Une fois la synchronisation historique terminée, vous verrez un cadre vert autour de votre intégration OpenCart sous Intégrations activées.

Pour vérifier votre intégration :

1. Accédez à l'onglet Métriques de votre compte, qui se trouve sous la rubrique Analyses. Ici, vous pouvez filtrer pour afficher toutes les mesures OpenCart. Trouvez l'indicateur d 'OpenCart  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.
2. 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 OpenCart et confirmer qu'ils correspondent.
3. 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 nombre à celui stocké dans OpenCart depuis hier et vous devriez voir qu'ils correspondent exactement. Si ce n'est pas le cas, le problème vient probablement du fait que le fuseau horaire de votre compte Klaviyo ne correspond pas au fuseau horaire défini pour OpenCart.

5. Pour vérifier ou mettre à jour le fuseau horaire de votre compte :

   • Cliquez sur le nom de votre organisation en bas à gauche.

   • Sélectionnez Paramètres.
   • Allez dans l'onglet Organisation . 

Données synchronisées depuis OpenCart

• Données sur les ventes et les commandes
  Quels produits ont été achetés, y compris les détails et les images des produits.
• Informations sur les clients
  Prénom, nom de famille, lieu et groupe de clients.
• Données d'achat initiales
  Utilisées pour déclencher l'envoi d'e-mails concernant les paniers abandonnés. Cette fonction est activée par l'extrait de code PHP que vous avez ajouté lors de l'intégration.
• Données relatives aux commandes exécutées
  Utilisées pour suivre l'expédition des commandes.
• Suivi sur site
  Lorsque des personnes visitent votre site web

Pour accéder à vos mesures OpenCart, naviguez vers Analytics > Metrics dans Klaviyo, où vous pouvez filtrer par OpenCart.

Par défaut, Klaviyo synchronise les statuts suivants pour les mesures des commandes passées et des commandes exécutées:

• Commande passée : En attente, traitée, en cours de traitement, expédiée, terminée
• Commande exécutée : Expédiée, complète

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