Démarrer avec PrestaShop

Objectif de cet article

Apprenez à intégrer votre boutique PrestaShop à Klaviyo. Klaviyo est le partenaire privilégié de PrestaShop pour l’automatisation du marketing. Ce processus implique 2 étapes : l’installation d’un module gratuit (PrestaShop Automation with Klaviyo) dans PrestaShop et l’activation de l’intégration dans Klaviyo. Cet article donne aussi des informations sur le suivi de la synchronisation de vos données, la configuration des e-mails transactionnels et la mise à jour de votre module afin d’évoluer avec Klaviyo.

Avant de commencer

Pour utiliser le module Klaviyo, vous devez utiliser l’une des versions suivantes de PrestaShop :

• PrestaShop 1.7.0 et version plus récente (et utilisant PHP 7.1 ou version plus récente)
  • Veuillez noter que si vous souhaitez utiliser la fonctionnalité Recueillir le consentement pour l’envoi de SMS sur la page de commande, vous devez utiliser PrestaShop 1.7.6 ou une version plus récente.
• PrestaShop Edition 8.0 et versions ultérieures.
• PrestaShop Project 8.0 et versions ultérieures.

Si vous utilisez une version de PrestaShop antérieure à 1.7.0 et que vous souhaitez effectuer une mise à niveau afin d’utiliser un module Klaviyo, consultez le guide de PrestaShop sur la mise à niveau de votre boutique.

Veuillez consulter les informations suivantes avant l’intégration :

• Si vous utilisez PrestaShop Edition, le module PrestaShop Automation with Klaviyo est pré-installé. Si vous utilisez une autre version de PrestaShop, vous devrez l’installer (voir la section suivante). 
• PrestaShop Automation with Klaviyo est prévu pour s’intégrer à la fonctionnalité de back-office de PrestaShop, comme PrestaShop Account. Veuillez noter que pour les boutiques qui exécutent PrestaShop Project 8.0, vous devez installer le module PS_MBO afin d’utiliser le module Klaviyo.
• Vous ne souhaitez pas intégrer les fonctionnalités de back-office à votre boutique PrestaShop open source ? Vous pouvez utiliser notre module PrestaShop Partners à la place, qui contient le même ensemble de fonctionnalités que PrestaShop Automation with Klaviyo et ne nécessite pas PS_MBO.

Vous souhaitez mettre à jour votre module Klaviyo actuel ? Pour en savoir plus, reportez-vous à la fin de cet article. 

Vidéo de démonstration

Installation du module dans PrestaShop

1. Si vous utilisez PrestaShop Edition, le module PrestaShop Automation with Klaviyo est pré-installé. Procédez comme suit :
1. Connectez-vous à votre boutique PrestaShop.
2. Dans le menu de gauche, sous Configure (Configurer), sélectionnez Klaviyo.
3. Passez à la section suivante de cet article pour configurer le module.
2. Si vous n’utilisez pas PrestaShop Edition, accédez à la page du module PrestaShop Automation with Klaviyo sur la marketplace de PrestaShop et passez à l’étape suivante.
   
3. Sur la page du module, cliquez sur Download. Validez vos coordonnées si nécessaire, puis sélectionnez la version de PrestaShop que vous utilisez et téléchargez le fichier zip. Vous n’avez pas besoin d’extraire le fichier zip.
   
4. Connectez-vous à votre boutique PrestaShop et allez dans Modules > Module Manager. Cliquez sur Upload a module, puis faites glisser le fichier zip vers le gestionnaire de modules.
   
5. Une fois l’installation terminée, un message de réussite s’affiche sur le module. Ensuite, cliquez sur Configure (Configurer) et passez à la section suivante.

Configuration du module dans PrestaShop

1. Vous devez récupérer votre clé d’API publique Klaviyo (également connue comme l’identifiant de votre site) et générer une clé d’API privée Klaviyo à utiliser dans PrestaShop. 
   • Connectez-vous à Klaviyo, puis cliquez sur le nom de votre organisation en bas à gauche.
   • Sélectionnez Settings > API keys.
   • Copiez votre clé d’API publique sur la page et collez-la dans le paramètre correspondant dans PrestaShop.
   • Revenez à Klaviyo, cliquez sur Create Private API Key, donnez-lui un nom, sélectionnez Full Access Key, puis cliquez sur Create.
   • Copiez en toute sécurité la clé d’API privée que vous venez de créer et collez-la dans le paramètre correspondant dans PrestaShop.
