Guide d’intégration avec Magento 2

Si votre eCommerce est développé avec Magento, vous pourrez facilement l’intégrer à Connectif et commencer à recueillir les données de vos clients afin de créer vos campagnes.

Dans cet article, vous apprendrez comment installer et configurer le module Connectif pour Magento 2.

ÉTAPE 1. Téléchargement et installation du module Magento 2

Selon la version de Magento utilisée par votre eCommerce, vous devrez suivre différentes étapes :

• Si vous disposez d’une version antérieure à Magento 2.2, consultez la section A de cette étape.
• Si vous disposez d’une version ultérieure à Magento 2.2, consultez la section B de cette étape.
• Si vous utilisez Magento + Hyvä, consultez la section correspondant à votre version ainsi que le point 6 de la foire aux questions.

A. Versions antérieures à Magento 2.2

A.1. Téléchargement du module

1. Accédez à 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 Magento et cliquez sur Modifier.

4. Dans la section Configuration, cliquez sur  Télécharger le module Magento 2 pour télécharger le fichier « connectif.zip » sur votre ordinateur.

A.2. Copie du dossier Connectif dans l’installation de Magento

5. Copiez le dossier "Connectif" et tout son contenu dans le dossier "/app/code/", situé à la racine de l’installation de Magento 2.

A.3. Installation du module

6. Accédez au panneau d’administration de Magento 2 et rendez-vous dans la section « System > Web Setup Wizard ».

7. Dans Module Manager, recherchez le module Connectif_Integration et sélectionnez Activate.

8. Suivez les étapes indiquées lors de l’installation du module Connectif et cliquez sur Suivant :

• Readiness Check : cette étape permet d’effectuer des vérifications concernant la version de PHP, les crons, les dépendances et les extensions.

• Backup : cette étape permet de réaliser une sauvegarde de l’eCommerce avant l’installation du module. 

• Enable module : cette étape permet d’activer le module. 

B. Versions ultérieures à Magento 2.2

B.1. Téléchargement du module

1. Accédez à 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 Magento et cliquez sur Modifier.

12. Dans la section Configuration, cliquez sur  Télécharger le module Magento 2 pour télécharger le fichier « connectif.zip » sur votre ordinateur.

B.2. Copie du dossier Connectif dans l’installation de Magento

13. Connectez-vous à la boutique Magento 2.x via une connexion SSH.

14. Après une connexion SSH réussie, utilisez la ligne de commande (shell) pour vous rendre dans le répertoire racine de Magento où Magento 2 est installé.

15. Chargez le module (au format Zip ou tar.gz) dans le répertoire racine de l’installation de Magento 2.

16. Décompressez le fichier dans un répertoire temporaire.

17. Le module décompressé doit être copié dans « app/code/Connectif/ ». Créez ce dossier à l’aide de la commande suivante :

mkdir –p app/code/Connectif/

18. Copiez le contenu du dossier décompressé dans le dossier créé à l’étape précédente :

