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 multilingue: collecter les données d’interaction des contacts en distinguant par langues.
  • Inclure la catégorie racine dans la catégorie de la page: inclure la catégorie « Racine » dans les catégories de la balise cn_page_category.
  • Vérifier que le hook top n’est pas rendu plus d’une fois: activer/désactiver le calcul du pourcentage de réduction basé sur les prix.
  • Activer les logs de débogage: activer/désactiver les logs.
  • Synchroniser les informations du contact dans Connectif lors de la mise à jour du client depuis le backoffice de PrestaShop: synchroniser dans le contact Connectif, en plus des champs de base et natifs du module, les champs activés dans l’onglet « Champs du formulaire d’inscription » de la section « Champs du contact ». Si l’option multilingue est activée, la synchronisation sera effectuée dans chaque boutique Connectif où l’email du contact existe.

 

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

Guide pour intégrer 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 combinaisons de produit dans le panier et les achats: déterminer si, lorsque Connectif reçoit les informations du panier, il collectera le produit par défaut ou la combinaison spécifique (taille, couleur, etc.).
  • Utiliser le SKU comme identifiant du produit: utiliser le SKU de vos produits PrestaShop comme ID produit dans Connectif.
  • Inclure la catégorie racine sans avoir besoin de la sélectionner dans les paramètres du produit: envoyer à Connectif la catégorie racine dans les catégories de produit.

  • Inclure la catégorie uniquement si elle est active: envoyer à Connectif la catégorie du produit uniquement si elle est active dans PrestaShop.
  • Calculer le pourcentage de remise basé sur les prix: activer/désactiver le calcul automatique.
  • Inclure la taxe dans la remise: inclure la TVA dans les produits remisés.
  • Arrondir les prix: arrondir les prix des produits dans Connectif.
  • Disponibilité maximale en jours: définir la période, en jours avant la date de réapprovisionnement, pendant laquelle un produit sera disponible en pré-commande.
  

Si le nombre de jours restants jusqu’à la date de réapprovisionnement 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 pas dans les stratégies actives.

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

Guide pour intégrer avec Prestashop 2025 - 8-min.png

3.7. Envoi des achats

(Dans cette section, vous configurez l'envoi des achats à Connectif depuis le module PrestaShop).

23. Grâce à la section Envoi des achats, vous pouvez envoyer les achats réalisés dans votre boutique à Connectif, en spécifiant un intervalle de dates et les statuts à importer.

 

Pour apprendre à envoyer les achats depuis PrestaShop vers Connectif, consultez cet article.

Envoi des achats depuis PrestaShop - 3.png

 

ÉTAPE 4. Configuration dans les boutiques avec plusieurs langues

 

Vous n'aurez besoin de réaliser cette étape que si votre PrestaShop présente plusieurs langues et/ou devises.

 

Les e-commerces avec multi-langues nécessitent 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 langue, l'option “Activer multi-langue” doit avoir été activée au point précédent (17).

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

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

25. Dans une nouvelle fenêtre de navigateur, accédez à votre compte Connectif pour la langue correspondante et copiez les données d'identification (“Identifiant Client” et “Clé secrète”), comme indiqué au point 10.

26. Retournez à PrestaShop et collez les données d'identification (“Client ID” et “Secret KEY”).

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

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

29. Cliquez sur   Sauvegarder.

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 D'INCIDENTS

Trouvez des solutions rapides aux incidents les plus fréquents lors de l'intégration avec PrestaShop.

 

1. Quelles informations Connectif collecte-t-il via cette intégration ?

a. Informations collectées depuis les Contacts

Dans les intégrations avec PrestaShop, via le tag cn_client_info, certaines informations concernant les Contacts sont transférées par défaut :

  • email

  • _name

  • _surname

  • _birthdate

  • _newsletter_subscription_status

De plus, dans les paramètres du module Connectif dans PrestaShop, il existe une section permettant d'activer d'autres champs de contact. Ces champs seront ajoutés au tag cn_client_info avec le même identifiant que dans cette section. Pour que Connectif enregistre la valeur, il doit exister un champ personnalisé dans la boutique Connectif avec le même ID (voir l'étape 3.5).

b. Informations collectées depuis les Produits

Dans les intégrations avec PrestaShop, via le tag cn_product_visited et la synchronisation quotidienne du catalogue, certaines informations concernant les Produits sont collectées par défaut :

  • quantity

  • price url

  • product_id

  • name

  • description

  • image_url

  • unit_price

  • availability

  • brand

  • published_at

  • category

  • related_external_product_id

  • tag

c. Informations collectées depuis les Achats

Dans les intégrations avec PrestaShop, via le tag cn_purchase, certaines informations concernant les Achats sont collectées par défaut :

  • purchase_id

  • purchase_date

  • payment_method

  • cart_id

  • total_quantity

  • total_price

 

2. Aucune donnée sur les achats, les contacts et/ou les événements 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 des 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 nécessaires et sur Enregistrer pour les activer.

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

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

Intégration PrestaShop - 16.png

  • Assurez-vous que votre modèle ne modifie pas les pages de base de PrestaShop (comme, par exemple, Checkout) et exécute le hook displayTop comme suit :
    {hook h='displayTop'}
  

Vous pouvez consulter les informations officielles 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 du eCommerce.
 

En cas d'impossibilité d'exécuter le hook displayTop à cause d'incompatibilités avec d'autres modules, il est recommandé d'exécuter le hook displayConnectifTags sur toutes les pages et de vous assurer que le module est correctement accroché à ce hook.

 

4. 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, c'est-à-dire un lien pour récupérer les articles liés à ce panier, qui peut être utilisé dans des workflows et des contenus.

Pour obtenir l'URL de récupération de panier via un workflow, il faut le faire par le biais du nœud "Obtenir dernier panier" et "Panier abandonné", puis le mapper dans les variables du contenu à afficher ou envoyer.

  • Découvrez comment fonctionne cette URL dans les différents CMS et comment l'utiliser dans cet article

 

 

 


Continuez à apprendre !

Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de continuer avec les articles suivants :