2. Activez l’option Send real-time order events to Klaviyo si vous souhaitez que les événements de commande transactionnels soient synchronisés en temps réel. Ces événements peuvent être utilisés pour envoyer des messages transactionnels et apparaîtront comme un deuxième ensemble d’événements dits transactionnels (par exemple, vous verrez dans Klaviyo un indicateur intitulé Placed Order Transactional qui se synchronisera en temps réel, en plus d’un indicateur intitulé Placed Order qui se synchronisera toutes les 30 minutes).
   
3. Activez l’option Turn off PrestaShop-generated transactional order emails si vous le souhaitez. Nous vous recommandons de laisser ce paramètre désactivé jusqu’à ce que les e-mails transactionnels soient prêts à être envoyés dans Klaviyo. Vous pouvez revenir à cette page à tout moment et basculer sur le paramètre pour désactiver l’envoi de PrestaShop. Veuillez noter que l’activation de ce paramètre bloque les e-mails transactionnels associés aux événements Placed Order, Fulfilled Order, Canceled Order et Refunded Order, ainsi que les e-mails de rappel de paiement. 
4. Activez l’option Synchroniser les abonnés par e-mail de PrestaShop avec Klaviyo si vous souhaitez synchroniser les abonnés aux e-mails recueillis sur la page de commande ou par le biais d’un formulaire d’inscription.
5. Activez l’option Sync PrestaShop SMS subscribers to Klaviyo si vous souhaitez permettre aux utilisateurs d’opter pour le marketing par SMS lors du paiement.
   
   Vous devez configurer les SMS dans Klaviyo avant de pouvoir synchroniser les abonnés aux SMS.
   
6. Cliquez sur Save pour continuer.
7. Si vous avez activé le paramètre de synchronisation des abonnés aux e-mails, vous devrez sélectionner une liste à utiliser pour l’ajout d’abonnés dans votre compte Klaviyo. Tous les nouveaux abonnés seront ajoutés à la liste que vous avez choisie. Nous vous recommandons d’utiliser la liste d’adresses e-mail.
   
8. Si vous souhaitez abonner des profils à une liste Klaviyo en utilisant le module Newsletter Subscription de PrestaShop, assurez-vous que le module a bien été activé et que vous disposez de la version 2.6.0 ou d’une version plus récente.
9. Si vous avez activé le paramètre de synchronisation des abonnés aux SMS :
1. Vous devrez sélectionner une liste à utiliser pour l’ajout d’abonnés aux SMS dans votre compte Klaviyo. Tous les nouveaux abonnés seront ajoutés à la liste que vous avez choisie. Nous recommandons d’utiliser une liste distincte pour les abonnés aux e-mails et aux SMS.
2. Choisissez When do customers subscribe? L’inscription peut être effectuée après qu’ils aient commencé à procéder au paiement ou à passer une commande.
3. Ajoutez un libellé de consentement à votre case à cocher pour le marketing. Utilisez un libellé clair pour informer les utilisateurs sur ce à quoi ils consentent (par exemple, « S’abonner au marketing par SMS »).
4. Ajoutez un texte de clause de divulgation. Vous devez inclure une clause de divulgation pour être en conformité. Pensez à ajouter les conditions de votre programme de marketing par SMS à vos conditions d’utilisation et à votre politique de confidentialité. Veuillez noter que vous devez utiliser le langage HTML dans la boîte de divulgation. Voici un exemple de clause de divulgation :
   En cochant cette case et en saisissant votre numéro de téléphone ci-dessus, vous acceptez de recevoir des SMS à caractère commercial (tels que des promotions et des rappels de panier abandonné) de la part de [nom de l’entreprise] au numéro indiqué. Des frais de messagerie et de transmission de données sont susceptibles d’être appliqués. La fréquence des messages varie. Vous pouvez vous désabonner à tout moment en répondant STOP ou en cliquant sur le lien de désabonnement (là où il est disponible). <a href="link">Privacy Policy</a> & <a href="link">Terms</a>.
5. Vous pouvez utiliser le bouton bascule de langue à droite de la boîte de divulgation afin d’ajouter un texte de clause de divulgation spécifique pour chaque langue de l’interface de votre boutique. 
   
