Premiers pas avec Magento 1.x (CE et EE)

Objectif de cet article

Découvrez comment intégrer Magento 1 (CE et EE) à Klaviyo. Actuellement, notre plateforme est compatible avec la version 1.5 ou ultérieure de Magento.

L’intégration de Magento 1 avec Klaviyo se fait en deux étapes :

1. Activation de l’intégration de Magento dans Klaviyo
2. Installation de l’extension Klaviyo dans Magento

Ce guide couvre les deux étapes et les tâches associées pour les boutiques Magento 1.

Configurer les identifiants de l’API Magento

Pour intégrer Magento 1.x à Klaviyo, vous devez créer un rôle qui dispose d’un accès complet aux ressources et assigner un nouvel utilisateur à ce rôle. Le nom d’utilisateur et le mot de passe de cet utilisateur serviront d’identifiants pour l’API.

Dans votre interface d’administration Magento, cliquez sur l’onglet System et sélectionnez Web Services > SOAP/XML-RPC-Roles.

Sélectionnez Add New Role.Cliquez ensuite sur l’onglet Role Resources et définissez le paramètre Resource Access sur All.

Ouvrez l’onglet Role Info, attribuez le nom « Klaviyo » au rôle, puis cliquez sur Save Role.

Ouvrez l’onglet System et sélectionnez Web Services > SOAP/XML-RPC-Users.

Sélectionnez Add New User.

Ouvrez l’onglet User Role et indiquez Klaviyo dans le champ Role.

Ouvrez l’onglet User Info. Définissez le paramètre User Name sur « klaviyo » et entrez une clé d’API forte dans le champ API Key. Vous pouvez saisir n’importe quelle valeur alphanumérique. Notez les valeurs saisies dans les champs User Name et API Key, car vous en aurez besoin pour activer l’intégration Magento 1 dans Klaviyo. Remplissez le reste des informations et cliquez sur Save User.

Performances de l’API

Pour améliorer les performances de votre intégration, nous vous recommandons vivement d’activer la mise en cache pour les deux paramètres Web Services Configuration de Magento.

Dans votre interface d’administration Magento, cliquez sur System > Cache Management.

Activez la mise en cache pour les deux paramètres Web Services Configuration.

Activer l’intégration Magento 1 dans Klaviyo

Utilisez la clé d’API Magento que vous avez créée pour activer l’intégration Magento 1 dans Klaviyo.

Connectez-vous à votre compte Klaviyo et cliquez sur Intégrations dans la barre de navigation de gauche. Cliquez ensuite sur Ajouter des intégrations et trouvez Magento. Cliquez sur la carte Magento, puis sur Installer.

Saisissez les informations suivantes :

• URL du site
  L’URL du site est l’adresse de votre instance Magento.
• Nom d’utilisateur de l’API
  Le nom d’utilisateur que vous avez créé pour votre nouvel utilisateur avec les autorisations d’API.
• Mot de passe/Clé d’API
  La clé d’API que vous avez créée pour votre nouvel utilisateur.

Cliquez ensuite sur Connecter à Magento. Les options avancées suivantes s’affichent. Vous pouvez les activer si nécessaire :

• Boutiques
  Toutes les boutiques Magento 1 sont synchronisées avec Klaviyo par défaut. Ce paramètre vous permet de sélectionner les boutiques à intégrer. Accédez à la rubrique sur la prise en charge de plusieurs boutiques Magento pour en savoir plus.
• Paramètres des prix spéciaux
  Nous vous recommandons vivement d’activer les Paramètres des prix spéciaux si vous envisagez d’utiliser cette fonctionnalité. Il est plus difficile d’activer ce paramètre ultérieurement. Vous trouverez plus d’informations à ce sujet dans la section Prix spécial ci-dessous.
• Paramètres des codes de réduction
  Consultez ce guide d’activation des codes de réduction dans Magento 1, puis remplissez ces champs.

Lorsque vous avez terminé, cliquez sur Terminer la configuration.

