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

Objectif de cet article

Découvrez comment intégrer Klaviyo à votre boutique Magento 2 CE ou EE. Vous devez installer l’extension Klaviyo dans Magento, configurer l’extension et mettre en place OAuth, puis activer l’intégration dans Klaviyo. Ce guide explique toutes les étapes d’intégration requises, ainsi que la procédure de confirmation de la synchronisation de vos données historiques.

Avant de commencer

Pour que Klaviyo puisse effectuer les appels d’API nécessaires à l’intégration, le nom d’hôte de votre serveur Magento 2 doit être public. Les serveurs Magento 2 hébergés localement ne pourront pas être pleinement intégrés à Klaviyo.

Identifier la version de votre extension Klaviyo

Toutes les plages de versions du tableau sont inclusives. Toutes les extensions peuvent être installées via Composer.

Le processus d’installation diffère selon la version de Magento 2 que vous utilisez.

Si vous utilisez Magento 2 version 2.4.0 ou ultérieure, suivez les instructions détaillées dans la section Installer avec Composer ci-dessous.

Si vous utilisez des versions de Magento 2 antérieures à 2.4.0 : nous avons publié des correctifs pour assurer la compatibilité entre les anciennes versions de nos extensions et nos nouvelles API. Les liens Github sont fournis dans le tableau ci-dessus. Ils sont également disponibles pour l’installation via Packagist/Composer. Vous devez les installer en utilisant la méthode que vous employez actuellement pour installer les extensions (pour Composer, suivez les instructions de la section Installer avec Composer ci-dessous). Si vous utilisez Magento 2 version 2.2.0, vous devez activer manuellement OAuth après l’installation.

Installer l’extension Klaviyo dans Magento 2

Vidéo de démonstration

Installer avec Composer

1. Connectez-vous à votre serveur Magento 2 et accédez au répertoire racine de votre application Magento à l’aide de votre outil de ligne de commande. Ce guide montre des exemples de résultats pour Terminal, mais ces étapes peuvent être modifiées pour n’importe quel outil de ligne de commande de votre choix.
2. Exécutez la commande suivante pour accéder à la dernière version de l’extension Klaviyo depuis Packagist. Packagist est un répertoire de bibliothèques de code PHP qui vous permet d’installer facilement la dernière version de l’extension.
   composer require klaviyo/magento2-extension
3. Si vous avez besoin d’installer une ancienne version de l’extension Magento 2 avec Composer, spécifiez la version que vous souhaitez installer. Par exemple :
   composer require klaviyo/magento2-extension:3.0.4-patch
4. Exécutez la commande suivante pour activer l’extension Klaviyo que vous venez de télécharger :
   php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
5. Comme le montre l’exemple de résultat, vous devez maintenant activer les modules supplémentaires. Pour cela, exécutez la commande suivante :
   php bin/magento setup:upgrade
6. Analysez le résultat de Module ’Klaviyo_Reclaim’ pour confirmer que le module Klaviyo est activé et en cours d’exécution.
7. Pour vous assurer que les CSS et JS de votre boutique Magento 2 continuent de fonctionner correctement, vous devrez exécuter une commande de déploiement de contenu statique.
   php bin/magento setup:static-content:deploy -f
8. Vous pouvez maintenant retourner au tableau de bord d’administration de Magento depuis votre navigateur.

L’installation via Composer est terminée ! Passez à la section suivante pour consulter les instructions de configuration.

Configurer l’extension Klaviyo

Vidéo de démonstration

1. Dans votre compte Klaviyo, accédez à l’onglet Clés d’API.
2. Dans un nouvel onglet, accédez à l’administration de votre boutique Magento.
3. Sous Settings (Paramètres), cliquez sur Stores (Boutiques) > Configuration.
4. Dans le menu déroulant de Klaviyo, cliquez sur Général.
5. Définissez Enable Klaviyo Extension (Activer l’extension Klaviyo) sur Yes (Oui).
6. Copiez votre clé d’API publique Klaviyo à six chiffres depuis l’onglet Clés d’API et collez-la dans la case correspondante dans Magento.
7. Dans l’onglet Clés d’API de Klaviyo, générez une nouvelle clé privée, puis collez-la dans la case correspondante dans Magento. L’authentification avec votre clé d’API privée vous permettra de synchroniser les abonnements à la newsletter depuis Magento vers Klaviyo.

