Guide pour intégrer Magento 2

Si votre eCommerce est développé sur 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 à 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 des étapes différentes :

• 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 par l’installation du module Connectif et cliquez sur Suivant :

• Readiness Check : cette étape comprend des vérifications liées à la version de PHP, aux tâches cron, aux dépendances et aux extensions.

• Backup : cette étape permet d’effectuer 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 au moyen d’une connexion SSH.

14. Après vous être connecté en SSH, utilisez la ligne de commande (shell) pour accéder au 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 localisez 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 sur 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 est composé de différentes sections, chacune ayant une fonction spécifique :

• Basic Configuration (1) : cette section sert à configurer les paramètres de base de votre compte Connectif dans Magento, documenté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 en tant qu’abonné à la newsletter lorsqu’il n’existe pas dans Magento au moment où son inscription ou sa désinscription est notifiée depuis Connectif.
  • Configure Customer Fields : cette option permet de lier les champs de contact disponibles dans le CMS (sélecteur de gauche, Customer Field) et de les associer à l’ID du champ créé dans Connectif (sélecteur de droite, Connectif Field ID).

• Product (3) : cette section sert à configurer les paramètres de base de vos produits Magento à synchroniser avec Connectif :
  • Use product SKU identifier? : cette option permet d’utiliser le SKU comme identifiant des produits dans le catalogue Connectif.
  • Product image 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 supérieures, même si elles ne sont pas directement attribuées au produit.
  • Show product view with proper currency when Connectif verify the product : cette option influe sur 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 visite le site 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 produits 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 sur les 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 et 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, rendez-vous dans "Stores > Configuration", cliquez sur Connectif puis sur Settings.

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

3. Cliquez sur Save Config.

4. Rendez-vous dans 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 dans 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 pour les boutiques, par exemple une même langue avec une devise différente.

Le module Connectif peut être configuré à n’importe lequel 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 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 vous souhaitez configurer plusieurs langues et/ou plusieurs devises, 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 donné.)

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

Pour obtenir l’URL de récupération du panier via un workflow, il faut utiliser le nœud "Obtenir le dernier panier" et "Lors de l’abandon du panier", puis la mapper dans les 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 de 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. Rendez-vous dans la section "Stores > Attributes > Attribute Set".

2. Localisez le groupe d’attributs "Default".

3. Double-cliquez dessus pour accéder à sa modification puis, une fois à l’intérieur, 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 utilisant ce groupe d’attributs.

5. Si votre catalogue comporte d’autres groupes d’attributs de produits pour lesquels 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 un produit de votre catalogue appartenant à l’un de ces groupes et vérifier que le champ "manufacturer" est inclus 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 Magento 2 utilise Hyvä, assurez-vous d’avoir installé la version 1.46.0 ou ultérieure du module Connectif, qui est compatible avec ce thème.

Continuez à apprendre !

Pour tirer pleinement parti 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 le compte.

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

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