Magento 1 est maintenant connecté à Klaviyo. Ensuite, vous devez ajouter l’extension Klaviyo à votre compte Magento.

Installer l’extension Klaviyo dans Magento

L’extension Klaviyo ajoute à votre boutique Magento le tracking des indicateurs Active on Site et Viewed Product. L’installation de l’extension Klaviyo pour Magento est également nécessaire pour commencer à synchroniser les événements Checkout Started, qui permettent notamment de déclencher votre flux de panier abandonné.

La dernière extension de Klaviyo pour Magento 1 est la v.1.9.0, mise à jour en octobre 2024 : Téléchargement de l’extension Magento 1 v1.9.0.

Après avoir téléchargé l’extension sur votre ordinateur, accédez à System > Magento Connect > Magento Connect Manager.

Sous Direct package file upload, cliquez sur Choose File et sélectionnez l’extension que vous avez téléchargée ci-dessus. Cliquez sur Upload. Le processus de téléchargement et d’installation commence.

Une fois l’extension installée, accédez à la page correspondante pour configurer ses paramètres.
Accédez à System > Configuration et cliquez sur Klaviyo dans la section Customers. Si, après avoir cliqué sur Klaviyo, vous obtenez un message d’erreur 404, déconnectez-vous de Magento et reconnectez-vous.

Passez l’option Enabled en Yes et remplissez les autres champs. Les champs Consumer Key, Consumer Secret, Authorization Token, et Authorization Secret peuvent tous être laissés vides, sauf si vous configurez des codes de réduction avec Magento.

Synchroniser un formulaire d’inscription Magento avec une liste Klaviyo

Si besoin, vous pouvez synchroniser un formulaire d’inscription Magento pour que les utilisateurs soient ajoutés à une liste Klaviyo.

Tout d’abord, créez une liste dans Klaviyo.

Si vous n’êtes pas déjà dans l’onglet General Settings (comme indiqué dans la section précédente), accédez à System > Configuration et cliquez sur Klaviyo dans la section Customers.

Dans le menu déroulant General Subscription List, sélectionnez la liste Klaviyo avec laquelle vous souhaitez effectuer la synchronisation.

Par défaut, l’option Use Klaviyo Opt-In Settings For This List? est réglée sur Yes, use the Klaviyo settings for this list.Nous vous recommandons de laisser ce paramètre activé. Il a les effets suivants :

• Pour une liste à double opt-in, l’utilisateur reçoit un e-mail de confirmation avant d’être ajouté à la liste désignée. Une fois la confirmation effectuée, l’ajout à la liste est validé et un indicateur Subscribe to List est enregistré. En l’absence de confirmation, l’utilisateur n’est pas ajouté à la liste.
• Pour une liste à opt-in simple, le client est ajouté à la liste directement et un indicateur Subscribe to List est enregistré.

Si l’option No, do not send opt-in emails from Klaviyo est activée, l’indicateur Subscribed to List n’est jamais enregistré lorsqu’un profil est ajouté à une liste. Il est déconseillé d’utiliser ce paramètre, mais il reste disponible pour des raisons de compatibilité avec d’anciennes configurations.

Configurer une tâche cron dans Magento

L’extension Klaviyo utilise des tâches cron pour rester à jour et exécuter régulièrement des tâches de maintenance.

Dans l’interface d’administration de Magento, Accédez à System > Configuration.

Descendez jusqu’à la section Advanced et sélectionnez System.

Sélectionnez ensuite Cron (Scheduled Tasks).Configurez une tâche cron de sorte qu’elle s’exécute toutes les 5 minutes, puis cliquez sur Save Config.

Pour plus d’informations sur la configuration des tâches cron dans Magento, consultez la documentation de Magento.

Configurer une tâche cron dans un système d’exploitation basé sur UNIX

Si vous avez un accès shell à votre serveur, vous pouvez utiliser la commande de service crontab. La tâche cron dans Magento doit s’exécuter toutes les cinq minutes. La configuration temporelle est donc la suivante :