cp -R Connectif/* app/code/Connectif/

19. Exécutez la commande d’installation de Magento 2 depuis la racine : 

php bin/magento setup:upgrade

20. Compilez le module installé avec :

php bin/magento setup:upgrade

21. Videz le cache avec :

php bin/magento cache:flus

ÉTAPE 2. Activation du module

22. Rendez-vous dans « Stores > Configuration > " et recherchez la configuration de Connectif.

23. Dans Basic Configuration, sélectionnez l’option Yes dans le champ Activate afin de pouvoir renseigner les champs Client ID et Secret Key.

24. Accédez à votre compte Connectif et, dans la section « Intégrations > Magento" copiez l’ID client et la Clé secrète.

25. Retournez dans Magento 2 et collez-les dans les champs correspondants.

26. Cliquez sur "Save Config" pour enregistrer les modifications.

Foire aux questions

Vous avez des questions concernant le module Connectif dans Magento ? Vous trouverez ici des informations utiles :

1. À quoi sert chaque section du module Connectif dans Magento ?

Le module Connectif dans Magento se compose de différentes sections, chacune remplissant plusieurs fonctions :

• Basic Configuration (1) : cette section sert à configurer les aspects de base de votre compte Connectif dans Magento, détaillés dans cet article, afin de pouvoir commencer votre stratégie. 

• Customer (2) : cette section permet de configurer les informations des contacts Magento qui seront envoyées à Connectif.
  • Create newsletter subscribers if customer does not exist? : cette option permet de choisir si le contact doit être créé dans Magento comme abonné à la newsletter lorsqu’il n’existe pas dans Magento au moment où l’inscription ou la désinscription est notifiée depuis Connectif.
  • Configure Customer Fields : cette option permet d’associer les champs de contact disponibles dans le CMS (sélecteur de gauche, Customer Field) à l’ID du champ créé dans Connectif (sélecteur de droite, Connectif Field ID).

• Product (3) : cette section sert à configurer les aspects de base de vos produits Magento à synchroniser dans Connectif :
  • Use product SKU identifier? : cette option permet d’utiliser le SKU comme identifiant des produits dans le catalogue Connectif.
  • Product imagen ID : cette option permet de déterminer la taille de l’image que Connectif recueillera. 
  • Use full category path : cette option permet d’envoyer le chemin complet des catégories du produit, y compris les catégories parentes, même lorsqu’elles ne sont pas directement associées au produit.
  • Show product view with proper currency when Connectif verify the product : cette option concerne le cas où la synchronisation des produits est effectuée via le scraping web. Elle permet d’indiquer si, lorsque le mécanisme de Connectif consulte le site web pour synchroniser ou vérifier un produit, il doit le faire dans la même devise que celle configurée dans Connectif.
  • Custom Field 1, Custom Field 2 et Custom Field 3 : ces options permettent de configurer les champs personnalisés des variantes de produit qui seront envoyés à Connectif.

• Cart and order (4) : cette section permet de configurer les informations des paniers et des achats que vous enverrez à Connectif :
  • Print only mandatory fields on cart tags? : cette option permet de déterminer si le script Connectif recueillera uniquement les champs obligatoires du panier (ID du produit, nom, prix et URL). Cette option permet d’améliorer les performances de la balise de panier dans Magento.
  • Use product variants on cart and orders? : cette option permet de déterminer si, lorsque Connectif reçoit les informations des produits du panier, il recueillera le produit par défaut ou la variante spécifique.
  • Notify orders offline : cette option permet de déterminer si l’eCommerce notifiera à Connectif les achats hors ligne via l’API et sans contexte web.
  • Order Status : cette option permet de déterminer le statut que doivent avoir les achats pour être enregistrés via l’API (notifications hors ligne) dans Connectif. 

• Advanced Configuration (5) : cette section sert à définir certains comportements de l’intégration avec Connectif :
  • Use optimized Connectif tags : cette option permet d’optimiser la génération des balises Connectif afin d’améliorer les temps de chargement. Lorsqu’elle est activée, la synchronisation en temps réel des données de contact est également activée automatiquement.
  • Real-time customer data sync : cette option permet de synchroniser en temps réel avec Connectif les modifications apportées aux données des contacts, telles que leurs informations, leurs adresses et leurs abonnements à la newsletter.

• Banners (6) : cette section est obsolète, car les contenus au format bannière sont configurés directement depuis Connectif.

• Public Urls (7) : cette section sert à consulter les URL d’activation du ServiceWorker ainsi que celles de notification d’abonnement.

Ces URL sont générées et communiquées à Connectif lors de l’installation du module dans Magento.

2. Comment activer la notification des achats hors ligne (via l’API) ?

1. Dans votre compte Magento, accédez à "Stores > Configuration", cliquez sur Connectif puis sur Settings.

2. Désactivez le module Connectif depuis la section "Basic Configuration > Activate" en sélectionnant l’option No.

3. Cliquez sur Save Config.

4. Accédez à la section "Cart and Order > Notify purchases offline" et sélectionnez l’option Yes.

5. Dans la section "Order Status" , choisissez le statut que doivent avoir les achats qui seront enregistrés hors ligne dans Connectif.

6. Réactivez le module Connectif depuis la section "Basic Configuration > Activate" en sélectionnant l’option Yes.

7. Cliquez sur Save Config.

3. Comment configurer Connectif dans une boutique Magento multilingue ?

Magento permet de créer trois niveaux d’entités pour un compte :

• Website : il n’y en a généralement qu’un et il correspond au domaine.
• Store : la ou les différentes boutiques, par exemple par langue.
• Store view : d’autres détails concernant les boutiques, par exemple une même langue avec une devise différente.

Le module Connectif peut être configuré à chacun de ces niveaux selon les besoins de l’eCommerce, mais certains aspects doivent être pris en compte :

• Les types de configuration de Magento : si une configuration est effectuée en mode « Default », elle s’appliquera à tous les niveaux de Magento.
• Pour envoyer à la même boutique Connectif les données provenant de différents niveaux de Magento, le même Client ID et la même Secret Key doivent être utilisés dans la configuration.
• Sauf dans les cas très complexes, il est recommandé d’activer la configuration par défaut au moment de l’intégration afin de configurer tous les niveaux de la même manière.

Si plusieurs langues et/ou plusieurs devises doivent être configurées, il est courant d’effectuer séparément les réglages de l’article au niveau de Store View .

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

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

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

Pour obtenir l’URL de récupération du panier via un workflow, il faut utiliser les nœuds « Obtenir le dernier panier » et « Abandon de panier », puis l’associer aux variables du contenu à afficher ou à envoyer.

• Découvrez le fonctionnement de cette URL dans les différents CMS et comment l’utiliser dans cet article. 

5. Comment recueillir la marque des produits dans Magento

Pour recueillir le champ « Marque » dans la fiche produit Connectif lors de l’intégration avec Magento, il est nécessaire d’activer le champ « Manufacturer » de Magento et de lui attribuer les valeurs correspondantes, afin qu’elles soient transmises automatiquement.

Ce champ n’est pas activé par défaut dans Magento. Pour l’activer, suivez les étapes suivantes :

1. Accédez à la section "Stores > Attributes > Attribute Set".

2. Recherchez le groupe d’attributs « Default ».

3. Double-cliquez pour accéder à sa modification puis, une fois dans celui-ci, ajoutez le champ « manufacturer » au dossier « Product Details » en cliquant dessus et en le faisant glisser dans le dossier.

4. Cliquez sur Enregistrer pour confirmer cette configuration. Ainsi, les données du champ « manufacturer » seront toujours transmises pour les produits appartenant à ce groupe d’attributs.

5. Si votre catalogue contient d’autres groupes d’attributs de produits dont vous souhaitez transmettre la marque, vous devrez répéter le processus.

6. Pour vous assurer que le champ sera transmis dans les différents groupes de produits, vous pouvez consulter n’importe quel produit de votre catalogue appartenant à l’un d’eux et vérifier que le champ "manufacturer" figure dans sa fiche Magento. Vous pourrez également le modifier à cet endroit si nécessaire, à l’aide du menu déroulant.

6. Que dois-je prendre en compte si ma boutique Magento 2 utilise Hyvä ?

Si votre boutique utilise Magento 2 avec Hyvä, vous devez vérifier que le thème utilise le système standard d’initialisation JavaScript de Magento *-init afin de lancer correctement les scripts Connectif.

Cette configuration est nécessaire, car Hyvä modifie le système frontend de Magento et peut changer la manière dont certains scripts sont initialisés. Le module Connectif s’appuie sur le mécanisme standard de Magento pour exécuter les scripts de suivi et d’identification du contact.

Pour terminer l’intégration, vérifiez avec votre équipe de développement que les scripts Connectif sont initialisés via *-init, en utilisant data-mage-init ou text/x-magento-init, selon le cas.

Une fois cette configuration appliquée, vérifiez que l’intégration recueille correctement les principaux événements de la boutique. Découvrez comment procéder dans cet article.

Continuez à apprendre !

Pour exploiter pleinement le potentiel de votre compte Connectif, nous vous recommandons de consulter les articles suivants :

• Onboarding, pour vous familiariser avec notre interface.

• Workflows initiaux, pour mettre en œuvre vos premières stratégies dans votre compte.

• Intégrations avec des systèmes externes, pour vous intégrer à Facebook, aux formulaires et aux webhooks de votre site web.

• Intégrations via l’API, pour gérer des événements tels que l’enregistrement des achats ou l’inscription de contacts.