Dans la section suivante, vous allez configurer OAuth, qui active d’autres aspects de l’intégration.

Configurer OAuth

Vous allez désormais activer l’authentification OAuth pour connecter de manière sécurisée votre compte Klaviyo à l’extension Magento 2. Si vous disposez d’une intégration existante et que vous avez besoin d’ajouter OAuth, un guide distinct est à votre disposition. Si vous utilisez la version 2.2.0 de Magento 2, consultez notre guide sur l’activation manuelle d’OAuth pour votre intégration.

1. Accédez à l’onglet Setup OAuth (Configurer OAuth) dans Magento.
2. Donnez un nom identifiable à votre intégration, car vous devrez la retrouver sous ce nom par la suite.
3. Cliquez sur Save Config (Enregistrer la configuration) pour continuer.
   
4. Localisez System (Système) dans le volet de navigation de gauche et sélectionnez Integrations (Intégrations) dans la barre d’état System (Système).
5. Localisez le nom de votre intégration et cliquez sur Activate (Activer). L’activation de l’intégration ouvre une fenêtre vous demandant d’approuver l’accès.
   
6. Cliquez sur Allow (Autoriser) pour être redirigé vers Klaviyo, où vous terminerez la configuration de l’intégration.
   
7. Connectez-vous à Klaviyo si vous y êtes invité, ou confirmez que votre nom de compte est correct, puis cliquez sur Intégrer.Cela ajoute l’intégration Magento 2 au compte Klaviyo associé à la clé d’API que vous avez utilisée pour la configuration. Si vous êtes connecté à plusieurs comptes Klaviyo et que le compte correct ne s’affiche pas, déconnectez-vous de toutes les autres sessions.
   

Si la fenêtre se ferme automatiquement, la connexion a réussi. Pour vous en assurer, ouvrez votre compte Klaviyo dans un nouvel onglet ou une nouvelle fenêtre de navigateur, sélectionnez l’onglet Intégrations et recherchez Magento 2 dans la liste.

Si, au contraire, l’erreur suivante s’affiche, assurez-vous que les clés d’API utilisées lors de la première étape correspondent au compte auquel vous êtes actuellement connecté.

Lors de l’établissement de la connexion entre Magento et Klaviyo, si vous recevez une liste d’erreurs, cliquez sur chacune d’entre elles pour en savoir plus sur leur cause.

Créer une liste de newsletter

Sélectionnez ensuite une liste Klaviyo sur laquelle synchroniser les abonnés à votre newsletter. Vous avez la possibilité d’utiliser les paramètres d’opt-in de Klaviyo ou les paramètres d’opt-in de Magento 2 pour la liste choisie.

1. Dans Magento, cliquez sur Newsletter.
2. Sélectionnez dans le menu déroulant la liste Klaviyo avec laquelle vous souhaitez synchroniser votre formulaire d’inscription Magento.
3. Cliquez sur Save Config (Enregistrer la configuration).

Activer le consentement au moment du passage de commande

Ensuite, vous pouvez choisir d’activer le consentement à la commande pour les e-mails et les SMS.

Veuillez noter que si vous activez le consentement au moment du passage de commande, vous devez également activer les webhooks (ci-dessous) pour assurer son bon fonctionnement.

1. Sur la page Configuration, sous Klaviyo, accédez à Consent at Checkout (Consentement au moment du passage de commande).
   
2. Vous verrez une section pour recueillir le consentement pour l’envoi d’e-mails et de SMS. Les deux sont traités séparément, de sorte que vous pouvez collecter uniquement le consentement pour le marketing par e-mail, par SMS ou les deux. Si vous collectez à la fois des abonnés aux SMS et aux e-mails, choisissez une liste différente pour chaque canal. Cela permet de s’assurer que le consentement est toujours attribué au bon canal.
   • Le consentement ne sera pas synchronisé (tant pour les e-mails que pour les SMS) tant que le client n’aura pas finalisé sa commande et, le cas échéant, n’aura pas confirmé son inscription en cas de double opt-in.
   • Veuillez noter que pour les utilisateurs déjà connectés à votre boutique Magento 2, la case à cocher de consentement pour l’envoi d’e-mails n’apparaît pas par défaut lors du passage de commande.