*/5 * * * *

La ligne complète dans crontab ressemblera à l’une de celles-ci (la première version est à privilégier) :

*/5 * * * * /bin/sh MAGENTO_PATH/cron.sh
*/5 * * * * /bin/bash MAGENTO_PATH/cron.sh
*/5 * * * * /usr/bin/php MAGENTO_PATH/cron.php
*/5 * * * * /usr/local/bin/php -f MAGENTO_PATH/cron.php

Remplacez MAGENTO_PATH par l’emplacement de votre installation Magento sur le serveur.

Configurer une tâche cron à l’aide de cPanel (ou de votre fournisseur d’hébergement virtuel)

Si vous n’avez pas d’accès shell, vous pouvez consulter la documentation de votre fournisseur d’hébergement virtuel. Vous trouverez ci-dessous un exemple de l’utilisation pour cPannel.

Connectez-vous à cPanel à l’aide de votre compte d’hébergement. Trouvez la section Advanced et cliquez sur l’icône Cron jobs.

Une liste des tâches cron en cours s’affiche, ainsi qu’un formulaire d’ajout de nouvelle tâche. Saisissez les paramètres suivants dans le formulaire Add New Cron Job. Veillez à remplacer MAGENTO_PATH par le chemin d’accès de votre installation Magento. Si vous n’êtes pas sûr du chemin d’accès ou que vous ne savez pas où le trouver, vous pouvez utiliser un programme FTP pour parcourir les fichiers de votre serveur et trouver le répertoire qui contient le fichier cron.sh.

Après avoir ajouté la nouvelle tâche cron, vous devriez voir les données de commande apparaître dans Klaviyo dans les 15 minutes qui suivent.

Contrôler la synchronisation des données historiques

Lorsque vous intégrez Magento 1 pour la première fois, Klaviyo commence par synchroniser vos données des 90 derniers jours afin que vous puissiez commencer à communiquer immédiatement auprès de vos clients récents. Ensuite, Klaviyo commence la synchronisation de l’ensemble de vos données historiques. En fonction du nombre de commandes, de clients et de produits de votre boutique, la synchronisation de toutes vos données peut prendre de quelques minutes à plusieurs jours.

Une fois la synchronisation historique terminée, les nouvelles données seront synchronisées avec Klaviyo toutes les 30 minutes. Pour vérifier la progression de la synchronisation initiale, cliquez sur l’onglet Analyse dans la barre latérale.

Recherchez l’indicateur Placed Order et modifiez la période du graphique pour voir les dates qui ont été entièrement synchronisées. Une fois la synchronisation terminée, vous verrez dans l’onglet Intégrations que l’intégration de Magento 1 est terminée. Pour vérifier par vous-même que toutes les données provenant de Magento 1 sont synchronisées, vous pouvez comparer le nombre total de commandes sur quelques jours ou sur une semaine. Avant de commencer la validation, assurez-vous que le fuseau horaire de votre compte est le même que celui de Magento 1.

Données synchronisées avec l’intégration Magento 1

L’intégration Klaviyo pour Magento vous permet d’extraire certaines informations sur les clients depuis Magento afin d’envoyer des e-mails ciblés et axés sur les données dans Klaviyo. Une fois que vous avez configuré votre intégration, vous pouvez personnaliser et cibler vos messages en fonction des achats des clients et de l’activité du site web. Voici quelques-unes des données que nous synchronisons à partir de Magento :

• Données sur le client, y compris son prénom, son nom de famille et sa localisation.
• Klaviyo synchronise tous les clients qui s’inscrivent à votre liste de newsletter dans Magento. Il est important de s’assurer qu’ils ont tous consenti à recevoir des e-mails à caractère marketing.
• Données relatives au traitement, au remboursement et à l’annulation des commandes.
• Visites sur votre site web, produits et catégories consultés.
  • Ces indicateurs apparaissent dans votre compte sous les intitulés Active on Site et Viewed Product.
  • Vous n’avez pas besoin d’ajouter l’extrait de code de tracking de Klaviyo à votre site lorsque vous utilisez l’intégration Magento : ces indicateurs sont déjà gérés par notre extension.

