Intégration Magento

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Veuillez partager ce guide avec eux.

Aperçu de l’intégration

Magento est une plateforme de commerce électronique de premier plan qui aide les entreprises à gérer les produits, les clients et les commandes à grande échelle. En intégrant Magento à Pushwoosh, vous pouvez synchroniser automatiquement les clients, les commandes et les paniers abandonnés pour permettre la messagerie en temps réel, la segmentation ciblée et l’automatisation du marketing cross-canal, vous aidant ainsi à engager les utilisateurs et à augmenter les conversions directement à partir de l’activité de votre boutique.

Type d’intégration

Destination : Cette intégration envoie les données de votre boutique Magento vers Pushwoosh.

Prérequis

Avant de continuer, assurez-vous de ce qui suit :

• Accès au panneau d’administration de Magento

• Un compte Pushwoosh valide

• Votre jeton d’accès API Pushwoosh et votre code d’application

• Composer installé sur votre serveur Magento

• Configuration système requise :

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

Glossaire

Mappage des noms d’entités s’ils sont différents :

Magento	Pushwoosh
Client	Utilisateur

Liste des entités synchronisées :

• Clients
• Commandes
• Paniers abandonnés

Cas d’utilisation

• Envoyer des notifications push basées sur les événements de création de commande et d’abandon de panier.
• Segmenter les clients en fonction de leurs attributs (par exemple, lieu, anniversaire) et envoyer des campagnes ciblées.
• Envoyer des notifications promotionnelles basées sur le navigateur.

Configurer l’intégration

Installation

Note

Pour installer l’intégration Pushwoosh, assurez-vous que Composer est installé.

1. Exécutez la commande Composer suivante à la racine de votre projet Magento :

composer require pushwoosh/magento2-integration

2. Une fois le paquet installé, exécutez la configuration de Magento pour installer le module :

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Configuration post-installation

Après avoir terminé l’installation :

1. Connectez-vous au panneau d’administration de Magento.

2. Naviguez vers Magasins > Configuration > Pushwoosh > Configuration.

Paramètres généraux

Dans la section Général, configurez les champs suivants :

• Statut : Réglez sur Enable pour activer l’intégration.
• URL de l’API : Saisissez le point de terminaison de l’API Pushwoosh : https://api.pushwoosh.com/
• Clé API : Collez votre clé API Pushwoosh requise pour authentifier les requêtes. En savoir plus sur la clé d’accès API de Pushwoosh
• Code d’application : Saisissez le code d’application Pushwoosh correspondant à votre application mobile ou web.

Vous trouverez ci-dessous les options de configuration disponibles pour la synchronisation des clients, des commandes et des paniers abandonnés.

Configuration de la synchronisation des commandes

Définissez comment les données de commande sont synchronisées entre votre boutique Magento et Pushwoosh.

Remplissez les champs suivants :

Activer la synchronisation des commandes	Réglez sur Oui pour activer la synchronisation automatique des commandes. Si activé, le processus suivra le calendrier cron défini. Réglez sur Non pour désactiver la synchronisation automatique.
Paramètres Cron	Disponible uniquement si la synchronisation des commandes est activée. Définissez quand la tâche cron doit s’exécuter à l’aide des champs suivants : Minute, Heure, Jour, Mois, Jour de la semaine. Cron est un planificateur basé sur le temps utilisé pour exécuter des tâches automatiquement à des intervalles spécifiés.
Nombre de commandes à synchroniser	Spécifiez le nombre de commandes à traiter lors de chaque exécution de synchronisation.
Synchronisation des commandes en temps réel	Réglez sur Oui pour synchroniser les commandes immédiatement après leur passation.

Ici, vous pouvez également voir l’état de la synchronisation des commandes :

• Total des commandes : Affiche le nombre total de commandes évaluées pour la synchronisation.
• Commandes synchronisées : Nombre de commandes synchronisées avec succès avec Pushwoosh.
• Commandes non synchronisées : Commandes qui n’ont pas encore été synchronisées.
• Commandes dont la synchronisation a échoué : Commandes pour lesquelles les tentatives de synchronisation ont échoué.

Configuration de la synchronisation des paniers abandonnés

Configurez la synchronisation des données des paniers d’achat abandonnés entre votre boutique Magento et Pushwoosh.

Remplissez les champs suivants :

Synchronisation des paniers abandonnés	Réglez sur Oui pour activer la synchronisation automatique des données des paniers abandonnés. Si activé, la synchronisation s’exécute selon le calendrier cron défini.
Configuration du calendrier Cron	Définissez quand la synchronisation doit s’exécuter à l’aide des champs suivants : Minute, Heure, Jour, Mois, Jour de la semaine. Cron est un planificateur de tâches basé sur le temps qui exécute des tâches automatiquement à des intervalles spécifiés.
Nombre de paniers abandonnés	Spécifiez le nombre de paniers abandonnés qui seront traités lors de chaque exécution de synchronisation.
Temps d’inactivité minimum	Définissez le temps d’inactivité minimum (en minutes) pour qu’un panier soit considéré comme abandonné. Par exemple, 60 signifie que les paniers inactifs pendant au moins 60 minutes seront éligibles à la synchronisation.

Ici, vous pouvez également voir des métriques en temps réel sur l’activité de synchronisation :

