Guide pour intégrer avec PrestaShop

Si votre eCommerce est développé sur PrestaShop, vous pourrez le synchroniser avec votre compte Connectif en quelques minutes et commencer à collecter des données d'interaction de vos contacts sur votre site web.

Dans cet article, vous apprendrez comment intégrer votre compte Connectif avec votre PrestaShop.

 
Temps de mise en œuvre : 10 min.
Difficulté : Faible.
Quand l'utiliser ? : Lors de l’ouverture de votre compte sur Connectif.

 

ÉTAPE 1. Téléchargement du module

1. Connectez-vous à votre compte Connectif.

2. Accédez à Paramètres de la boutique dans le menu latéral gauche.

3. Dans la section Plateformes e-commerce, recherchez PrestaShop et cliquez sur  Modifier.

Guide d'intégration avec Prestashop 2025 - 15-min.png

4. Dans la section Configuration, cliquez sur  Télécharger zip pour télécharger le fichier “connectif.zip” sur votre ordinateur.

Intégration avec PrestaShop - 2-min.png

 

Ne fermez pas cette fenêtre ! Vous en aurez besoin plus tard pour extraire les informations d'identification de votre compte.

 

ÉTAPE 2. Installation du module sur votre PrestaShop

5. Connectez-vous à l'administration de votre PrestaShop.

6. Accédez à “Modules > Modules et Services”.

7. En haut à droite, cliquez sur  Téléverser un module.

Guide d'intégration avec PrestaShop 2025 - 2-min.png

8. Dans la fenêtre contextuelle, cliquez sur Sélectionner le fichier ou faites-le glisser dans la zone encadrée en pointillés. L’assistant commencera l’installation automatiquement.

Integration_Prestashop_-_4__sans_figma_.png

9. Une fois le module installé, cliquez sur Configurer.

Integration_Prestashop_-_5__sans_figma_.png

 

Il est également possible d'accéder ultérieurement à la configuration via “Modules > Modules et Services > Connectif” en cliquant sur Configurer.

 

ÉTAPE 3. Configuration du module dans PrestaShop

3.1. Liaison du compte PrestaShop avec le module Connectif

