Vous trouverez ici toutes les informations dont vous avez besoin pour installer l'intégration Emarsys pour Magento et la faire fonctionner. Certaines étapes ne concernent que les utilisateurs de Smart Insight ou de Predict et sont clairement indiquées.
Ce guide est compatible avec les versions Magento suivantes :
- Les versions Communauté 1.7, 1.8, 1.9.
- Les versions Magento Entreprise 1.12, 1.13, 1.14.
Ce guide part du principe que vous possédez déjà un exemplaire de Magento 1 en état de marche. Si vous avez besoin d'aide pour installer ceci, veuillez consulter la documentation Magento.
Contenus :
Sommaire de l'intégration
L'intégration Emarsys pour Magento 1 permet la synchronisation de données (des données de contacts et e- commerce) entre Magento et votre compte Emarsys, et exploite la fonctionnalité de la Plateforme Marketing Emarsys pour vos données e-commerce Magento.
Les fonctionnalités principales sont :
- La synchronisation de contact de Magento vers Emarsys.
- La synchronisation d'opt-in de Magento vers Emarsys.
- L'implémentation en un clic des scripts de collecte de données Web Extend.
- Configurer des événements Magento comme déclencheurs de communication personnalisée en provenance de la plateforme Emarsys.
- L'exportation automatique d'achats vers Smart Insight.
Pré-requis
Veuillez noter que notre extension est conçue pour fonctionner uniquement avec l'installation par défaut de votre boutique en ligne. Si votre installation a été modifiée ou personnalisée, nous ne pouvons vous garantir que les modifications apportées ne rentrent pas en conflit avec l'une ou l'autre des fonctionnalités de l'extension.
Si votre installation de boutique Web a été modifiée et que vous avez besoin de notre aide concernant l'extension, nous aurons besoin que vous nous fournissiez les éléments suivants :
- Un système dupliqué où il est possible de reproduire le problème.
- Un accès complet à l'interface admin de votre boutique Web.
- L'accès complet au serveur hôte, avec les droits adéquats (par exemple l'accès SSH).
Cela nous permettra d'identifier rapidement n'importe quel problème, et de vous aider à le résoudre correctement.
1. Conditions pour Magento 1
Ce plugin ne supporte l'intégration que d' une boutique et un site par compte Emarsys. Si vous avez plusieurs boutiques sur le même site, veuillez vous adresser au Support Emarsys pour discuter des possibilités qui s'offrent à vous.
Il faudra que Magento vous fournisse :
- Pour les Éditions Communauté plus anciennes que 1.8, et les Éditions Entreprise plus anciennes que 1.13.1, remplacez le fichier
curl.php
situé dans MAGE_ROOT_DIR/lib/Varien/Http/Adapter/ (le fichier de remplacement est fourni par Emarsys). Le fichiercurl.php
plus ancien ne peut pas gérer les en-têtes passés par l'API Emarsys et n'affichera pas la liste de champs sur la page de configuration. - Assurez-vous que la limite de mémoire PHP de votre serveur est réglée sur un minimum de 512 MB. Cela est nécessaire parce que certains travaux d'extension importants nécessitent une mémoire PHP augmentée.
- Assurez-vous que le chemin suivant est exclu de tous les mécanismes d'antémémoire que vous utilisez : app/design/frontend/base/default/template/emarsys/javascripttracking.phtml. C'est ici que résideront les scripts de collecte de données Web Extend et la mise en antémémoire perturbera leur fonctionnement.
- Le planificateur AOE (ou assimilé) n'est pas obligatoire mais fortement conseillé, car il expose les tâches planifiées visuellement et nous aidera à vous assister. Veuillez noter que le Planificateur AOE n'est pas disponible pour PHP 5.6 et au-dessus.
- Configurez votre Cron Magento pour tourner toutes les minutes pour les éditions Magento Entreprise et toutes les cinq minutes pour les éditions Communauté Magento. Certains travaux planifiés sont trop gros pour être pris en charge par le planificateur Magento et expireront si vous les tentez. Vous pouvez consulter la documentation Magento pour trouver des instructions permettant de faire cela ou bien demander à votre fournisseur Magento de le faire à votre place.
- Le port TCP 21, 32000-35000 doit être ouvert (c'est obligatoire pour que le fichier soit transféré au FTPES).
- Assurez-vous d'avoir le niveau d'accès nécessaire pour installer les extensions du Marché Magento dans votre boutique Magento.
- Emarsys doit absolument disposer d'un accès Admin aux étapes d'organisation et de production pour pouvoir supporter l'Extension, ainsi qu'un accès SSH à votre serveur Web (un accès SSH direct est préférable, mais pas obligatoire, tant qu'il y a de votre côté une ressource capable d'accéder au serveur en cas de besoin).
2. Conditions pour Emarsys
Si vous avez déjà utilisé une précédente intégration Magento pour Emarsys, assurez-vous qu'elle n'ait bien été désinstallée. Et sinon, vous aurez besoin de la part d'Emarsys :
- Un compte sur la Plateforme Marketing Emarsys entièrement configuré et en état de marche.
Si vous avez plus d'un site Magento, vous devez associer chacun d'entre eux à un compte Emarsys séparé.
- Votre Identifiant de marchand Emarsys (vous la trouverez à la page Admin menu > Sources de données dans votre compte Emarsys).
- Vos identifiants pour l'API Emarsys API (pour la synchronisation de données de contact en continu).
- Votre dossier et identifiants FTP Emarsys (réservé aux clients Smart Insight).
Tous ces éléments devraient déjà avoir été installés dans le cadre de votre processus d'initialisation Emarsys standard. S'il vous en manque, veuillez contacter le Support Emarsys.
- Le pack d'installation (téléchargeable ici).
- Mettez l'adresse IP 185.4.123.111 et la plage 217.175.192.0/24 sur liste blanche (obligatoire pour la synchronisation d'opt-in retour d'Emarsys à Magento).
En plus de cela, vous devrez créer les choses suivantes dans votre compte Emarsys.
- Un événement et une campagne extérieurs pou chacun de vos événements Magento configurés (voir ci-dessous).
- Tous les champs de données personnalisés dont vous avez besoin pour faire la correspondance avec les champs client Magento.
- Des champs personnalisés du type champ de Texte Court (max. 60 caractères) avec les noms suivants :
- Identifiant client Magento
- Identifiant de souscripteur Magento
Note : Les noms de fichier sont sensible à la casse. Par exemple, l' Identifiant client Magento ne sera pas accepté par l'intégration.
Installer l'intégration - obsolète
Cette version est maintenant obsolète. Si vous avez besoin d'une assistance supplémentaire, veuillez contacter le Support Emarsys.
1. Installer le module Emarsys
- Dans Github, naviguez jusqu'au dossier /app/ puis copiez le dossier app et le fichier package.xml vers la racine de projet Magento, par exemple : /var/www/html/magento/.

2. Vider le cache Magento
- Retournez au module admin Magento, allez à Système > Gestion du Cache et cliquez sur Vider le Cache Magento.

- Déconnectez-vous du module Admin puis reconnectez-vous y.
- Vous verrez apparaître une nouvelle entrée dans le menu Système > Configuration : Emarsys Connect.

- Le Tableau de bord du Panel Admin Magento possédera maintenant aussi une entrée menu : Emarsys Email:
3. Activer la collecte de données Web Extend
En tant que partie du pack d'intégration, les scripts de collecte de données Web Extend seront installés sur votre site Magento. Ceux-ci tracent toute une série d'activités de navigation et d'achat (y compris les encaissements d'invités). Pour en savoir plus sur ces commandes JavaScript et où elles sont installées, consultez la Référence API JavaScript Web Extend.
Pour les utilisateurs Predict, ces scripts sont la base des recommandations produit.
Ils fournissent aux utilisateurs Smart Insight les données de revenu et d'attribution.
Ils fournissent aux Utilisateurs Emarsys les valeurs de l'ensemble standard dechamps de comportement.
Pour activer ces scripts, ouvrez le menu Système ,allez à Configuration > Emarsys Connect > Web Extend et effectuez les paramétrages suivants.
- Activer Web Extend - Réglez sur Oui.
- Identifiant Marchand - Votre Identifiant marchand Emarsys (vous le trouverez à la page Admin menu > Sources de données dans votre compte Emarsys).
- Mode Test - S'il est réglé sur Oui, il active la commande
testMode
de la référence API JavaScript, ce qui vous permet de tester votre compte sans affecter la cohérence de vos données. Pour une intégration en live il faut le régler sur Non. - Identifier le Client enregistré et connecté par - La clé externe qui identifier le contact dans Emarsys. Dans la plupart des cas, nous conseillons d'utiliser l' Adresse Email. Voir Sélectionner l'Identifiant Clé ci-dessous.
- Identification unique de l'article - La clé qui associera les articles à votre flux de données produit.
- Monnaie d'usage de base - Pertinent seulement si vous possédez plusieurs boutiques Magento configurées sur un seul compte Emarsys.
- Si Oui, tous les prix seront convertis dans la devise de votre boutique par défaut avant d'être envoyés à Emarsys.
- Si Non, tous les prix seront envoyés dans la monnaie locale de la boutique.
- Tracer les prix avec les impôts - Si vous avez des boutiques dans différentes régions avec différents niveaux de TVA, vous pouvez choisir d'éluder ces impôts et de n'envoyer que les prix en net à Emarsys.
- Si Oui, tous les prix seront envoyés taxes comprises.
- Si Non, tous les prix seront envoyés taxes déduites.
- Utiliser la mise à jour Ajax - Si vous nous autorisez à interdire au chemin du modèle la mise en antémémoire comme décrit dans les besoins pour Magento 1 ci-dessus, cela vous aidera à empêcher les données Web Exend d'être mises en antémémoire.
- Si Oui, aucune donnée Web Extend ne sera mise en antémémoire.
- Si Non, vous courrez le risque de la mise en antémémoire de données, ce qui pourrait entraîner des incohérences de données dans Emarsys.
- Utiliser jQuery - Si votre site Magento supporte jQuerry, vous devriez l'utiliser en priorité, sinon la méthode de Mise à jour Ajax sera utilisée.
- Si Oui, aucune donnée Web Extend ne sera mise en antémémoire.
- Si Non, vous courrez le risque de la mise en antémémoire de données, ce qui pourrait entraîner des incohérences de données dans Emarsys.
Lorsque vous avez établi vos paramètres et cliqué sur Sauvegarder la Configuration, les scripts Web Extend seront ajoutés aux thèmes et aux modèles de votre site et la collecte de données commencera immédiatement.
Configurer les connexions Emarsys
Emarsys pour Magento 1 utilise différentes méthodes de transfert en fonction du type de données transférées.
- L'API Emarsys est utilisée pour extraire vos données d'Emarsys (champs, événements extérieurs, etc.), synchroniser les contacts entre Magento et Emarsys (dans les deux sens) et pousser les événements Magento vers Emarsys. Elle est aussi utilisée pour le chargement de données de contact initial.
- Un serveur FTP est nécessaire pour les téléversements en masse de données e-commerce.
1. Paramètres de l'API
Pour configurer la connexion API Emarsys, ouvrez le menu Système et allez à Configuration > Emarsys Connect > Paramètres de la Suite.
File d'attente actuelle
Cela vous montre combien de nouveaux clients se sont enregistrés sur le site depuis la dernière synchronisation des données. Le compteur retourne à zéro après chaque synchronisation (cela peut parfois prendre quelques minutes, en fonction de la connectivité du réseau).
Paramètres d'API
- Activés Réglez le sur Oui pour activer le plugin.
- Point d'extrémité d'API Cela peut être l'une de ces deux valeurs :
- Par défaut - C'est l'option conseillée qui utilise l'URL API Emarsys standard pour votre environnement (par exemple https://suitexx.emarsys.net/api/v2).
- URL personnalisée - Cela vous permet de modifier l'URL par défaut si besoin.
- CDN - Pour les clients situés hors Europe (par exemple dans l'APAC), vous pouvez utiliser un CDN pour améliorer la performance. Si vous pensez que ce sera une meilleure option pour vous, veuillez consulter le Support Emarsys car nous devrons configurer quelques paramètres de notre côté.
- URL d'API personnalisée Si vous avez sélectionné cette option plus haut, saisissez votre URL par défaut modifiée ici. Assurez-vous de ne pas inclure de / surnuméraire à la fin de l'URL ou vous recevrez un message d' erreur pendant la configuration des champs.
- Debuger Si réglé sur Oui, cela enregistre des événements d'intégration supplémentaires, ce qui est utile quand vous voulez permettre à des modules de debugage supplémentaires d'examiner des activités spécifiques (par exemple tracer l'activité de synchronisation quand nous commençons à exporter les fichiers de contacts et de ventes après l'installation).
- Profileur de plugin Si réglé sur Oui, cela enregistre le temps et les ressources consommées par le plugin pour accomplir n'importe quelle action déterminée. Voyez : Sur l'enregistrement, ci-dessous.
- Nettoyer les fichiers de module d'enregistrement - Cela supprime les derniers fichiers d'enregistrement. Si vous laissez les options d'enregistrement activées après que l'intégration a été installée avec succès, vous devriez faire ça régulièrement (chaque jour).
- Télécharger les fichiers du module d'enregistrement Télécharge les fichiers d'enregistrement pour toutes les options d'enregistrement que vous avez activées.
- Le Ping API du service Cron Cela doit être Activé, puisqu'il permet à l'extension d'établir que la connexion est encore active et enregistre les erreurs quand elle ne l'est pas (si Debuger est réglé sur Oui). La perte de connexion entraînera la mise en attente des appels API, ce qui limitera les fonctionnalités en temps réel de l'intégration. Ce ping vous permettre de voir quand et pourquoi la connexion a été perdue.
- Nom d'utilisateur pour l'API de la Suite API et Mot de passe pour l'API de la Suite Saisissez vos identifiants d'API Emarsys (pas vos identifiants de compte Emarsys). Le Support Emarsys a dû vous les fournir pendant votre intégration.
Votre Propriétaire de compte Emarsys peut aussi créer de nouveaux utilisateurs et mots de passe d'API à la page Admin menu > Paramètres de sécurité , voir : Utilisateurs API. - Cliquez sur Sauvegarder la Configuration pour sauvegarder vos paramètres.
- Cliquez sur Tester la connexion pour vérifier que vous avez saisi ces identifiants correctement. Le bouton Tester la connexion devrait passer au vert pour signaler que la connexion a été établie entre Magento et votre compte sur la Plateforme Marketing Emarsys.
Sur l'enregistrement
Nous conseillons de maintenir les deux options d'enregistrement sur Oui jusqu'à ce que vous ayez complètement configuré et testé cette intégration. Cela vous aidera (et nous aussi) à identifier les causes de tout problème qui se pose.

Le Profileur de plugin surveille l'allocation du temps et de la mémoire du cycle de chargement d'une application à intervalles réguliers. En activant le paramètre Profileur de plugin , nous pouvons collecter les informations concernant le temps et les ressources globaux consommés par le plugin pour l'accomplissement de n'importe quelle action spécifique.
Lorsque ce paramètre est activé, il enregistre les données liées dans un fichier d'enregistrement appelé emarsys-profiler.log qui peut être téléchargé via les bouton et lien Télécharger les fichiers d'enregistrement du module.
Le fichier d'enregistrement contient les données suivantes :
- Compte - Le nombre de fois qu'un code particulier a été utilisé/exécuté.
- realmem et realmem_start - Cette colonne montre le volume de mémoire alloué à PHP. C'est un mix entre la fonction PHP principale
memory_get_usage()
sans le paramètreVRAI
activé, moins les valeurs du chronomètre. - emalloc et emalloc_start - Cette colonne montre les valeurs PHP supplémentaires qui aident à détecter les problèmes de mémoire.
Dans certaines instances de Magento, activer le Profileur de plugin peut causer des problèmes. Si vous recevez un tel message d'erreur de la part de Magento, vous pouvez faire passer votre Profileur de plugin sur Non si Debuger est réglé sur Oui. De cette manière, vous pourrez toujours enregistrer certains événements d'intégration, voire tous.
Une fois l'installation complétée, vous devez faire passer les deux options sur Non.
A partir de là, vous devriez avoir l'impression que l'intégration ne réalise pas la performance attendue :
- Nettoyez les fichiers d'enregistrement du module
- Activez les deux options d'enregistrement
- Débuguez l'intégration
- Nettoyez les fichiers d'enregistrement à nouveau
- Désactivez les deux options d'enregistrement
2. Paramètres FTP
Une connexion FTP est nécessaire pour les utilisateurs Smart Insight et Predict. Pour configurer cette connexion, ouvrez le menu Système et allez à Configuration > Emarsys Connect > Smart Insight > Paramètres FTP.
- Nom de l'hôte, Nom de l'utilisateur et Mot de passe - Saisissez vos identifiants tels que fournis par le Support Emarsys. Si vous êtes un client Predict qui n'utilise pas Smart Insight, vous pouvez saisir ici les détails de votre propre serveur à la place.
- Répertoire - Si vous avez créé un sous-directoire sur le serveur pour séparer les exportations manuelles des exportations programmées ordinaires, saisissez le nom de ce dossier ici (précédé de /).
- Utiliser FTP plutôt que SSL(FTPS) - Réglez cela sur Oui (conseillé).
- Utiliser le mode passif - Réglez cela sur Oui ou Non en fonction de vos besoins IT.
- Cliquez sur Sauvegarder la Configuration lorsque vous avez fini.
- Cliquez sur Tester la Connexion pour vérifier que tout fonctionne. Magento affichera un message pour confirmer si cela fonctionne ou pas.
Données de contact
1. Avant de commencer...
Avant de commencer, veuillez lire la section suivante pour avoir un aperçu de comment Magento et Emarsys gèrent les contacts et leurs données.
Sur les contacts de Magento 1
Magento 1 a deux principaux types de contacts :
- Les clients (les contacts capables d'acheter)
- Les abonnés (les contacts ayant souscris à la newsletter de la boutique en ligne)
Ceux-ci sont identifiés par des identifiants uniques Magento (l' Identifiant client Magento et l' Identifiant abonné Magento mentionnés dans les pré-requis).
Un contact peut être de ces deux types, auquel cas les deux valeurs sont synchronisées dans Emarsys sous le même fichier de contact, ce qui évite les doublons d'adresses email.
Sélectionner l'Identifiant Clé
Le plugin Emarsys pour Magento 1 vous donne le choix entre deux options pour l'identifiant externe au moment de synchroniser vos contacts.
- L'identifiant client (conseillé) Sélectionner l' Identifiant client signifie que l'un ou l'autre des deux champs mentionnés plus haut est l'identifiant clé des contacts synchronisés entre Magento et Emarsys, plutôt que l'adresse email, puisque cette dernière a pu être modifiée manuellement à tout moment par le contact sur son profil client.
- L' Email Si vous préférez utiliser l' Email, vous devrez vous assurer que vous n'avez pas de doublons de contacts avec la même adresse email dans votre base de données de contact Magento, sinon l'un d'entre eux ne sera pas exporté.
Vous trouverez les paramètres de synchronisation de contact sous Système > Configuration > Emarsys Connect > Synchronisation des Contacts.
Si vous n'êtes pas sûr de la bonne clé externe à utiliser, veuillez contacter le Support Emarsys qui peut vous donner un avis basé sur votre stratégie de données actuelle.
Si vous sélectionnez l' Identifiant client, veuillez noter que l'option d'exporter les encaissements d'invités ne sera pas disponible.
2. Configuration du champ de données de contact
Les clients Magento possèdent un profil client très complet qui offre un certain nombre de champs. En fonction de votre business model et de vos besoins, vous ne serez probablement intéressé que par un sous-ensemble de ces champs.
Par contraste, les abonnés Magento ne disposent que de quatre champs pour la synchronisation :
- Prénom
- Le nom
- L'adresse email
- L'état d'abonnement (opt-in)
Pour coordonner les champs entre Emarsys et Magento, allez à Système > Configuration > Emarsys Connect > Synchronisation de contact et ouvrez la section Configuration de champ .
Cliquez sur Mettre à jour le Schéma pour vous assurer que tous vos champs Emarsys sont disponibles dans Magento.
Sélectionnez chaque champ Magento que vous voulez synchroniser et le champ cible approprié dans l'application Emarsys, puis utilisez la flèche droite pour déplacer les paires associées.
Avant de commencer, vérifiez que vous avez créé tous les champs dont vous avez besoin dans Emarsys. Sinon, créez les maintenant et cliquez à nouveau sur Mettre à jour le Schéma pour les rendre disponibles dans Magento. N'oubliez pas de prêter attention au type de champ lorsque vous créez de nouveaux champs.
Vous pouvez gagner du temps en utilisant le bouton Configuration recommandée. Il s'agit d'une tentative d'identifier et d'associer des correspondances sur la base d'un nom de champ similaire. Y avoir recours ne vous dispense pas d'avoir à vérifier chaque configuration individuelle pour vous assurer qu'elles sont correctement associées.
Remarque : En plus des champs que vous sélectionnez pour la configuration, trois champs Magento sont toujours inclus pour la synchronisation par défaut :
- Opt-in
- Identifiant client
- Identifiant abonné
La configuration de la valeur pour les champs à choix unique ou multiple n'est pas supportée. Vous ne devez utiliser que des champs de texte simple (numérique ou alphanumérique) pour associer vos données à Emarsys.
3. Le chargement de données de contact intitial
Une fois que vous avez préparé vos données client comme décrit ci-dessus, vous pouvez réaliser le chargement de données initial pour importer tous vos clients et abonnés Magento vers Emarsys.
Ouvrez le menu Système et allez à > Configuration > Emarsys Connect > Synchronisation de contact et ouvrez la section Paramètres de synchronisation .
- Activer l'exportation clients et Activer l'exportation abonnés - Réglez les deux sur Oui pour activer les deux boutons Exportation (après avoir réalisé votre exportation vous devriez les refaire passer sur Non).
- Utiliser l'URL de notification sécurisée - Si l'URL de votre boutique en ligne commence par https://, vous devez le régler sur Oui. On peut le régler sur Non pour faire un test ou organiser les installations.
- Mode synchronisation Ignorez cela pour l'instant.
- Temps d'exécution en arrière-plan Ignorez cela pour l'instant.
- Clé secrète de notification C'est le mot de passe requis pour les notifications d'exportation.
- Identifiant clé Sélectionnez votre identifiant unique pour les contacts.
Lorsque vous avez terminé, vous pouvez réaliser le chargement de données initial en cliquant sur les deux boutons Exporter. Vous pouvez exécuter les deux exportations en même temps, mais vous ne devez pas les faire commencer en même temps car toutes deux ont besoin de quelques secondes pour initier l'exportation. La durée exacte dépendra de la taille de votre base de données mais le système vous informera si vous démarrer la seconde exportation trop rapidement.
Lorsque vous ferez le chargement de données initial, la chose suivante se produira :
- Pour les clientsMagento, tous les champs définis dans la Configuration de champ ci-dessus seront synchronisés, ainsi que les champs Opt-in et Identifiant client .
- Pour les abonnés Magento, seuls les Prénom, Nom, Adresse email, Opt-in et Identifiant abonné sont synchronisés.
La synchronisation débutera au prochain multiple de cinq minutes. Si le processus semble bloqué, il se peut que vous deviez vider le cache de Magento 1, voir : Résolution des problèmes.
Le chargement de données initial utilise l'API Emarsys, qui traite les contacts par groupes de 10 000. En fonction du nombre de contacts et de champs à charger, ce traitement peut prendre de quelques minutes à quelques heures (pour une base de données de plus de 10 millions de contacts, par exemple).
A propos de l'URL et de la clé secrète de notification.
Lorsque l'extension a besoin de données fraîches, elle appelle l'API Emarsys pour lancer une exportation. Plutôt que de biper Emarsys toutes les quelques secondes pour vérifier quand l'exportation est prête, l'extension fournit une URL qu'Emarsys peut appeler quand l'exportation est complétée, de sorte que Magenta puisse retirer les données.
Appeler cette URL à partir du processus d'importation force en fait Magento à vérifier une exportation Emarsys, l'URL doit donc être aussi unique que possible pour éviter les attaques par déni de service (DOS) qui impacteraient à la fois l'instance Magento et Emarsys. La Clé secrète de notification est utilisée pour s'assurer que l'URL est unique.
Vous ne devez utiliser que des caractères latins alphanumériques pour cette clé (a-z, A-Z, 0-9). Voir https://perishablepress.com/stop-using-unsafe-characters-in-urls/ pour plus d'informations.
4. Paramètres de synchronisation de contact
Une fois réalisé le chargement de données initial, vous devrez définir les paramètres de la synchronisation continue des nouvelles données.
Dans la section Paramètres de synchronisation , faites les paramétrages suivants :
- Activer l'exportation clients et Activer l'exportation abonnés Réglez les à nouveau sur Non pour désactiver les deux boutons Exporter, afin d'empêcher uns synchronisation accidentelle de l'intégralité de votre base de données de contact.
- Mode synchronisation Sélectionnez Temps réel-sécurité défaut ou bien Arrière-plan seulement selon vos besoins (voir ci-dessous).
- Temps d'exécution en arrière-plan Réglez l'heure de la journée pour la synchronisation de données quotidiennes;
Cliquez sur Sauvegarder la Configuration pour sauvegarder vos paramètres. La prochaine exportation aura lieu à l'heure programmée.
Une fois que le chargement de données initial est complété et que l'intégration synchronise les données sur les deux systèmes régulièrement, l'état d'opt-in est géré contact par contact au fur et à mesure qu'ils s'inscrivent, s'abonnent ou se désabonnent du contenu. Ce sont les seules données à être synchronisées de part et d'autre, le dernier horodatage ayant la priorité.
Temps réel-sécurité défaut vs Arrière-plan seulement
La synchronisation des contacts peut être planifiée de deux manières :
- Temps réel-sécurité défaut
Cela maintient la synchronisation de contact en temps réel, et chaque mise à jour est envoyée au moment où elle se produit dans Magento. Cette option est adaptée pour les cas pratiques où Emarsys a besoin des données immédiatement (par exemple pour les programmes d'engagement automatisés). Dans le cas d'échecs de mises à jour (par exemple à cause d'un temps d'indisponibilité du réseau ou d'un volume excessif), ils sont placés dans une file d'attente sécurité-défaut et ne sont traités qu'une fois par jour au Temps d'exécution en arrière-plan spécifié (voir ci-dessous).
Important : vous devez discuter de vos besoins avec le Support Emarsys afin de vous assurer que votre API est correctement configurée pour gérer vos besoins en termes de volume de trafic.
- Arrière-plan seul
Ceci synchronise toutes les mises à jour de contact intervenue dans les 24 heures avant le Temps d'exécution en arrière-planspécifié. Cette option est adaptée lorsqu'il n'y a pas besoin de transféré les données à Emarsys en urgence. Aucune limite n'est fixée au volume de données synchronisé.
Temps d'exécution en arrière-plan
Vous saisissez ici l'heure du jour à laquelle votre exportation sécurité-défaut s'exécutera (si vous utilisez l'option Temps réel-Sécurité défaut ), ou à laquelle votre exportation quotidienne s'exécutera (si vous utilisez l'option Arrière-plan seul ).

5. Quelles données sont synchronisées ?
- De Magento à Emarsys
La base de données de contact Magento est considérée comme la base de données Maîtresses en ce qui concerne les renseignements sur le contact, et toutes les valeurs synchronisées pour les champs associés écraseront le valeurs existantes dans l'application Emarsys. Pour les Clients Magento, les nouveaux contacts seront exportés avec les mêmes champs qu'à l'exportation initiale. Pour les Abonnés Magento, seuls les champs Adresse Email et Opt-in sont exportés, puisque les champs Prénom et Nom ne peuvent être modifiés dans Magento.
- D'Emarsys à Magento
Une fois par jour, au Moment d'exécution de l'arrière-plan spécifié, Emarsys vérifie aussi qu'aucun champ d'Opt-in des contacts Magento n'a été modifié. Dans ce cas-là, cette modification est synchronisée en retour vers Magento.
Il est toutefois fortement recommandé de ne pas modifié l'état d'opt-in dans l'application Emarsys car la mise à jour vers Magento mettre 24 heures, durant lesquelles le contact pourrait recevoir encore d'autres emails (transactionnels). Les meilleurs pratiques reviendraient à faire la mise à jour dans Magento, de sorte que le contact Emarsys soit mis à jour comme spécifié en mode synchronisation.
A chaque fois que le champ d'opt-in est synchronisé, l'intégration vérifie le dernier horodatage dans les deux systèmes et la priorité est toujours donnée au dernier en date. C'est pour empêcher qu'une action de désinscription dans Magento soit écrasée par l'ancienne valeur dans Emarsys.
Données de produit
Si vous utilisez Smart Insight et/ou Predict, vous devrez vous assurer que vos données de produit Magento sont correctement chargées vers Emarsys et synchronisées en continu.
A la différence des données de contact et de ventes, l'intégralité (et pas seulement le delta) du fichier de données produit est toujours exportée. C'est pourquoi le chargement initial et la synchronisation continue sont en fait le même processus.
1. Associez les attributs au produit
Vous devez associer vos champs de caractéristiques produit Magento aux champs de données produit Emarsys corrects, pour vous assurer que votre fichier de données produit a les bonnes colonnes et les bons types de champ, en conformité avec nos standards. Pour plus d'informations, veuillez consulter : Préparer votre fichier de données produit.
Pour associer les caractéristiques produit, allez à Emarsys > Association de caractéristique produit.
Ici vous associez les colonnes du flux de données produit. Pour chaque caractéristique Magento, sélectionnez le champ Emarsys approprié.
- Ajoutez une caractéristique Emarsys - S'il vous manque un champ Emarsys, vous pouvez créer l'en-tête de colonne ici. Le nom de champ se verra ajouter automatiquement le préfixe c_.
Cela ne créera pas le champ dans Emarsys. Vous devez aller sur votre compte Emarsys et le faire manuellement. Il est pour cette raison recommandé de créer d'abord le champ dans Emarsys puis de cliquer sur Mettre à jour le Schéma pour l'importer dans Magento.
- Mettre à jour le Schéma - Importe tous les champs Emarsys disponibles vers Magento.
- Association recommandée - Associe automatiquement les champs sur la base de leurs noms. Cela peut vous faire économiser du temps si vous avez beaucoup de champs.
Quand vous avez terminé, cliquez sur Sauvegarder l'association pour sauvegarder vos paramètres.
2. Configurer le flux de données produit
Allez maintenant à Système > Configuration > Emarsys Connect > Exportation du catalogue complet. Ici vous configurez votre flux de données produit et sélectionnez les types de produit à y intégrer.
- Activer l'Exportation de catalogue complet - Réglez cela sur Oui. Peu importe si une exportation planifiée a lieu avant que vous ayez fait votre chargement initial, puisque l'intégralité du fichier de données produit est systématiquement écrasée à chaque fois.
- Inclure les produits désactivés - Inclut les produits qui ne sont plus disponibles à la vente. Dans la plupart des cas cela doit être réglé sur Oui, pour assurer la cohérence des données à long terme.
- Inclure les types de produit - Ici vous sélectionnez quels types de produit à intégrer. Référez-vous à la Documentation Magento pour plus de précisions.
- Heure de début - Règle l'heure de la journée pour le flux produit (en HH:MM:SS).
- Fréquence - Réglez cela sur Quotidienne. Les options Hebdomadaire ou Mensuelle ne doivent être utilisées que si vous êtes sûr que vous ne modifiez pas plus fréquemment que cela votre fichier de données produit.
Quand vous cliquez sur Sauvegarder la Configuration le fichier de données produit est exporté de Magento à Emarsys selon le calendrier que vous avez défini. A chaque exportation l'intégralité du fichier sera remplacée par la nouvelle version.
Données de ventes
Si vous utilisez Smart Insight, vous devrez vous assurer que vos données de ventes (commande) Magento sont correctement chargées sur la base de données Emarsys Smart Insight.
1. Le chargement de données de ventes initial
Vous devez d'abord faire une exportation en masse de vos données de ventes historiques. Pour faire cela, allez à Système > Configuration > Emarsys Connect > Smart Insight.
Si vous n'avez pas encore configuré votre serveur FTP comme décrit dans les Paramètres FTP ci-dessus, vous devez le faire maintenant.
- Smart Insight activé Réglez cela sur Oui.
- Exportation utilisant l'email comme identifiant Réglez cela sur Oui pour vous assurer de ne pas créer de doublons de contacts. Si le réglage est sur Non, l' Identifiant client sera utilisé, ce qui désactivera l'option Exporter les commandes d'encaissement d'invité (puisque nous n'avons pas d'Identifiants client pour les encaissements d'invité, seulement les adresses email).
- Exporter les commandes d'encaissement d'invité Sélectionnez Oui si vous voulez faire passer des données de commande anonymes à Smart Insight (elles seront utilisées pour améliorer l'affinité produit et d'autres variables).
- Exécuter à - Régler cela sur une heure fixe ne déclenchera pas d'exportation avant que le chargement de données initial ne soit complété. Par exemple, s'il est actuellement 14h, réglez-le sur 12h20. Il est important qu'aucun flux planifié n'arrive pendant que le chargement de données initial est en cours de traitement, sinon vous risquez de vous retrouver avec des doublons de données de ventes dans Emarsys.
- Inclure les bouquets de produits - Si c'est réglé sur Oui, cela intégrera les bouquets de produits au flux.
- Utiliser la monnaie de base dans l'exportation - On doit trouver ici la même valeur que pour Utiliser la monnaie de base dans les paramètres Collecte de données Web Extend. Cela assurera que les données collectées par Web Extend comme celles chargées par Smart Insight sont cohérentes en termes de monnaie et de langue.
- Calculer le prix du bouquet - A régler sur Oui si vous voulez inclure le prix total du bouquet dans le fichier de données.
Lorsque vous avez fait vos paramétrages, cliquez sur Générez maintenant pour exporter les deux dernières années de données de commande et les transmettre à Emarsys. Vous devriez vérifier que le fichier .csv créé contient toutes les commandes des deux dernières années avec tous les champs requis (identifiant produit, prix, quantité, etc.) correctement remplis.
2. Exporter les commandes par état
Les scripts de collecte Web Emarsys transmettrons la plupart de événements de données de ventes à Emarsys, mais certains événements ne sont pas repérés par ces scripts, par exemple les informations d'expédition, les dates de livraison prévue ou les méthodes de paiement via des fournisseurs tiers tels que PayPal.
Vous pouvez transmettre cette information à Emarsys et l'utiliser pour la segmentation Smart Insight ou comme partie d'un programme automatisé en intégrant ces états dans l'exportation.
Sur la même page, dans la section Etats de commande , sélectionnez les états pour lesquels les commandes doivent être exportées. Vous pouvez faire une sélection multiple en tenant enfoncée la touche CTRL.

Lorsque vous cliquez sur Sauvegarder la Configuration, Magento inclut les commandes qui sont passées par l'un des états sélectionnés au flux de synchronisation des données de ventes.
Cette fonctionnalité exporte simplement les données vers Emarsys. Vous devrez vous assurer que les bons champs existent dans la base de données Emarsys pour vous permettre d'exploiter ces données.
3. Paramètres de synchronisation des données de ventes
Lorsque vous avez fait votre exportation initiale, reconfigurez le champ Exécutez à à l'heure du jour ou la fréquence dont vous avez besoin, puis cliquez sur Sauvegarder la configuration.
Magento exportera toutes les commandes qui sont passées par l'un des états sélectionnés depuis la dernière exportation, à l'heure prévue.
Notes :
- Dans le fichier .csv les commandes qui ont une note de crédit sont aussi affichées, mais avec un prix négatif.
- Une fois les commandes exportées, la file d'attente est vidée de sorte que les mêmes commandes ne se retrouvent pas dans la prochaine exportation.
- Vérifiez que le fichier .csv produits est généré avec tous les produits liés aux commandes que vous avez créées et que tous les champs requis (identifiant produit, prix, quantité etc.) sont correctement remplis.
4. Bouquets Magento
Si vous réglez le champ sur Inclure les produits en bouquet sur Non, votre fichier d'exportation ne contiendra que les données de produit :

Si vous réglez le champ sur Oui, alors les Produits groupés incluront une ligne supplémentaire en plus des données produit :

Si vous réglez le champ Calculer le prix du bouquet sur Non, le prix de chaque article du bouquet est listé indépendamment et le prix du bouquet est mis à zéro :

Si vous réglez le champ sur Oui, le prix du bouquet affichera le total pour tous les articles du bouquet et les articles eux-mêmes verront leurs prix mis à zéro :

Vérifier l'installation
Pour vérifier que votre configuration fonctionne, faites les contrôles suivants.
Vérifier la synchronisation client vers Emarsys
- Créez un client à partir du programme expéditeur ou de l'interface Magento.
- Cliquez sur Exporter les clients
- Connectez-vous à votre compte Emarsys.
- Recherchez le client en utilisant l'option dans les contacts par email et en saisissant leur adresse email.
- Sur la page Résultats de recherche cliquez sur l'icône modifier pour ouvrir les propriétés du contact.
- Vérifiez si le même client est affiché ou pas.
Vérifier la synchronisation d'un abonné vers Emarsys
- Créez un abonné à partir du programme expéditeur ou de l'interface Magento.
- Cliquez sur Exporter les abonnés
- Suivez les étapes restantes telles que décrites ci-dessus.
Vérifier l'exportation de la commande du jour (valable aussi pour les commandes d'invité)
- Créez une commande d'invité à partir du programme expéditeur Magento.
- Créez une commande client à partir du programme expéditeur ou de l'interface Magento.
- Modifier l'état des deux commandes vers Traitement, Fermé ou Complété.
- Dans les paramètres Smart Insight, vérifiez que Exporter en utilisant l'email comme identifiant et Exporter les commandes d'encaissement d'invité sont tous deux réglés sur Oui.
- Exécutez l'exportation manuellement.
Vérifiez que le fichier .csv sales_items contient les deux commandes que vous avez créées ci-dessus avec tous les champs requis (identifiant produit, prix, quantité, etc.) correctement remplis.
Configurer vos messages transactionnels
Dans Magento vous pouvez définir certains messages transactionnels, par exemple un email de Lien de confirmation , un email de Bienvenue ou encore un email de Confirmation de commande. Ces messages peuvent être déclenchés dans Emarsys en associant les événements Magento à des événements externes Emarsys avant de lier ces derniers à une campagne Emarsys. Vous pouvez aussi associer des variables Magento à des espaces réservés dans Emarsys et personnaliser votre message.
1. Préparer vos campagnes Emarsys
Pour chaque événement Magento que vous souhaitez configurer, vous devrez créer les choses suivantes dans votre compte Emarsys :
- Un événement extérieur par événement Magento.
- Une campagne par événement extérieur. Ceux-ci doivent être créés directement dans l'interface de création de campagne pour ce canal (Email déclenché, SMS, Mobile Engage, etc.). Si vous avez l'intention de faire suivre le message initial d'autres actions, vous pouvez inclure ceci dans un programme du Centre d'Automatisation, mais ça n'est typiquement pas le cas pour les messages transactionnels.
- Une liste des espaces réservés de personnalisation que vous pouvez associer aux variables Magento pour chaque événement (voir ci-dessous).
2. Associez les événements entre Magento 1 et Emarsys
Lorsque vous avez préparé vos campagnes dans Emarsys, ouvrez le menu Emarsys Email .
Événements Magento
- Cliquez sur Evénements Magento pour afficher la liste des événements Magento par défaut, leur chemin de configuration et le modèle associé.
- Pour ajouter un modèle Magento à la liste, allez à Système > Emails transactionnels.
- Allez au chemin de configuration et sélectionnez le modèle requis à partir du menu déroulant.
- Le modèle sélectionné sera maintenant listé sous Événements Magento.
ÉVÉNEMENTS MAGENTO COMPATIBLES
Les événements Magento suivants sont supportés par l'intégration :
Formulaire de contact
Mise à jour de la note de crédit
Mise à jour de la note de crédit pour invité
Mot de passe administrateur oublié
Mot de passe oublié
Partage du registre de cadeaux
Mise à jour du registre de cadeaux
Mise à jour de la facture
Mise à jour de la facture pour invité
Nouvelle note de crédit
Nouvelle note de crédit pour invité
Nouvelle facture
Nouvelle facture pour invité
Nouvelle commande
Nouvelle commande pour invité
Nouveau RMA
Nouveau RMA pour invité
Nouvelle expédition
Nouvelle expédition pour invité
Nouveau compte
Clé de confirmation du nouveau compte
Nouveau compte confirmé
Confirmation d'abonnement à la Newsletter
Abonnement réussi à la Newsletter
Désinscription réussi de la newsletter
Mise à jour de commande
Mise à jour de commande pour invité
Commentaires de l'administrateur RMA
Commentaires de l'administrateur RMA pour invité
Autorisation RMA
Autorisation RMA pour invité
Commentaires client RMA
Rappeler le mot de passe
Mise à jour du solde des points de récompense
Alerte expiration des points de récompense
Envoyer le produit à un ami
Partager la liste de voeux
Mise à jour de l'expédition
Mise à jour de l'expédition pour invité
Mise à jour du crédit magasin
Événements Emarsys
- Cliquez sur Événements Emarsys pour afficher la liste des événements extérieurs Emarsys et leurs Identifiants. La liste sera vide la première fois que vous l'ouvrirez.
- Cliquez sur Mettre à jour le schéma pour remplir la liste d'événements Emarsys.
- Pour ajouter un événement Emarsys à la liste, ouvrez votre compte Emarsys et allez à Automatisation > Événements extérieurs.
- Créez-y votre événement extérieur. C'est une bonne idée de lui donner un nom le plus proche possible de l'événement Magento auquel vous l'associerez.
- De retour sur votre compte Magento, cliquez sur Mettre à jour le schéma pour rafraîchir la liste. Votre nouvel événement Emarsys devrait maintenant être visible.
Associer des événements
- Cliquez sur Association d'événement pour associer les événements Magento à leurs vis-à-vis Emarsys.
- Pour chaque événement Magento que vous voulez associer, sélectionnez l'événement Emarsys correspondant à partir du menu déroulant.
- Cliquez sur Sauvegardez l'association pour sauvegarder votre configuration.
- Si vous hésitez sur les événements à associer, cliquez sur Association recommandée. Cette fonctionnalité s'efforcera de trouver les bons événements Emarsys à partir de leurs noms.
L'association d'événement Emarsys fonctionne one-to-one par site Web. Cela signifie que si vous avez plusieurs boutiques dans votre compte Magento, vous devrez associer chacune séparément.
3. Personnaliser votre contenu email
Puisque vos contacts Magento sont synchronisés avec Emarsys, vous pouvez bien sûr intégrer à votre contenu email toutes les variables de personnalisation disponibles dans l'application Emarsys, y compris le contenu conditionnel et le ciblage de section. Toutefois, il se peut que des informations importantes sur l'événement qui déclenche l'email ne soient accessible que depuis Magento (par exemple, l'URL du lien de confirmation dans un email de confirmation).
Pour ajouter ce contenu Magento à votre email Emarsys, vous devez ajouter des caractères fictifs Magento spéciaux au contenu de l'email.
Dans votre compte Emarsys, ajoutez les caractères fictifs au contenu email, avec un double-% de chaque côté (par exemple, la variable first_name
doit être écrite dans le contenu email %%first_name%%
).
Ces balises Emarsys peuvent être n'importe quelle chaîne de texte et ne sont utilisées que pour s'assurer que les bonnes valeurs dans l'objet JSON sont ajoutées au bon endroit dans l'email. Ils ne référencent pas la base de données Emarsys et ne sont pas obligatoirement des chaînes identifiantes de champs Emarsys. Nous vous conseillons de leur attribuer un nom le plus proche possible des variables Magento auxquelles vous les associerez.
4. Configurer les caractères fictifs
Une fois que vous savez quels balises sont utilisées dans quels emails, et que vous avez associé les événements correspondants, vous devez associer les variables Magento aux balises Emarsys. Vous devrez le faire pour chaque événement Magento.
- Sur la page Association d'événement Magento Emarsys , cliquez sur Balises à côté de l'événement en question.
- Pour chaque variable Magento, ajoutez la balise Emarsys correspondante.
- Cliquez sur Sauvegarder l'association.
5. Vérifier le JSON
Il est conseillé de vérifier la charge utile JSON qui sera transmise à Emarsys, pour s'assurer que toutes les balises ont été configurées correctement. Cliquez sur Requête JSON à côté de chaque événement pour afficher l'objet. Vous pouvez maintenant vérifier les balises et voir exactement quelles données sont transmises à Emarsys sans avoir à vous référer aux enregistrements.
6. Activer les campagnes transactionnelles
Une fois que vous avez associé vos événements et vos champs, vérifiez que vos campagnes email sont correctement configurées dans Emarsys.
- Dans votre compte Emarsys, pour chaque campagne ouvrez les Paramètres Email. Assurez-vous que la Source destinataire est réglée sur Générée par un événement puis sélectionnez l'événement extérieur adéquat.

- Assurez-vous que la Panification de campagne, est réglée pour un lancement Exactement à l'événement.

Dans votre compte Magento, allez à Système Configuration et à partir du menu de gauche sélectionnez Configuration client.
- Pour chacune des options disponibles vous pouvez définir un email transactionnel. Dans cet exemple nous examinons Créer de nouvelles options de compte, qui a trois emails de bienvenue intégrés dans un processus d'inscription à double opt-in.
- Sous Emails de bienvenue par défaut, sélectionnez le modèle que vous voulez utiliser et cliquez sur Sauvegarder la Configuration.
- Répétez cette étape pour l' Email du lien de confirmation et l' Email de bienvenue.
Les campagnes email Emarsys associées au modèle se déclencheront maintenant à chaque fois que le déclencheur correspondant est activé dans Magento.
7. Activer les messages transactionnels
Lorsque vous avez terminé votre association, allez à Système > Configuration > Emarsys Connect > Configuration d'email transactionnel et activez cette fonctionnalité.

- Dans le menu déroulant Activer les emails transactionnels Emarsys , sélectionnez Oui.
- Cliquez sur Sauvegardez la configuration pour sauvegarder les paramètres.
A partir de là, tous les événements associés dans Magento déclencheront l'événement extérieur correspondant dans Emarsys. Vous pouvez ensuite lier ces événements à l'action de votre choix dans Emarsys (par exemple lancer dans campagnes email, SMS ou Mobile Engage).
Entretenir l'intégration
La surveillance des données dans Emarsys
Une fois que vous avez fait vos premiers chargements de données et réglé le calendrier pour la synchronisation régulière de nouvelles données, vous pouvez tirer profit des outils de surveillance de données fournis par Emarsys pour vous assurer que le flux de données fonctionne correctement.
Ces outils valident chaque importation de données vers Emarsys. Si un problème est identifié, il est signalé et une solution vous est suggérée.
Les outils sont situés dans votre application Emarsys à la Page Sources de données.
Nouvelles versions du plugin
S'il existe une nouvelle version de cette intégration, vous en serez informé par des notifications Magento. Un lien sera fourni au Répertoire Emarsys GitHub où vous pouvez télécharger la dernière version. Vous devrez ensuite suivre les étapes décrites ci-dessus dans Installer le module Emarsys. Aucun de vos paramètres et configurations ne sera affecté.
Mettre à jour votre schéma Magento en continu
Si vous créez de nouveaux actifs (champs, événements externes, etc.) dans Emarsys, vous en serez informé via les notifications Magento.
Vous pouvez mettre à jour votre interface Magento à tout moment en cliquant sur Mettre à jour le Schéma sur n'importe quelle page où cela apparaît.
Résolution des problèmes
Association de champ
Lorsque vous cliquez sur le menu déroulant Association de champ sur la page Synchronisation des contacts , si vous voyez le message Aucun champ disponible dans la Suite Emarsys pour ce site Web (veuillez vérifier la configuration API) cela signifie que vous avez un slash (/) en trop au bout de votre URL d'API personnalisée. Il vous faut le supprimer.
Exporter des données de contact
Lorsque vous essayez de synchroniser manuellement des champs de données de contact et que l'exportation se bloque, vous devez d'abord vérifier que vos paramètres cron sont corrects. S'ils en ont l'air, videz alors le cache Magento 1 entièrement.
Données de session incohérentes dans Emarsys
Si en testant l'intégration (ou après), vous trouvez que des données sont attribuées à la mauvaise session ou au mauvais contact, c'est peut-être que votre Web Extend est mis en cache. Vous devez ouvrir les paramètres Web Extend (Système menu > Configuration > Emarsys Connect > Web Extend) et vous assurer que les options Utiliser la mise à jour Ajax ou Utiliser jQuery sont activées de manière pertinente.