3. Sous Email (E-mail), sélectionnez Yes (Oui) pour Subscribe contacts to email marketing at checkout (Abonner les contacts au marketing par e-mail lors de la commande).
4. Sélectionnez une liste d’e-mails à laquelle abonner les abonnés, par exemple celle de votre newsletter.
5. Saisissez le texte de la case à cocher d’opt-in pour les e-mails que vous souhaitez utiliser.
   
6. Sous SMS, sélectionnez Yes (Oui) pour Subscribe contacts to SMS marketing at checkout (Abonner les contacts au marketing par SMS lors de la commande).
7. Choisissez la liste vers laquelle vous souhaitez synchroniser vos contacts SMS. Pour plus d’informations sur ces paramètres, consultez notre guide sur la collecte du consentement pour l’envoi de SMS lors du passage de commande.
   
8. L’ordre de tri vous permet de modifier l’emplacement des cases de consentement pour l’envoi d’e-mails et de SMS. Par défaut, ces cases apparaissent respectivement sous le premier champ de saisie de l’adresse e-mail et sous le champ du numéro de téléphone utilisé pour la livraison. Par conséquent, si vous n’avez pas réorganisé la page de commande, vous n’avez pas besoin de modifier l’ordre de tri. Si vous avez modifié la mise en page, ajustez l’ordre de tri en conséquence.
9. Lorsque vous avez terminé, cliquez sur Save Config (Enregistrer la configuration) en haut à droite.

Activer les webhooks

1. Depuis le tableau de bord de l’administrateur, naviguez vers Stores (Boutiques) > Configuration.
2. Cliquez sur Klaviyo et sélectionnez l’onglet Webhooks. 
3. Créez un secret webhook et saisissez-le dans le champ Webhook Secret (Secret webhook) correspondant. Le secret webhook est une clé que Klaviyo utilise pour la validation. Ce code est libre, mais nous vous recommandons de créer une chaîne sécurisée de lettres et de chiffres. Magento masque votre secret webhook par des astérisques à des fins de sécurité, veillez donc à le saisir correctement.
   
   Si vous utilisez une intégration multi-boutiques, le secret webhook renseigné dans ce champ doit être saisi dans votre configuration par défaut. Le même secret sera utilisé comme validation pour la configuration de chaque boutique. Le secret webhook ne doit être ajouté qu’à la configuration par défaut et ne doit pas être ajouté par boutique.
4. En regard des webhooks que vous souhaitez activer, sélectionnez Yes (Oui) dans le menu déroulant. Pour en savoir plus sur les webhooks pris en charge par Klaviyo, consultez notre guide des webhooks pour Magento 2.
5. Cliquez sur Save Config (Enregistrer la configuration).

Activer l’intégration de Magento 2 dans Klaviyo

Vidéo de démonstration

1. Ouvrez Klaviyo, puis sélectionnez Intégrations dans la barre de navigation de gauche. Trouvez Magento 2 dans la liste et sélectionnez-le.
2. Sur la page suivante, vous avez la possibilité d’ajouter de nouveaux clients Magento 2 à une liste Klaviyo. Cliquez sur la case à cocher pour Ajouter les nouveaux clients Magento 2 à une liste Klaviyo et sélectionnez une liste dans le menu déroulant. Veuillez noter que le fait de cocher ce paramètre ajoute uniquement des clients à la liste sélectionnée, mais ne les abonne pas aux messages marketing.
   
   Ce paramètre synchronise uniquement les nouveaux clients. Les clients existants doivent être migrés manuellement depuis votre liste Magento vers Klaviyo.
3. Sous Avancé, activez les paramètres suivants si nécessaire :
   • Boutiques
     Toutes les boutiques Magento 2 sont synchronisées avec Klaviyo par défaut. Ce paramètre vous permet de sélectionner les boutiques à intégrer. Accédez à la rubrique Prise en charge de plusieurs boutiques Magento pour en savoir plus.
   • Paramètres des prix spéciaux
     Ce paramètre fait référence à un prix de vente spécial pour les articles, qui peut éventuellement prendre effet à une certaine période. Nous vous recommandons vivement d’activer cette fonctionnalité si vous prévoyez de l’utiliser, car elle est plus difficile à activer par la suite. Lorsque vous activez l’option Utiliser un prix spécial pour les prix des produits, le cas échéant, le bloc de produit utilise le prix spécial le cas échéant. Si vous utilisez un flux de produits dynamique, le prix spécial est rempli à l’heure d’envoi. Si vous sélectionnez manuellement des articles dans votre catalogue, le prix spécial s’affichera une fois que vous aurez sélectionné le ou les produits. Pour chaque produit, quatre champs de métadonnées sont synchronisés :
     
     • price
       (Obligatoire, flottant) Le prix standard de l’article.
     • special_price
       (Facultatif, flottant) Un prix de vente spécial pour l’article. Lorsque ce prix est en vigueur, vous verrez ce prix spécial à côté d’un prix barré.
     • special_from_date
       (Facultatif, date) Indique la date de début d’entrée en vigueur du prix spécial.
     • special_to_date
       (Facultatif, date) Indique la date de fin de validité du prix spécial.
   • URL racine personnalisée du fichier multimédia
     Ce paramètre vous permet de modifier le chemin par défaut des images de votre site. Activez ce paramètre si vous hébergez les images de vos produits sur une URL différente de celle de votre site web. 