10. Cliquez sur Save pour continuer.
11. Ensuite, complétez le formulaire de mappage des statuts de commande en acceptant les valeurs par défaut ou en sélectionnant les valeurs de votre choix. Les statuts de commande correspondent aux événements de commande qui sont enregistrés dans Klaviyo. Vous pouvez sélectionner plusieurs valeurs pour chaque événement de commande. Utilisez Cmd ou Ctrl+Clic pour sélectionner plusieurs valeurs. La même valeur ne peut pas être sélectionnée dans plusieurs événements de commande. La sélection d’une valeur en double entraîne un message d’erreur et elle ne peut pas être enregistrée. Les événements transactionnels et non transactionnels respecteront le mappage des commandes que vous avez sélectionné.
12. Une fois la configuration des statuts de commande terminée, cliquez sur Save.
13. Une section Coupons permet de générer des codes de réduction. Dans le champ Cart Rule Limit, sélectionnez One cart rule per prefix ou One cart rule per order pour limiter l’utilisation des codes de réduction par les clients. Par défaut, ce paramètre est défini sur One cart rule per prefix, ce qui empêche les clients d’ajouter plus d’un code avec le même préfixe au moment du paiement.
    
14. Si vous souhaitez également générer des codes de réduction en utilisant le champ Quantity to generate, vous pouvez revenir à cette page ultérieurement. Pour plus d’informations, découvrez comment créer des codes de réduction statiques pour PrestaShop.
15. Ensuite, sélectionnez Advanced Parameters dans la section Configure du volet de gauche. Sélectionnez Webservice. Copiez la clé de service web Klaviyo qui a été générée pour vous et passez à la section suivante. 
    • Cette clé sera utilisée lors de l’activation de l’intégration dans Klaviyo à l’étape suivante. Nous vous recommandons de vous assurer que la clé du service web possède les autorisations Klaviyo nécessaires en sélectionnant l’icône crayon à côté de la clé du service web Klaviyo. Faites défiler la liste de toutes les autorisations et localisez Klaviyo. Assurez-vous que toutes les cases des autorisations sont cochées. Sélectionnez Save pour appliquer les modifications.

Activation de l’intégration dans Klaviyo

1. Ensuite, activez l’intégration PrestaShop dans votre compte Klaviyo. Dans Klaviyo, sélectionnez le nom de votre organisation dans le coin inférieur gauche, puis sélectionnez Integrations. 
2. Cliquez sur Ajouter des intégrations, recherchez PrestaShop et sélectionnez la carte. Ensuite, cliquez sur Installer.
3. Sur la page suivante, cliquez sur Connect to PrestaShop.
   
4. Sur la page suivante, saisissez l’URL de votre boutique PrestaShop dans le champ Shop URL. L’URL de votre boutique se trouve dans votre compte PrestaShop sous Shop Parameters (Paramètres de la boutique) > Traffic & SEO (Trafic et SEO) > Shop URLs (URL de la boutique). Vous pouvez également cliquer sur View my shop (Voir ma boutique) pour accéder rapidement à votre site PrestaShop depuis n’importe quelle page de votre compte afin de récupérer l’URL de votre boutique.
   
5. Collez dans le champ Webservice key la clé de service web que vous avez copiée dans PrestaShop.
6. Si vous souhaitez convertir toutes les devises utilisées dans vos boutiques en une même devise dans Klaviyo, cochez Convert all currencies to one standard currency et sélectionnez un code de devise mondial dans la liste déroulante.
   • Cela ne change pas la devise de votre compte Klaviyo. Pour modifier la devise utilisée dans votre compte, veuillez consulter notre guide sur la modification de la devise de votre compte.
7. Pour obtenir une liste de vos boutiques PrestaShop disponibles, sélectionnez Retrieve list of shops. Ensuite, cochez les boutiques que vous souhaitez intégrer. Vous devez sélectionner au moins une boutique pour continuer.
8. Cliquez sur Connect to PrestaShop. Un message de confirmation s’affiche pour vous indiquer que vos comptes ont été connectés.
   

Données PrestaShop dans Klaviyo

Les trois types d’événements synchronisés de PrestaShop à Klaviyo : 

• Les événements de commande sont synchronisés toutes les 30 minutes (par exemple : Placed Order).
• Les événements de commande transactionnelle sont synchronisés en temps réel, si vous choisissez de les activer (par exemple : Placed Order Transactional).
• Les événements sur site de Klaviyo (par exemple : Active on Site, Viewed Product et Added to Cart). 

En outre, les données sur les clients sont synchronisées entre les profils Klaviyo et PrestaShop, y compris l’adresse e-mail, le numéro de téléphone, le consentement pour l’envoi d’e-mails et de SMS, le cas échéant. 

Vous pouvez afficher tous ces événements dans Klaviyo en accédant à Analytics > Metrics. Filtrez sur PrestaShop pour voir les événements de commande et de commande transactionnelle (avec une icône PrestaShop) ou filtrez sur API pour voir les événements sur site de Klaviyo (avec une icône en forme d’engrenage). Pour obtenir une liste complète des indicateurs synchronisés depuis PrestaShop, consultez notre documentation sur les données PrestaShop.

