Guide pour intégrer avec Magento 2

Si votre eCommerce est développé sur Magento, vous pouvez facilement l'intégrer à Connectif et commencer à collecter des données de vos clients pour créer vos campagnes.

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

 

ÉTAPE 1. Téléchargez et installez le module Magento 2

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

• Si vous avez une version antérieure à Magento 2.2, consultez la section A de cette étape.
• Si vous avez une version postérieure à Magento 2.2, consultez la section B de cette étape.

 

A. Versions antérieures à Magento 2.2

A.1. Téléchargez le module

1. Connectez-vous à votre compte Connectif.

2. Allez dans Paramètres de la boutique dans le menu latéral gauche.

3. Dans la section Plateformes e-commerce, trouvez 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. Copiez le dossier Connectif dans l'installation 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. Installez le module

6. Accédez au Panneau d'administration Magento 2 et allez dans la section "Système > Assistant de configuration web".

7. Dans Gestionnaire de modules, trouvez le module Connectif_Integration et sélectionnez Activer.

8. Suivez les étapes décrites dans l'installation du module Connectif et cliquez sur Suivant :

• Vérification de l'état de préparation : à cette étape, des vérifications sont effectuées concernant la version de PHP, les crons, les dépendances et les extensions.

• Sauvegarde : à cette étape, une sauvegarde de l'eCommerce est effectuée avant l'installation du module. 

• Activation du module : à cette étape, le module est activé. 

 

B. Versions postérieures à Magento 2.2

B.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 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.

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

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

6. Une fois connecté avec succès via SSH, utilisez la ligne de commande (shell) pour accéder au répertoire racine de l'installation de Magento 2.

7. Téléchargez le module (au format Zip ou tar.gz) dans le répertoire racine de l'installation de Magento 2.

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

9. L'emplacement pour copier le module décompressé doit être “app/code/Connectif/”. Créez ce dossier avec la commande suivante :

mkdir –p app/code/Connectif/

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

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

11. Exécutez la commande d'installation de Magento 2 depuis le répertoire racine :

php bin/magento setup:upgrade

12. Compilez le module installé avec :

php bin/magento setup:di:compile

13. Effacez le cache avec :

php bin/magento cache:flush

 

ÉTAPE 2. Activation du module

14. Accédez à "Stores > Configuration > " et localisez la configuration de Connectif.

15. Dans Configuration de base, sélectionnez l'option Oui dans le champ Activer pour pouvoir compléter les options Client ID et Secret Key.

16. Accédez à votre compte Connectif et, dans la section "Intégrations > Magento", copiez l'ID client et la clé secrète.

17. Revenez à Magento 2 et collez-les dans les champs correspondants.

18. Cliquez sur "Enregistrer la configuration" pour sauvegarder les modifications.

 

 

---

Questions fréquentes

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 des fonctions spécifiques :

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

• Banners (2) : cette section est obsolète, car les contenus sous forme de bannière sont directement configurés depuis Connectif.

• Customer (3) : cette section permet de lier les champs personnalisés du contact dans Connectif avec ceux de Magento. Pour ce faire, sélectionnez un champ de contact disponible dans le CMS (sélecteur gauche, Customer Field) et associez-le à l'ID du champ créé dans Connectif (sélecteur droit, Connectif Field ID).

• Product (4) : cette section permet de lier les champs personnalisés du produit dans Connectif avec les champs natifs dans Magento. Pour cela, cliquez sur le sélecteur Select Attribute du champ que vous souhaitez associer (Custom Field 1, 2 ou 3) et sélectionnez l'attribut de produit pour ce champ.

• Public Urls (5) : cette section sert à consulter les URLs d'activation du ServiceWorker et celles des notifications d'abonnement.

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

• Advanced Configuration (5) : cette section permet de configurer certains comportements de l'intégration avec Connectif :
  • Print only mandatory fields on cart tags? : cette option permet de déterminer si le script Connectif collectera uniquement les champs obligatoires du panier (ID produit, nom, prix et URL). Cette option améliore les performances des tags de panier dans Magento.
  • Use product variants on cart and purchases? : cette option permet de déterminer si Connectif collecte les variantes spécifiques ou les produits par défaut dans le panier.
  • Product image ID : cette option détermine la taille d'image collectée par Connectif. 
  • Notify purchases offline : cette option détermine si l'eCommerce notifie Connectif des achats hors ligne via API et sans contexte web. 
  • Order Status : cette option détermine l'état des commandes enregistrées via API (notifications hors ligne) dans Connectif. 
  • Create newsletter subscribers if customer does not exist? : cette option permet de créer le contact dans Magento en tant qu'abonné à la newsletter s'il n'existe pas lors de la notification d'inscription ou de désinscription depuis Connectif.
  • Show product view with proper currency when Connectif verify the product : cette option, utilisée lors de la synchronisation des produits via scrapping, permet d'indiquer si la vérification se fait avec la devise configurée.

 

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

1. Accédez à votre compte Magento, allez à "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 Non.

3. Cliquez sur Enregistrer la configuration (Save Config).

4. Allez à la section "Advanced Configuration > Notify purchases offline", et sélectionnez l'option Oui.

5. Dans la section "Order Status" choisissez le statut dans lequel doivent être les achats pour être enregistrés dans Connectif de manière hors ligne.

6. Réactivez le module Connectif dans la section "Basic Configuration > Activate", en sélectionnant l'option Oui.

7. Cliquez sur Enregistrer la configuration (Save Config).

 

3. Comment configurer Connectif dans une boutique multilingue Magento ?

Magento permet de créer trois niveaux d'entités dans un compte :

• Website : il y en a généralement un seul et il correspond au domaine.
• Store : les différentes boutiques, par exemple par langue.
• Store view : d'autres détails, 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'applique à tous les niveaux.
• Pour envoyer les données de différents niveaux Magento à la même boutique Connectif, vous devez utiliser le même Client ID et la même Secret Key.
• Il est recommandé, sauf cas complexes, d'activer la configuration par défaut lors de l'intégration pour configurer tous les niveaux de manière identique.

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

 

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 Magento, une URL de récupération de panier est envoyée à Connectif. Ce lien permet de récupérer les articles associés à un panier et peut être utilisé dans les workflows et contenus.

Pour obtenir l'URL de récupération de panier via un workflow, utilisez les nœuds "Obtenir le dernier panier" et "Au moment d'abandonner le panier". Ensuite, mappez les variables dans le contenu à afficher ou envoyer.

• Apprenez comment cette URL fonctionne 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 lire les articles suivants :

• Onboarding, pour apprendre à maîtriser notre interface.

• Workflows de début, pour mettre en place vos premières stratégies.

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

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