Connecter Magento 1 & 2 à la solution WMB

Avant de démarrer le processus de connexion, voici quelques informations utiles :

  • La mise en place de la connexion est une fonctionnalité qui ne nécessite aucune expérience dans l'édition du répertoire racine de Magento. Si vous souhaitez être accompagné, contactez votre expert Magento ou votre développeur pour obtenir de l'aide.
  • WMB pour Magento ne prend pas en charge les produits personnalisés, composés, groupés ou les cartes-cadeaux.
  • Nous vous recommandons de mettre en place votre première optimisation sur un serveur de test.
  • WMB pour Magento est compatible avec les versions Magento suivantes : CE v1.7.x, CE v1.8.x, CE v1.9.x, EE v1.10.x, EE v1.11.x, EE v1.12.x, EE v1.13.x, EE v1.14.x, CE v2.0, CE v2.1x, CE v2.2.x, CE v2.3.x, EE v2.1.x, EE v2.2.x, EE v2.3.x.
  • Pour information la connexion Magento WMB que vous allez créer permet de collecter des données et de les envoyer à la plateforme WMB depuis votre site Web sans aucun développement technique. Vous pouvez l'ajouter rapidement en suivant les étapes ci-dessous.

Instructions de base.

La connexion Magento utilisée pour les produits Webmarketing Booster est dédiée à l'insertion des commandes, des produits et des catégories dans la plateforme WMB. Elle vous offre une cohérence des données entre votre plateforme et la plateforme tiers WMB. La fréquence d'import peut être modifiée en contactant le service support WMB.

Dans l'objectif de supprimer vos frais d'installations, cet article vous permet de générer une clé API qui permet d'assurer la communication entre les deux plateformes.

Intégrer le tag WMB sur votre plateforme Magento (temps estimé 10 min).

La balise wmb.js est la bibliothèque de marquage Web utilisée pour les produits Webmarketing Booster et dédiée au suivi des conversions, à l'affichage dynamique de vos produits et à la mesure des performances d'un site. Elle vous offre un contrôle accru et des processus de configuration simplifiés. Avec wmb.js, vous pourrez bénéficier de l'ensemble des fonctionnalités et des nouveautés dès leur lancement.

Magento 1.x
Magento 2.x

Installez le tag manuellement sur votre site via Google Tag Manager. Pour assurer un fonctionnement optimal de la solution WMB et des performances de votre site, il est important de placer le tag wmb.js asynchrone avant les autres tag JS que vous avez sur votre site.

Collez l'extrait suivant tout de suite après la balise sur chaque page de votre site : <script type="text/javascript" src="https://my.wmb.io/api/wmb.js async"></script>.

Vous avez le choix d'installer le tag manuellement sur votre site comme détaillé dans cet article ci-après ou de l'installer via Google Tag Manager. A noter que quelque soit la méthode, pour assurer un fonctionnement optimal de la solution WMB et des performances de votre site, il est important de placer le tag wmb.js asynchrone avant les autres tag JS que vous avez sur votre site.

Pour intégrer le tag WMB sur votre plateforme Magento, il vous suffit de suivre les 3 étapes ci-dessous.

Accédez à votre thème dans votre back-office

A partir de votre back office Magento, suivez les étapes suivantes :

  • Dans Magento 2.0, cliquer sur Admin > Stores > Configuration > General > Design > HTML head.
  • Dans Magento 2.1, cliquer sur Admin > Content > Configuration> Edit > Other Settings > HTML Head.

Dans l'étape suivante, vous allez intégrer le Tag JS dans votre plateforme Magento.

Intégrez le Tag JS WMB dans votre thème

A partir de votre back office Magento, suivez les étapes suivantes :

  1. Ajoutez le script WMB <script type="text/javascript" src="https://my.wmb.io/api/wmb.js async"></script> dans le champ "Scripts et feuille de Style" prévu à cet effet.
  2. Cliquez sur "Sauvegarder la configuration".

Dans l'étape suivante, vous allez vérifier la mise en place du Tag JS WMB dans votre plateforme Magento.

Vérifiez que le code de suivi fonctionne

Pour vérifier que le code de suivi fonctionne, accédez à votre site Web et suivez les étapes suivantes :

  1. Accédez à la home page de votre site en entrant votre url dans votre navigateur.
  2. Affichez le code source de votre page.
  3. Effectuez une recherche du tag wmb.js dans votre code source.

Bravo ! Vous avez installé le tag wmb.js sur votre site.

Création de la connexion API Magento (temps estimé 15 min).

Magento 1.x
Magento 2.x

Avant d’intégrer votre boutique en ligne Magento à WMB, vous devez fournir votre nom d’utilisateur et votre mot de passe API. Pour créer vos informations d'identification d'API dans Magento, vous devez d'abord créer un rôle Webservice, puis un utilisateur Webservice, il suffit de suivre les 3 étapes ci-dessous. Ce sont ces informations qui vous permettront d'envoyer vos données au nom de votre compte Magento.

Créez un rôle de service Web