Lorsque vous intégrez PrestaShop pour la première fois, Klaviyo synchronise vos données des 90 derniers jours afin que vous puissiez commencer immédiatement à développer l’engagement de vos clients les plus 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.

Nous vous recommandons d’allouer au moins 1 024 Mo de mémoire PHP pendant la synchronisation de l’historique. Cela permet à la synchronisation de se terminer en temps voulu. Les besoins en mémoire peuvent être réduits une fois la synchronisation historique terminée, si vous le souhaitez.

Une fois la synchronisation terminée, vous verrez dans l’onglet Integrations que l’intégration de PrestaShop est terminée. Pour vérifier que toutes les données provenant de PrestaShop 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 PrestaShop. Pour vérifier ou mettre à jour le fuseau horaire de votre compte :

1. Cliquez sur le nom de votre organisation en bas à gauche.
2. Sélectionnez Settings.
3. Sélectionnez l’onglet Organization. 

Envoi d’e-mails transactionnels

Vous souhaitez envoyer des e-mails transactionnels en utilisant les données de commande en temps réel synchronisées à partir de PrestaShop ? Pour cela, vous devez créer des flux de A à Z dans Klaviyo. Lisez notre article sur l’utilisation des flux pour l’envoi d’e-mails transactionnels pour en savoir plus sur leur fonctionnement dans Klaviyo. Vous devez configurer ces flux, puis contacter l’équipe d’assistance de Klaviyo pour les faire approuver. Ensuite, vous pouvez désactiver l’envoi d’e-mails transactionnels dans PrestaShop et activer vos flux transactionnels dans Klaviyo. 

Mise à jour de votre module

Utilisez-vous une version de module PrestaShop inférieure à 1.4.1 ? Nous vous recommandons de passer immédiatement à la version 1.4.1 ou à une version plus récente. Les anciennes versions du module utilisent les API v1 et v2 de Klaviyo, qui ont été retirées et ne fonctionnent plus comme prévu.

En outre, la mise à niveau vers la version 1.4.1 ou ultérieure vous permet de bénéficier de ces fonctionnalités, qui ont vu le jour dans la version 1.3.0 :

1. Affichez en toute simplicité le prix réel et la taxe sur la valeur ajoutée (TVA) incluse des produits dont vous faites la promotion dans vos e-mails. Veuillez noter que la mise à niveau de la version 1.2.10 vers la version 1.2.10 ou supérieure peut entraîner des inexactitudes dans les modèles d’e-mails en raison de ce changement. Lisez notre article pour savoir comment y remédier.
2. Envoyez des e-mails transactionnels à vos clients grâce à une synchronisation des événements en temps réel.
3. Générez et importez rapidement des codes de réduction en masse dans Klaviyo.

Pour mettre à jour votre module à la version la plus récente :

1. Connectez-vous à votre compte administrateur PrestaShop.
2. Accédez à Modules > Module Manager (Gestionnaire de modules).
3. Descendez jusqu’au module Klaviyo et sélectionnez Upgrade (Mettre à niveau). 
   

Pour connaître les modifications apportées à chaque version, accédez au module Klaviyo sur la marketplace des compléments, descendez jusqu’à What’s New (Nouveautés), puis cliquez sur Show changelog history (Afficher l’historique des changements). 

Vous souhaitez obtenir une version corrigée ?

Si vous utilisez la version 1.2.18 ou 1.2.9 du module PrestaShop de Klaviyo et que vous souhaitez utiliser la version corrigée correspondante (au lieu du module le plus récent de Klaviyo), des correctifs sont disponibles. Pour mettre à jour ces modules :

1. Connectez-vous à votre compte administrateur PrestaShop. 
2. Accédez à Modules > Module Manager (Gestionnaire de modules).
3. Trouvez le module Klaviyo, cliquez sur le menu déroulant à côté de Upgrade (Mettre à niveau), puis sélectionnez Uninstall (Désinstaller).
   
4. Utilisez ces liens pour télécharger votre version corrigée :
   • 1.2.18+v3api.zip 
   • 1.2.9+v3api.zip
5. Chargez le module dans le gestionnaire de modules de PrestaShop, en commençant par l’étape 4 de la section ci-dessus. 
6. Réintégrez PrestaShop avec Klaviyo en continuant la procédure. 

Résultats 

Vous avez maintenant intégré PrestaShop avec Klaviyo et vous pouvez commencer à utiliser Klaviyo pour vos propres besoins marketing. 

Ressources supplémentaires

• Documentation sur les données PrestaShop

• Comment activer les prix avec TVA pour PrestaShop
• Comment créer des codes de réduction pour PrestaShop