Guide pour l'intégration avec PrestaShop

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

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

 
Temps d'implémentation : 10 min.
Difficulté : Faible.
Quand l'utiliser ? : Lors de l'ouverture de votre compte 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.

Guía para integrar con Prestashop 2025 - 15-min.png

 

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

Integración con PrestaShop - 2-min.png

 

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

 

ÉTAPE 2. Installation du module sur votre PrestaShop

5. Connectez-vous au backoffice de votre PrestaShop.

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

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

Guía para integrar con PrestaShop 2025 - 2-min.png

 

8. Dans la fenêtre pop-up, cliquez sur Sélectionner le fichier ou glissez-le dans le rectangle en pointillés. L'assistant commencera l'installation automatiquement.

Integraci_n_Prestasho_-_4__sin_figma_.png

 

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

Integraci_n_Prestasho_-_5__sin_figma_.png

 

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

 

ÉTAPE 3. Configuration du module dans PrestaShop

3.1. Configuration basique

(Dans cette section, vous allez indiquer les données d'identification de votre compte pour la synchroniser et commencer à collecter les données d'interaction des contacts sur le site en temps réel).

10. Retournez dans votre Boutique Connectif (section “Intégrations > PrestaShop”) et copiez les données d'identification de votre compte (Identifiant client et Clé secrète).
 

Integración con PrestaShop - 3-min.png

 

11. Revenez à l’onglet PrestaShop que vous avez laissé ouvert (configuration du module) et collez les données copiées dans “Client ID” et “Secret KEY”, respectivement.

12. Vérifiez que dans le champ “Enabled” l’option YES est sélectionnée.

13. Cliquez sur   Enregistrer.

Guía para integrar con PrestaShop - 1.png

 

3.2. Bannières

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

14. Aucune action n'est nécessaire dans cette section.

Guía para integrar con PrestaShop - 2.png

 

3.3. URLs publiques

(Dans cette section, les URLs d’abonnement/désabonnement à la newsletter ainsi que celle du Service Worker des notifications push sont automatiquement complétées).

15. Aucune action n'est nécessaire dans cette section.
 
Vous pouvez consulter ces URLs dans votre compte Connectif :

— Abonnements/désabonnements à la newsletter, dans les paramètres de l'intégration :

Integración con PrestaShop - 4-min.png

 

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

Integración con PrestaShop - 5-min.png

 

3.4. Champs du formulaire d'inscription

(Dans cette section, vous indiquez les propriétés du contact collectées dans PrestaShop que vous souhaitez synchroniser avec Connectif).