• Total des paniers abandonnés : Nombre total de paniers identifiés comme abandonnés.
• Paniers abandonnés synchronisés : Nombre de paniers synchronisés avec succès avec Pushwoosh.
• Paniers abandonnés non synchronisés : Nombre de paniers qui n’ont pas encore été synchronisés.
• Paniers abandonnés dont la synchronisation a échoué : Nombre de paniers pour lesquels la synchronisation a échoué.

Configuration de la synchronisation des clients

Configurez la synchronisation des données clients de votre boutique Magento vers Pushwoosh pour permettre la segmentation de l’audience et la messagerie personnalisée en fonction des attributs des clients.

Remplissez les champs suivants :

Synchronisation des clients	Réglez sur Oui pour activer la synchronisation de tous les enregistrements clients existants et nouveaux. La synchronisation suivra le calendrier cron défini et utilisera les mappages d’attributs spécifiés.
Configuration du calendrier Cron	Définissez quand la synchronisation doit s’exécuter à l’aide des champs suivants : Minute, Heure, Jour, Mois, Jour de la semaine. Cron est un planificateur de tâches basé sur le temps utilisé pour exécuter des tâches automatiquement à des intervalles spécifiés.
Mappage des champs personnalisés du client	Mappez les attributs des clients Magento aux champs personnalisés de Pushwoosh pour un transfert de données précis. Exemples : Date de naissance → Anniversaire, Prénom → firstName
Nombre de clients	Définissez le nombre maximum de clients à synchroniser par exécution de cron.

Ici, vous pouvez également voir les statistiques de synchronisation :

• Total des clients : Nombre total d’enregistrements clients identifiés pour la synchronisation.
• Clients synchronisés : Nombre de clients synchronisés avec succès avec Pushwoosh.
• Clients non synchronisés : Clients en attente de synchronisation.
• Clients dont la synchronisation a échoué : Clients qui n’ont pas pu être synchronisés en raison d’erreurs.

Configuration des notifications web

Réglez sur Yes pour activer les notifications push web pour les visiteurs de votre boutique. Réglez sur No pour désactiver cette fonctionnalité.

Lorsqu’elle est activée, votre boutique Magento peut envoyer des messages en temps réel aux utilisateurs via leur navigateur. Les notifications peuvent être utilisées pour des offres promotionnelles, des mises à jour de statut de commande, des rappels de panier abandonné et d’autres communications marketing.

Enregistrer la configuration

Une fois tous les champs requis remplis, cliquez sur le bouton Enregistrer la configuration situé dans le coin supérieur droit. Videz le cache de Magento si vous y êtes invité pour appliquer les modifications.

Options de synchronisation manuelle

Synchroniser les clients sélectionnés avec Pushwoosh

Si vous préférez ne pas synchroniser tous les clients automatiquement, vous pouvez synchroniser manuellement des clients individuels ou sélectionnés.

1. Dans le panneau d’administration de Magento, naviguez vers Clients > Tous les clients.
2. Localisez et sélectionnez le ou les clients que vous souhaitez synchroniser.
3. Dans le menu déroulant Actions au-dessus de la liste des clients, choisissez Synchroniser avec Pushwoosh.

Une fois la synchronisation terminée, les données du client apparaîtront dans la section User Explorer de votre compte Pushwoosh, avec toutes les informations pertinentes transférées depuis Magento.

Synchroniser les commandes sélectionnées avec Pushwoosh

Si vous préférez ne pas synchroniser toutes les commandes automatiquement, vous pouvez synchroniser manuellement des commandes spécifiques. Pour cela :

1. Dans le panneau d’administration de Magento, naviguez vers Ventes > Commandes.
2. Sélectionnez une ou plusieurs commandes dans la liste.
3. Dans le menu déroulant Actions, choisissez Synchroniser avec Pushwoosh.

Après la synchronisation, la commande apparaîtra dans la section Événements du profil utilisateur dans le User Explorer de Pushwoosh en tant qu’événement PW_OrderCreated ou PW_OrderUpdated (si le statut de la commande a changé), y compris les informations détaillées de la commande.

Synchroniser les paniers abandonnés sélectionnés

Pour synchroniser manuellement les paniers abandonnés sélectionnés :

1. Dans le panneau d’administration de Magento, allez à la section Paniers abandonnés.
2. Sélectionnez le panier que vous souhaitez synchroniser.
3. Dans le menu déroulant Actions, choisissez Synchroniser avec Pushwoosh.

Remarque : Assurez-vous d’avoir configuré la période d’inactivité requise dans les paramètres de Synchronisation des paniers abandonnés pour déterminer quand un panier est considéré comme abandonné.

Après la synchronisation, les données du panier abandonné apparaîtront dans la section Événements du profil utilisateur dans le User Explorer de Pushwoosh en tant qu’événement PW_AbandonedCart avec des informations détaillées.

De plus, deux tags seront définis sur le profil utilisateur :

• Date du panier abandonné → PW_AbandonedCartDate
• ID du panier abandonné → PW_AbandonedCartID

Ces tags peuvent être utilisés pour envoyer des rappels de panier abandonné en utilisant du contenu connecté dans vos modèles d’e-mail. En savoir plus

Vérifier que l’intégration fonctionne

Pour confirmer que l’intégration fonctionne correctement :

1. Créez un client de test dans Magento.
2. Synchronisez manuellement le client avec Pushwoosh.
3. Ouvrez le User Explorer dans votre tableau de bord Pushwoosh et trouvez le client.

Si le client apparaît dans le User Explorer, cela indique que la synchronisation a réussi.