(Cette section explique comment lier votre compte PrestaShop avec le module Connectif, une étape nécessaire pour effectuer l'intégration).

10. Dans la section Configuration de base, cliquez sur Gérer les boutiques liées.

Guide d'intégration avec Prestashop 2025 - 13-min.png

11. Dans la fenêtre contextuelle, connectez-vous à votre compte PrestaShop.

12. Acceptez les autorisations pour lier votre compte PrestaShop avec Connectif.

13. Une fois les comptes liés, un message de confirmation apparaîtra sur l’écran de configuration du module.

Guide d'intégration avec Prestashop 2025 - 14-min.png

 

3.2. Configuration de base

(Cette section indique les informations d'identification de votre compte afin de le synchroniser et de commencer à collecter les données d'interaction des contacts en temps réel sur le site web).

14. Retournez sur votre Boutique Connectif (section “Intégrations > PrestaShop”) et copiez les informations d’identification de votre compte (Identifiant client et Clé secrète).

Intégration avec PrestaShop - 3-min.png

15. Retournez sur l'onglet PrestaShop que vous avez laissé ouvert (configuration du module) et collez les informations copiées dans les champs “Client ID” et “Secret KEY”, respectivement.

16. Vérifiez que dans le champ “Enabled”, l'option YES est sélectionnée.

17. (Optionnel). Si vous avez un code de parrainage, indiquez-le dans cette section, dans le champ Code de parrainage.

18. Cliquez sur   Enregistrer.

Guide d'intégration avec Prestashop 2025 - 3-min.png

 

3.3. Bannières

 Les bannières sont une fonction obsolète dans Connectif. Vous pouvez consulter plus d’informations à ce sujet  ici.

19. Aucune action n'est requise dans cette section.

Guide d'intégration avec Prestashop 2025 - 4-min.png

 

3.4. URLs publiques

(Cette section renseigne automatiquement les URLs d’abonnement/désabonnement à la newsletter, ainsi que celle du Service Worker pour les notifications push).

 20. Aucune action n'est requise dans cette section.
 
Vous pouvez consulter ces URLs dans votre compte Connectif :

— Abonnement/désabonnement à la newsletter, dans les paramètres d’intégration :

Intégration avec PrestaShop - 4-min.png

Service Worker des notifications push, dans les Paramètres de la boutique, “Canaux > Notifications Push”.

Intégration avec PrestaShop - 5-min.png

 

3.5 Champs du formulaire d'inscription

(Cette section indique les propriétés du contact collectées dans PrestaShop et devant être synchronisées avec Connectif).

21. Dans la section Champs du contact, les champs sélectionnés par défaut sont firstname (prénom), “lastname” (nom de famille) et birthday (date d'anniversaire). Si vous souhaitez que Connectif synchronise d'autres options dans cette section ou dans Champs de l'adresse, activez l’option “Oui” pour les champs désirés.

 

Pour enregistrer les données sélectionnées dans le profil de chaque contact, il est nécessaire de créer un champ personnalisé avec le même identifiant que celui indiqué dans la liste (par exemple, id_gender). Cette étape doit être réalisée pour tous les champs optionnels activés, à l'exception du champ “Newsletter”, qui capture automatiquement les abonnements. Vous pouvez consulter plus d'informations à ce sujet ici.

Guide d'intégration avec Prestashop 2025 - 5-min.png

 

3.6. Paramètres avancés

(Cette section permet de configurer des options avancées de l'intégration).

22. Pour une intégration basique, aucune action n'est requise à cette étape. Si vous souhaitez effectuer une configuration plus avancée, activez ou désactivez les options que vous souhaitez synchroniser avec Connectif :

Paramètres généraux

  • Activer le multi-langage : permet de collecter les données d'interaction des contacts en distinguant les langues.
  • Inclure la catégorie racine dans la catégorie de page : permet d’afficher la catégorie “Root” dans les catégories de produits.
  • Vérifier que le hook top ne se rend pas plus d'une fois : active/désactive le calcul du pourcentage de réduction basé sur les prix.
  • Activer les logs de débogage : active/désactive les journaux.
  • Synchroniser les informations du contact dans Connectif lors de la mise à jour du client depuis le back-office de PrestaShop : synchronise, en plus des champs basiques et natifs du module, les champs activés dans l’onglet Champs du formulaire d'inscription, section Champs du contact. Si l'option multi-langage est activée, la synchronisation s'effectuera sur chaque boutique Connectif où l'adresse e-mail du contact existe.

 

Ces modifications ne sont pas envoyées à Connectif si une importation de clients est effectuée dans PrestaShop ni si un client est supprimé depuis PrestaShop.

Guide d'intégration avec Prestashop 2025 - 6-min.png

Événements

  • Événements d'achat : enregistrer toutes les commandes.

  • Événements d'inscription : enregistrer les activités d'inscription.

  • Événements de connexion : enregistrer les connexions des contacts.

  • Événements d'abonnement à la newsletter : enregistrer les abonnements à la newsletter.

  • État du panier : enregistrer les événements liés à l'état du panier.

  • Événements de recherche : enregistrer les recherches effectuées sur l'eCommerce.

Guide d'intégration avec Prestashop 2025 - 7-min.png

Paramètres des produits

  • Utiliser la description longue : collecter la description longue des produits.
  • Utiliser les déclinaisons de produit dans le panier et les achats : déterminer si, lors de la réception des informations des produits du panier par Connectif, il collectera le produit par défaut ou la déclinaison spécifique (taille, couleur, etc.).
  • Utiliser le SKU comme identifiant du produit : utiliser le SKU de vos produits dans PrestaShop comme identifiant des produits dans Connectif.
  • Calculer le pourcentage de réduction basé sur les prix : activer/désactiver le calcul automatique des réductions.
  • Inclure la taxe dans la réduction : inclure la TVA dans les produits remisés.
  • Arrondir les prix : arrondir les prix des produits dans Connectif.
  • Disponibilité maximale en jours : définit la période, en jours avant sa date de réapprovisionnement, pendant laquelle un produit sera disponible à l’achat anticipé.
  

Si le nombre de jours restants avant la date d’entrée d’un produit est supérieur à la disponibilité maximale en jours, l’article sera considéré comme en rupture de stock, et Connectif ne le recommandera donc pas dans les stratégies actives.

  • Sélectionner la taille de l’image du produit : indiquer le type d’image des produits à synchroniser (il est recommandé de sélectionner la même que celle utilisée dans la fiche produit de PrestaShop).

Guide d'intégration avec Prestashop 2025 - 8-min.png

 

ÉTAPE 4. Configuration pour les boutiques multilingues

 

Cette étape est uniquement nécessaire si votre PrestaShop propose plusieurs langues et/ou devises.

 

Les eCommerces multilingues nécessitent l’ouverture de un compte individuel pour chaque langue et devise. Pour plus d’informations, contactez accountmanager@connectif.es.

Pour enregistrer les données différenciées par langues, l’option “Activer le multi-langage” doit avoir été activée à l’étape précédente (17).

23. Dans l'onglet Configuration de base, cliquez sur  .

Guide d'intégration avec Prestashop 2025 - 9-min.png

24. Dans un nouvel onglet du navigateur, accédez à votre compte Connectif pour la langue correspondante et copiez les informations d'identification (“Identifiant client” et “Clé secrète”), comme indiqué à l'étape 10.

25. Retournez sur PrestaShop et collez les informations d’identification (“Client ID” et “Secret KEY”).

26. Sélectionnez la langue et la devise que vous souhaitez synchroniser avec ce compte Connectif.

27. Dans le champ “Enabled”, cliquez sur YES.

28. Cliquez sur   Enregistrer.

Guide d'intégration avec Prestashop 2025 - 10-min.png

 

 

 Succès !
L'intégration de votre compte Connectif avec votre PrestaShop est maintenant terminée.

 

Pour vérifier que l'intégration a été réalisée correctement et que les données d'interaction sont bien collectées, cliquez ici.

 


RÉSOLUTION DES INCIDENTS

Trouvez des solutions rapides aux incidents les plus courants lors de l’intégration avec PrestaShop.

1. Aucune donnée d'achat, de contact et/ou d'événement de panier n'est enregistrée

  • Dans Paramètres avancés, vérifiez que les options suivantes sont activées :
      • Événements d'achat”, pour enregistrer les données d’achats.
      • Événements d'inscription”, pour collecter les données des contacts.
      • Événements du panier”, pour capturer les états du panier.

S'ils sont désactivés, cliquez sur Yes dans les champs concernés et sur Enregistrer pour les activer.

Guide d'intégration avec Prestashop 2025 - 11-min.png

  • Vérifiez que le module Connectif est bien attaché au hook displayTop dans “Design > Positions” de PrestaShop.

Intégration_PrestaShop_-_16.png

  • Assurez-vous que votre template ne modifie pas les pages de base de PrestaShop (comme par exemple la page de Checkout) et exécute le hook displayTop de la manière suivante :
    {hook h='displayTop'}
  

Vous pouvez consulter la documentation officielle de PrestaShop en cliquant ici.

  • Configurez votre plateforme de paiement pour que, après une transaction, le contact soit automatiquement redirigé vers la page de Confirmation d’achat de l’eCommerce.
 

Si vous ne pouvez pas exécuter le hook displayTop en raison d’incompatibilités avec d’autres modules, il est recommandé d’exécuter le hook displayConnectifTags sur toutes les pages et de s’assurer que le module est correctement attaché à ce hook.

 

2. Les statuts d'abonnement à la newsletter ne se synchronisent pas

  • Vérifiez que les URL complétées automatiquement dans l’intégration avec PrestaShop de votre compte Connectif correspondent aux URL du module installé dans votre PrestaShop dans “Configuration > URLs publiques
    Intégration avec PrestaShop - 4-min.png


    Guide d'intégration avec Prestashop 2025 - 12-min.png

  • Vérifiez que les URL existent en les copiant et en les collant dans la barre d’adresse de votre navigateur. Si une erreur 404 s'affiche, la correction devra être effectuée directement depuis l’eCommerce.

 

3. Comment récupérer les paniers abandonnés avec l’URL de récupération de panier

(Cette section explique comment fonctionne l’URL de récupération de panier pour obtenir les articles associés à un panier spécifique).

Grâce à l’intégration avec PrestaShop, une URL de récupération de panier est envoyée à Connectif. Il s'agit d’un lien permettant de récupérer les articles liés à ce panier et qui peut être utilisé dans les workflows et les contenus.

Pour obtenir l’URL de récupération de panier via un workflow, il faut utiliser les nœuds "Obtenir le dernier panier" et "À l’abandon de panier", puis mapper cette information dans les variables du contenu à afficher ou envoyer.

  • Découvrez comment fonctionne cette URL sur les différentes plateformes CMS et comment l’utiliser dans cet article

 

 

 


Continuez votre apprentissage !

Pour tirer pleinement parti de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 1 sur 1