16. Dans la section Champs du contact, les champs firstname (prénom), “lastname” (nom) et birthday (date d'anniversaire) sont sélectionnés par défaut. Si vous souhaitez que Connectif synchronise d'autres options de cette section ou des Champs de l'adresse, cochez “Oui” sur les champs souhaités.

 

Pour enregistrer les données sélectionnées dans le profil de chaque contact, il sera nécessaire de créer un champ personnalisé pour chacun d'eux, avec un ID identique à 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 capte automatiquement les abonnements. Vous pouvez consulter plus d'informations à ce sujet ici.

Guía para integrar con PrestaShop - 3.png

 

3.5. Paramètres avancés

(Dans cette section, vous configurez des options avancées de l'intégration).

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

Paramètres généraux

  • Activer le multi-langue : collecter les données d'interaction des contacts en les différenciant par langue.

  • 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 ne se rend pas 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 basiques et natifs du module, les champs activés dans le module dans l'onglet Champs du formulaire d'inscription dans la section Champs du contact. Si l'option multi-langue est activée, la synchronisation se fera dans chaque boutique Connectif où l'email du contact existe.

 

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

Guía para integrar con PrestaShop - 4.png

 

Événements

  • Événements d'achat : enregistrer tous les achats.

  • É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 événements de recherche sur l'eCommerce.

Guía para integrar con PrestaShop - 6.png

 

Paramètres produit

  • Utiliser la description longue : collecter la description longue des produits.

  • Utiliser les combinaisons de produit dans le panier et les achats : déterminer si, lorsqu'une information produit est reçue par Connectif depuis le panier, le produit par défaut ou la combinaison spécifique (taille, couleur, etc.) sera collectée.

  • Utiliser le SKU comme identifiant du produit : utiliser le SKU de vos produits PrestaShop comme ID produit dans Connectif.

  • Inclut la catégorie racine sans besoin de la sélectionner dans la configuration du produit : envoyer à Connectif la catégorie racine dans les catégories du 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 réduction basé sur les prix : activer/désactiver le calcul automatique des remises.

  • Inclure la taxe dans la réduction : inclure la TVA dans les produits en promotion.

  • Arrondir les prix : arrondir les prix des produits dans Connectif.

  • Disponibilité maximale en jours : définit la période en jours avant la date de réapprovisionnement durant laquelle un produit sera disponible pour un 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, donc Connectif ne le recommandera 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).

Guía para integrar con PrestaShop - 7.png

 

3.6. Envoi des achats

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

18. Via la section Envoi des Achats , il est possible d'envoyer à Connectif les achats réalisés dans votre boutique, en indiquant une plage de dates et les états à importer.

 

Pour apprendre comment effectuer l'envoi des achats de PrestaShop vers Connectif, consultez cet article.

Guía para integrar con PrestaShop - 8.png

 

ÉTAPE 4. Configuration pour les boutiques multilingues

 

Cette étape doit être réalisée uniquement si votre PrestaShop utilise 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 langue, l'option “Activer le multi-langue” doit avoir été activée au point précédent (17).

19. Dans l'onglet Configuration basique, cliquez sur .

Guía para integrar con PrestaShop - 9.png

 

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

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

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

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

24. Cliquez sur   Enregistrer.

Guía para integrar con PrestaShop - 10.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 PROBLÈMES

Trouvez des solutions rapides aux problèmes les plus courants lors d'une intégration avec PrestaShop.

 

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

a. Informations collectées sur les Contacts

Dans les intégrations avec PrestaShop, via la balise cn_client_info, certaines informations sur 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 du contact. Ces champs seront ajoutés à la balise cn_client_info avec le même identifiant que celui indiqué dans cette section. Pour que Connectif enregistre la valeur, il doit exister dans la Boutique Connectif un champ personnalisé avec le même ID (voir étape 3.5).

b. Informations collectées sur les Produits

Dans les intégrations avec PrestaShop, via la balise cn_product_visited et la synchronisation quotidienne du catalogue, certaines informations sur 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 sur les Achats

Dans les intégrations avec PrestaShop, via la balise cn_purchase, certaines informations sur les Achats sont collectées par défaut :

  • purchase_id
  • purchase_date
  • payment_method
  • cart_id
  • total_quantity
  • total_price

 

2. Les données d'achats, contacts et/ou événements de panier ne sont pas enregistrées

  • 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 capter les états du panier.

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

Guía para integrar con Prestashop 2025 - 11-min.png

 

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

Integraci_n_PrestaShop_-_16.png

 

  • Assurez-vous que votre thème 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 l'information 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 de commande de l'eCommerce.

 

Si vous ne pouvez pas 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 attaché à ce hook.

 

3. Les états d'abonnement à la newsletter ne sont pas synchronisés

  • Vérifiez que les URLs auto-complétées dans l'intégration PrestaShop de votre compte Connectif correspondent aux URLs du module installé dans votre PrestaShop dans “Configuration > URLs publiques
    Integración con PrestaShop - 4-min.png


    Guía para integrar con PrestaShop - 11.png
     

  • Vérifiez que ces URLs existent en les copiant et collant dans la barre d'adresse de votre navigateur. Si une erreur 404 apparaît, elle devra être corrigée dans l'eCommerce lui-même.

 

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

(Dans cette section, il est expliqué 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 contenus.

Pour obtenir l'URL de récupération de panier via un workflow, cela doit être fait via le nœud "Obtenir dernier panier" et "Au moment d'abandon du panier", puis mappé dans les variables du contenu à afficher ou envoyer.

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

 

 

 


Continuez à apprendre !

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