4. Cliquez sur Enregistrer.

L’intégration de Magento 2 est maintenant activée ! La synchronisation de vos données avec Klaviyo commencera dans quelques minutes. 

Une fois la synchronisation initiale des données historiques terminée, l’intégration Magento 2 se synchronise toutes les 30 minutes.

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

L’intégration Magento 2 de Klaviyo extrait des informations clés sur les clients de votre plateforme Magento.

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.
• Données relatives aux ventes et aux commandes, y compris les articles achetés, les images des articles, les catégories d’articles et les remises appliquées.
• Données relatives au traitement, au remboursement et à l’annulation des commandes.
• Heure de consultation de votre site web et articles consultés. L’extension prend en charge le tracking.

Pour en savoir plus, consultez notre guide sur les données de Magento 2.

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

Klaviyo assure la conversion de toutes les devises étrangères de Magento vers une seule devise principale dans Klaviyo. Veuillez contacter l’assistance pour activer cette fonctionnalité. Elle est particulièrement utile si vous gérez plusieurs boutiques avec des transactions dans différentes devises.

Lorsque cette fonctionnalité est activée :

• La conversion se produit lorsque Magento synchronise les données de la commande dans Klaviyo.
• Klaviyo vérifie si le order_currency_code est le même que le global_currency_code défini. Si ce n’est pas le cas, Klaviyo convertit le montant total de la commande dans la devise définie afin de garantir l’exactitude de vos analyses financières. Veuillez noter que les articles de la commande conserveront le code de la devise de la commande et ne seront pas convertis. 

Mettre à jour votre extension

Consultez le tableau ci-dessous : utilisez-vous une version de l’extension inférieure à celle spécifiée pour votre version de Magento 2 ? Si c’est le cas, nous vous recommandons de mettre à jour votre extension immédiatement. Certaines versions plus anciennes de l’extension utilisent les API v1 et v2 de Klaviyo qui ont été retirées et ne fonctionnent plus comme prévu. Nous fournissons des versions corrigées spécifiques dans ce tableau pour aider les clients qui utilisent d’anciennes versions de Magento 2.

Tout d’abord, déterminez la version de l’extension que vous devez installer à l’aide du tableau ci-dessous.

Toutes les plages de versions du tableau sont inclusives. Toutes les extensions peuvent être installées via Composer.

Maintenant que vous connaissez la version à installer, passez à la mise à niveau. Le processus de mise à niveau diffère selon la version de Magento 2 que vous utilisez.

Si vous utilisez Magento 2 version 2.4.0 ou ultérieure, suivez les instructions détaillées dans Installer avec Composer ci-dessus et exécutez la commande pour installer la dernière version. Cette opération écrase votre version actuelle et votre mise à jour sera terminée. Il n’est pas nécessaire de reconfigurer l’extension ou de réactiver l’intégration dans Klaviyo.

Si vous utilisez des versions de Magento 2 antérieures à 2.4.0 : nous avons publié des correctifs pour assurer la compatibilité entre les anciennes versions de nos extensions et nos nouvelles API. Les liens Github sont fournis dans le tableau ci-dessus. Ils sont également disponibles pour l’installation via Packagist/Composer. Vous devez les installer en utilisant la méthode que vous employez actuellement pour installer les extensions (pour Composer, suivez les instructions de la section Installer avec Composer ci-dessus).

Ressources supplémentaires

• Guide sur les données de Magento 2
• Comment collecter le consentement pour l’envoi de SMS lors du passage de commande sur Magento 2
• Communauté Klaviyo : vidéo de questions-réponses sur Magento 2