Guide d’intégration avec Magento 2

Si votre eCommerce est développé sous Magento, vous pouvez l’intégrer facilement avec Connectif et commencer à collecter les 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échargement et installation du module Magento 2

Selon la version de Magento utilisée par votre eCommerce, vous devrez suivre certaines é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.
• Si vous utilisez Magento + Hyvä, consultez la section correspondant à votre version ainsi que le point 6 des questions fréquentes.

A. Versions antérieures à Magento 2.2

A.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, cherchez 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. Copier 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 Magento 2.

A.3. Installation du module

6. Accédez au panneau d’administration de Magento 2 et allez dans la section "Système > Assistant de configuration Web".

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

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

• Vérification de préparation : à cette étape, des contrôles sont effectués concernant la version PHP, les tâches cron, les dépendances et les extensions.

• Sauvegarde : à cette étape, une sauvegarde de l’eCommerce est réalisé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, cherchez 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. Copier le dossier Connectif dans l’installation Magento

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

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

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

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

17. Le dossier de destination pour copier le module décompressé doit être “app/code/Connectif/”. Créez ce dossier avec 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. Allez dans "Stores > Configuration > " et localisez la configuration de Connectif.

23. Dans Configuration de base, sélectionnez l’option Oui dans le champ Activer, afin de pouvoir remplir les options Client ID et Clé Secrète.

24. Rendez-vous dans votre compte Connectif et, dans la section "Intégrations > Magento" copiez le ID Client et la Clé Secrète.

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

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

Questions fréquentes

Avez-vous des questions sur le module Connectif dans Magento ? Voici 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 remplissant des fonctions différentes :

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

• Bannières (2) : cette section est obsolète, car les contenus au format bannière se configurent directement depuis Connectif.

• Client (3) : cette section permet de lier les champs personnalisés du contact dans Connectif avec ceux de Magento. Pour cela, sélectionnez un des champs de contact disponibles dans le CMS (sélecteur gauche, Champ Client) et associez-le avec l’ID du champ créé dans Connectif (sélecteur droit, ID Champ Connectif).

• Produit (4) : cette section permet de lier les champs personnalisés du produit dans Connectif avec les champs natifs de Magento. Pour cela, cliquez sur le sélecteur Sélectionner Attribut du champ que vous souhaitez associer (Champ personnalisé 1, 2 ou 3) et sélectionnez l’attribut produit correspondant.

• URLs publiques (5) : cette section sert à consulter les URL d’activation du ServiceWorker et celles de l’abonnement aux notifications.

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

• Configuration avancée (5) : cette section sert à définir certains comportements de l’intégration avec Connectif :
  • Imprimer uniquement les champs obligatoires sur les tags du panier ? : cette option permet de déterminer si le script Connectif collectera uniquement les champs obligatoires du panier (ID du produit, nom, prix et URL). Cette option permet d’améliorer la performance du tag panier dans Magento.
  • Utiliser les variantes de produit sur le panier et les achats ? : cette option permet de déterminer si, lors de la réception par Connectif des informations des produits dans le panier, il collectera le produit par défaut ou la variante spécifique.
  • ID image produit : cette option permet de définir la taille d’image que Connectif collectera.
  • Notifier les achats hors ligne : cette option permet de déterminer si l’eCommerce notifiera à Connectif les achats hors ligne via API et sans contexte web.
  • Statut de la commande : cette option permet de définir l’état dans lequel les achats doivent être pour être enregistrés via API (notifications hors ligne) dans Connectif.
  • Créer des abonnés à la newsletter si le client n’existe pas ? : cette option permet de sélectionner si le contact est créé dans Magento comme abonné à la newsletter s’il n’existe pas dans Magento lors de la notification d’inscription ou de désinscription depuis Connectif.
  • Afficher la vue produit avec la bonne devise lorsque Connectif vérifie le produit : cette option influence le cas où la synchronisation des produits est faite via Scrapping web. Elle permet d’indiquer si, lorsque le mécanisme Connectif visite le site pour synchroniser/vérifier un produit, cela se fasse dans la même devise configurée dans Connectif.

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

1. Dans votre compte Magento, allez dans "Stores > Configuration", cliquez sur Connectif puis sur Paramètres.

2. Désactivez le module Connectif depuis la section "Configuration de base > Activer", en sélectionnant l’option Non.

3. Cliquez sur Enregistrer la configuration.

4. Allez dans la section "Configuration avancée > Notifier les achats hors ligne", et sélectionnez l’option Oui.

5. Dans la section "Statut de la commande", choisissez l’état dans lequel les achats seront enregistrés dans Connectif en mode hors ligne.

6. Réactivez le module Connectif depuis la section "Configuration de base > Activer", en sélectionnant l’option Oui.

7. Cliquez sur Enregistrer la configuration.

3. Comment configurer Connectif dans une boutique Magento multi-langues ?

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

• Website : il y en a généralement un seul et correspond au domaine.
• Store : les différentes boutiques, par exemple, par langue.
• Store view : autres détails pour les boutiques, par exemple, dans une même langue mais 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 Magento, car si une configuration est faite en mode "Default", elle s’appliquera à tous les niveaux Magento.
• Pour envoyer à la même boutique Connectif les données de différents niveaux Magento, la configuration devra utiliser le même Client ID et la même Clé Secrète.
• Il est recommandé, sauf cas très complexes, d’activer la configuration par défaut au moment de l’intégration, pour configurer tous les niveaux de la même façon.

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

4. Comment récupérer des 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, c’est-à-dire un lien pour récupérer les articles liés à ce panier, utilisable dans les workflows et contenus.

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

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

5. Comment récupérer la marque des produits dans Magento

Pour récupérer le champ "Marque" dans la fiche produit de Connectif via l’intégration Magento, il est nécessaire d’activer le champ "Manufacturer" de Magento et d’y renseigner les valeurs correspondantes, afin qu’il soit transmis automatiquement.

Ce champ n’est pas activé par défaut dans Magento, vous devez donc suivre ces étapes pour l’activer :

1. Allez dans la section "Stores > Attributes > Attribute Set".

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

3. Double-cliquez pour accéder à son édition et, 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 appartenant à ce groupe d’attributs.

5. Si vous avez d’autres groupes d’attributs produits dans votre catalogue 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 vérifier un produit de votre catalogue appartenant à l’un d’eux et vous assurer que le champ "manufacturer" est inclus dans sa fiche Magento. Vous pourrez également le modifier si besoin via le menu déroulant.

6. Que faut-il 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 pour 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 tracking et d’identification du contact.

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

Une fois cette configuration appliquée, validez que l’intégration collecte correctement les événements principaux de la boutique. Vous pouvez voir comment faire dans cet article.

Continuez à apprendre !

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

• Onboarding, pour vous familiariser avec notre interface.

• Workflows initiaux, pour mettre en place vos premières stratégies dans le compte.

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

• Intégrations via API, pour gérer des événements tels que les enregistrements d’achats ou les inscriptions de contacts.