Pour en savoir plus, consultez cet article pour examiner et comprendre vos données Magento 1.

Créer une clé d’API avec des autorisations limitées

Cette documentation couvre l’API SOAP de Magento, sur laquelle repose l’intégration de Klaviyo. Nous vous recommandons d’autoriser l’accès à tous les points de terminaison situés dans le chemin /api/*. Bien que ces autorisations ne correspondent probablement pas directement à celles que vous verrez lors de la configuration de l’utilisateur et du rôle SOAP (car elles ont changé au cours des différentes versions 1.x), voici les appels d’API que nous effectuons pour Magento 1.x :

• catalogCategoryTree
• catalogInventoryStockItemList
• catalogProductAttributeInfo
• catalogProductAttributeMediaList
• catalogProductInfo
• catalogProductList
• catalogProductTagList
• customerCustomerInfo
• customerCustomerList
• customerGroupList
• salesOrderInfo
• salesOrderList
• shoppingCartInfo
• storeList

Si vous devez ajouter certains ports à une liste d’autorisation (si vous avez un pare-feu, par exemple), l’intégration Magento est actuellement sur HTTP/80, mais si elle est disponible sur le port 443, cela peut être modifié.

Prix spécial

Lors de la configuration de vos paramètres d’intégration, vous avez la possibilité d’extraire le paramètre « Prix spécial », qui fait référence à un prix de vente spécial pour les produits. Il peut éventuellement prendre effet à une certaine période. Pour chaque produit, 4 champs de métadonnées sont synchronisés :

• price (Obligatoire, flottant) : prix standard du produit.
• special_price (Facultatif, flottant) : prix de vente spécial du produit. Lorsque ce prix est en vigueur, vous verrez cette valeur special_price à côté de la valeur price barrée.
• special_from_date (Facultatif, date) : date de début d’entrée en vigueur de la valeur special_price.
• special_to_date (Facultatif, date) : date de fin de validité de la valeur special_price.

Sur la page des paramètres d’intégration de Magento 1, une case à cocher permet d’Utiliser un prix spécial pour les prix des produits, le cas échéant. Lorsque ce paramètre est activé, le bloc de produit affiche le prix spécial le cas échéant. Si vous utilisez un flux de produits dynamique, le prix spécial est rempli au moment de l’envoi. Si vous sélectionnez manuellement des articles dans votre catalogue, le prix spécial s’affiche une fois que vous avez sélectionné le ou les produits.

Convertir les valeurs de commande de Magento dans une même devise

Klaviyo prend en charge la conversion de toutes les devises étrangères dans Magento en une devise principale dans Klaviyo. Une fois cette dernière activée, la conversion se produit lorsque Magento synchronise les données de commande dans Klaviyo. C’est particulièrement utile si vous avez plusieurs boutiques qui effectuent des transactions dans différentes devises.

Klaviyo vérifie que la valeur order_currency_code est identique à global_currency_code. Si ce n’est pas le cas, Klaviyo convertit le montant total de la commande dans la devise définie dans vos paramètres d’intégration. Cela garantit l’exactitude de vos analyses financières.

Mettre à jour votre extension

Utilisez-vous une version de l’extension Magento inférieure à 1.8.3 ? Nous vous recommandons de passer immédiatement à la version 1.8.3. Les anciennes versions de l’extension utilisent les API v1 et v2 de Klaviyo, qui ont été retirées et ne fonctionnent plus comme prévu. 

Pour passer à la nouvelle version, supprimez l’ancienne et suivez les étapes de ce guide pour réinstaller l’extension. Vous pouvez télécharger la version 1.8.3 ici : Téléchargement de l’extension Magento 1 v1.8.3.