A partir de votre back office Magento, suivez les étapes suivantes :

  1. Dans votre panneau d'administration Magento, sélectionnez Système > Services Web > RPC SOAP / XML - Rôles.
  2. Cliquez sur le bouton "Ajouter un nouveau rôle" dans le coin supérieur droit.
  3. Dans l'onglet Infos sur le rôle, entrez un nom de rôle. Vous pouvez choisir n’importe quel nom ici, comme "API Access" par exemple.
  4. Dans le panneau de gauche, sélectionnez l’onglet "Ressources de rôle".
  5. Sélectionnez "Tous" dans le menu déroulant "Accès aux ressources" (cela nous permet d’obtenir les détails de la commande client, les informations sur les produits et les ventes).
  6. Cliquez sur le bouton "Enregistrer le rôle" dans le coin supérieur droit lorsque vous avez terminé.

Dans l'étape suivante, vous allez créer la connexion au sein de votre plateforme Magento.

Créez un utilisateur de service Web

Pour terminer le processus, vous devrez ensuite créer un utilisateur, suivez les étapes suivantes :

  1. Dans votre panneau d'administration Magento, sélectionnez Système > Services Web > RPC SOAP / XML - Utilisateurs.
  2. Cliquez sur le bouton "Ajouter un nouvel utilisateur" dans le coin supérieur droit.
  3. Remplissez les champs suivants dans l'onglet "Informations utilisateur" : Nom d'utilisateur, Prénom, Nom de famille, Email; dans le champ API Key / Password, entrez une clé sécurisée / un mot de passe (toute chaîne numérique ou alphabétique dont vous vous souviendrez). C’est ce que les services Web tiers doivent utiliser pour accéder à votre boutique Magento.
  4. Pour confirmer votre clé / mot de passe API, entrez-la de nouveau dans le champ Confirmation de la clé API.
  5. Dans le panneau de gauche, sélectionnez l’onglet "Rôle d’utilisateur".
  6. Ensuite, sélectionnez le rôle que vous avez créé à l'étape 1.
  7. Cliquez sur le bouton "Enregistrer l'utilisateur" dans le coin supérieur droit lorsque vous avez terminé.

Bravo ! Vous avez créé les identifiants de connexion Magento pour connecter la solution WMB. Dans l'étape suivante, vous allez copier/coller les codes API key et le mot de passe dans votre compte WMB.

Copiez la clé API de votre connecteur sur la plateforme WMB

Dans la section "Admin API", suivez les étapes suivantes :

  1. Retournez sur la plateforme my.wmb.io en utilisant vos login et mot de passe.
  2. Copiez / collez les informations "API key" et "Password" de votre Magento dans les champs prévus à cet effet dans votre tunnel d'inscription WMB.

Dans la prochaine section, vous allez vérifier que la communication entre WMB et votre Magento est bien fonctionnelle.

Avant d’intégrer votre boutique en ligne Magento à WMB, vous devez fournir votre "Access Token". Pour créer cette information d'identification d'API dans Magento, vous devez d'abord créer "une nouvelle intégration" pour faire fonctionner le Webservice.

Pour cela, il suffit de suivre les 3 étapes ci-dessous. Ce sont ces informations qui vous permettront d'envoyer vos données au nom de votre compte Magento vers WMB.

Créez une nouvelle intégration

A partir de votre back office Magento, suivez les étapes suivantes :

  1. Dans votre panneau d'administration Magento, sélectionnez Système > Intégration.
  2. Cliquez sur le bouton "Ajouter une nouvelle intégration" dans le coin supérieur droit.
  3. Dans l'onglet "Intégration Infos", dans la section "Général", vous pouvez entrer et choisir n’importe quel nom, comme "WMB API Access" par exemple.
  4. Dans la section "Identification de l’utilisateur", entrez votre mot de passe dans le champ prévu à cet effet ("Votre mot de passe").
  5. Dans l’onglet "API", les accès du menu déroulant doivent être positionnés sur "Tous".
  6. Cliquez sur le bouton "Enregistrer" en haut à droite.

Dans l'étape suivante, vous allez créer la connexion au sein de votre plateforme Magento.

Activez la nouvelle intégration

Pour terminer le processus, vous devrez ensuite activer la nouvelle intégration en suivant les étapes suivantes :

  1. Dans votre tableau d’intégration, sur la ligne "WMB API Access", cliquez sur "activer".
  2. Cliquez sur le bouton "Autoriser" dans le coin supérieur droit.
  3. Conservez votre "Access Token" nécessaire à l’authentification chez WMB.

Dans l'étape suivante, vous allez connecter votre plateforme Magento.

Copiez la clé API de votre connecteur sur la plateforme WMB

Dans la section "Admin API", suivez les étapes suivantes :

  1. Retournez sur la plateforme my.wmb.io en utilisant vos login et mot de passe.
  2. Dans votre tunnel d'inscription WMB, copiez puis collez les informations "Acess token" de votre Magento dans les champs prévus à cet effet.

Dans la prochaine section, vous allez vérifier que la communication entre WMB et votre Magento est bien fonctionnelle.

Vérifier le fonctionnement de la communication entre votre API Magento et la plateforme WMB.

Pour vérifier que la communication entre votre API Magento et la plateforme WMB fonctionne, accédez à la plateforme WMB et utilisez l'outil de validation de la plateforme my.wmb.io, puis cliquez sur "Valider".

Vous avez réussi à passer à l'étape suivante ? Bravo ! C'est terminé, l'import est en cours, vous allez bientôt pouvoir utiliser la plateforme WMB pour maximiser les performances de votre site.

linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram