Ce guide concerne notre intégration historique Magento 2, qui était utilisée jusqu'en Novembre 2018. Nous vous recommandons maintenant d'utiliser notre nouveau plug-in qui automatise la plupar des étapes d'intégration.
Vous trouverez ici toutes les informations dont vous avez besoin pour installer l'intégration Emarsys pour Magento 2 et la faire fonctionner. Certaines étapes ne concernent que les utilisateurs de Smart Insight ou de Predict et sont clairement indiquées.
Ce guide part du principe que vous possédez déjà un exemplaire de Magento 2 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 2 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.
- Implémentation en un clic du cadre Web Recommender (pour les clients Predict).
- 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 2
Il faudra que Magento vous fournisse :
- Une boutique Magento de la version 2.1.x ou plus.
- Les versions versions 5.6.0 et 7.0.17 de PHP.
- php5-curl doit être installé sur votre serveur Magento.
- L'extension PHP SOAP doit être activée.
- Le module Sabre/DAV doit être installé dans Magento.
- Le port TCP 21, 32000-35000 doit être ouvert (c'est obligatoire pour que le fichier soit transféré au FTPES).
- Réglez vos couronnes Magento pour tourner toutes les minutes.
- 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/code/Emarsys/Emarsys/view/frontend/templates/emarsys/javascripttracking.phtml. C'est là que résideront les scripts de collecte de données dynamiques et l'antémémoire perturbera leur fonctionnement.
- Assurez-vous que lorsqu'un article est ajouté à un panier dans votre boutique Magento, ceci déclenche un rafraîchissement de la page. C'est absolument nécessaire pour le bon fonctionnement des scripts de collecte de données Web Extend.
2. Conditions pour Emarsys
Il faudra qu'Emarsys vous fournisse :
- 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 demander un compte Emarsys séparé pour chacun d'entre eux.
S'il y a plusieurs boutiques Magento sur même site, elles seront associées au même compte Emarsys.
- Votre Identifiant de marchand Emarsys (vous la trouverez à la page Admin menu > Sources de données dans votre compte Emarsys).
- Votre dossier et vos références WebDAV Emarsys (pour le téléchargements des données de contact initial et les exportations groupées).
- 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 (disponible au téléchargement ici ou sous forme de fichier compressé auprès du Support Emarsys).
- 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 client unique Magento
- Identifiant de souscripteur Magento
Vous pouvez créer ces champs personnalisés dans Emarsys, ou bien attendre la fin de l'installation puis les créer à partir de la page Checklist d'installation dans Magento. Note : Les noms de fichier sont sensible à la casse. Par exemple, l' Identifiant client Magento ne sera pas accepté par l'intégration.
3. Support multi-boutiques
Si vous connectez différentes boutiques Magento situées dans différents lieux et opérant avec différentes langues et différentes monnaies au même compte Emarsys, nous devons pouvoir comparer le comportement client et les données e-commerce entre ces boutiques.
Dans ce but, votre catalogue produit doit inclure les valeurs dans toutes les langues que vous employez, et toutes vos données e-commerce (produit et ventes) et de comportement Web doivent être envoyées à Emarsys dans la même monnaie et la même langue. Veuillez de plus noter :
- Catalogue produit - Pour toutes vos boutiques Magento ou sites Web configurés avec les mêmes identifiants API, un seul flux de données produit sera créé, intégrant les valeurs localisés pour chaque colonne qui le nécessite. Vous n'avez besoin de rien faire en dehors de vous assurer que les mêmes identifiants API sont utilisés. Voir Préparer votre catalogue produit : Localisation pour plus d'informations.
- Données E-commerce et de comportement - Pour vous assurer que les données produit et de ventes sont collectés et analysées de manière cohérente, vous devez configurer la Monnaie d'usage de base sur Oui en activant la collecte de données Web Extend. Cela convertira tous les prix dans la monnaie de votre boutique Magento par défaut.
- Données Web Extend : la langue - La commande
Catégorie
sera envoyée dans la langue de votre boutique Magento par défaut.
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, rendez-vous à emarsys/app/code/Emarsys puis copiez le dossier Emarsys dans votre registre app/code dans Magento.

Vous devrez peut-être créer le sous-fichier approprié sur votre serveur Magento 2 et au bout du compte le chemin ressemblera à cela : /var/www/html/magento2/app/code/Emarsys/Emarsys.
A ce moment-là vous devrez aussi vous assurer que tous les dossiers contenus dans la racine du projet Magento sont configurés pour pouvoir écrire, et qu'ils doivent être la propriété à la fois de l'utilisateur Magento et du groupe d'utilisateur appache2, par exemple : magento:www-data.
S'ils ne sont pas la propriété du groupe d'utilisateur apache2, des erreurs se produiront.
- Ouvrez une ligne de commande, ouvrez le registre d'installation Magento 2 (par exemple /var/www/html/magento2 dans l'exemple ci-dessus) et lancez la commande suivante pour installer les dépendances WebDAV : composer require sabre/dav ~3.2.0.
- Dans le même dossier, lancez alors la commande : composer Update.
- Dans le marché Magento, saisissez vos clés d'authentification Magento (les publiques comme les privées). Vous trouverez les instructions pour réaliser cela ici.
- Installez maintenant le module Emarsys avec la commande : php bin/magento setup:upgrade.
- Déployez ensuite le reste des fichiers requis (js et autres fichiers statiques) vers le dossier pub avec la commande : php bin/magento setup:static-content:deploy.
- Mettez à jour les autorisations pour les dossiers var et pub avec la commande : sudo chmod 777 -R var pub.
- Enfin, videz la mémoire cache avec la commande : php bin/magento cache:flush.
Après l'installation, vous devez re-vérifier vos autorisations de dossier, car souvent de nouveaux dossiers ou de nouveaux fichiers sont indiqués comme groupe d'utilisateur principal de Magento à la place du groupe apache2 www-data, entraînant des erreurs.
Si c'est le cas, vous pouvez résoudre ce problème manuellement en les assignant à nouveau au bon groupe. Si cela arrive, n'oubliez pas d'examiner soigneusement les registres d'erreur.
2. Vérifiez l'installation
Une fois que vous avez lancé les commandes décrites ci-dessus, vous pouvez vérifier l'état de votre système Magento avant d'aller plus loin. Vous pouvez faire cela via le nouveau menu Emarsys disponible dans votre programme d'arrière-plan Magento.

Ouvrez le menu Emarsys et allez à Opérations> Checklist d'installation. Vous pouvez voir ici l'état de votre installation.

- Conditions Système - Vérifie que les Pré-requis Magento ont été respectés.
- Paramètres d'extension - Ceux-ci vont d'abord afficher les valeurs par défaut définies par le paquet d'installation. Vous les configurerez selon vos préférences à un stade ultérieure du flux de travail d'installation.
- Champs de client Emarsys obligatoires - Affiche Oui si les champs ont été trouvés et mappés par l'extension pendant l'installation. Dans le cas contraire, vous pourrez les créer dans Emarsys, directement à partir de la checklist.
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.
Les scripts Web Extend scripts sont initiés pendant le chargement de page. Il est par conséquent crucial que votre boutique Magento déclenche un rafraîchissement de page à chaque fois qu'un produit est ajouté à un panier.
Pour activer ces scripts, ouvrez le menu Emarsys et allez à Paramètres > Web Extend, puis effectuez les paramétrages suivants.
- Activer l'Intégration JavaScript de Web Extend ? - Réglez ceci 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 n'avez pas réussi à interdire au chemin du modèle la mise en antémémoire comme décrit dans les besoins pour Magento 2 ci-dessus, cela vous aidera à empêcher les données Web Exend d'être mises en antémémoire.
- Si Oui, le rafraîchissement côté navigateur des recommandations de produit est activé et aucune donnée Web Extend ne sera enregistrée en mémoire cache.
- 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.
4. Activez les recommandations produit
Si vous êtes un client Predict, vous pouvez aussi définir quels widgets seront utilisés pour afficher les recommandations produit sur vos différentes pages Web.
Pour ce faire, ouvrez le menu Emarsys et allez à Paramètres> Predict.
Pour chaque type de page, sélectionnez le widget que vous voulez y installer.
Pour plus d'informations, voir Le Web Recommender Predict.
4.1 Personnaliser les recommandations de produit
Il se peut que le widget de recommandation de produit par défaut jure avec le style de votre identité visuelle. Pour en changer le style, faites comme suit :
- Localisez le fichier de recommandation sur le chemin suivant : app/design/frontend/Package/Theme/Emarsys_Emarsys/templates/emarsys/recommendations.phtml
- Faites les modifications et sauvegardez le fichier.
Pour déplacer ce contenant de recommandation à la position de votre choix sur la page, utilisez la commande suivante dans vos fichiers de mise en page :
<move element="emarsys.wrapper" destination="page.bottom.container" after="-" />
où destination
est le nom du bloc/contenant.
Configurer les connexions Emarsys
Emarsys pour Magento 2 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.
- L'API du Catalogue produit est utilisée pour synchroniser le catalogue produit. Les paramètres de configuration afférents sont décrits dans Paramètres de l'API du catalogue produit.
- L'API Smart Insight est utilisée pour synchroniser les données de ventes (commande). Les paramètres de configuration afférents sont décrits dans Paramètres de l'API Smart Insight.
- Un serveur WebDAV est obligatoire pour les téléversements de données de contact groupés (y compris le chargement de données initial).
- Un serveur FTP est nécessaire pour les chargements en masse de données e-commerce.
L'intégration préférera toujours utiliser une API plutôt qu'un serveur de fichier quand c'est possible. En d'autres termes, si vous avez configuré une API et un serveur de fichier, c'est l'API qui sera utilisée.
Pour configurer les connexions Emarsys, ouvrez le menu Emarsys et allez à Paramètres > Connexion .

1. Paramètres de l'API
Dans la section Paramètres d'API Emarsys , faites les paramétrages suivants :
- Activés Réglez le sur Oui pour activer le plugin.
- Point d'extrémité d'API Cela peut être l'une des valeurs suivantes :
- 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.
- Nom d'utilisateur pour l'API et Mot de passe pour l'API 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.
Si une connexion a été établie avec succès entre Magento et votre compte sur la Plateforme Marketing Emarsys, vous verrez un message de confirmation jaune apparaître en haut de la page :

Si aucune connexion ne peut être établie, vous verrez un message d'erreur à la place :

2. Paramètres WebDAV
Dans la section Paramètres WebDAV , faites les paramétrages suivants :
- URL WebDAV, Utilisateur WebDAV et Mot de passe WebDAV - Saisissez les identifiants WebDAV qui vous ont été fournis par le Support Emarsys. 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 WebDAV.
- 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.
Si une connexion a été établie avec succès, vous verrez le message de confirmation en haut de la page.
3. Paramètres FTP
Une connexion FTP est nécessaire pour les utilisateurs Smart Insight et Predict. Dans la section Paramètres FTP , faites les paramétrages suivants :
- Nom de l'hôte, Port 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 d'Exportation Groupée - Si vous avez créé un sous-répertoire sur le serveur pour séparer les exportations groupées (manuelles) des exportations programmées habituelles, 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 pour sauvegarder vos paramètres.
- Cliquez sur Tester la connexion pour vérifier que vous avez saisi ces identifiants correctement. 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 2
Magento 2 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 2 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.
Vous devrez vous assurer que les contacts Magento (clients et abonnés) sont correctement synchronisés avec votre base de données contact Emarsys, et que les bons champs sont mappés pour vos conditions de segmentation.
2. Configuration du champ de données de contact
Magento 2.0 n'exige plus la configuration séparée des champs de données clients et abonnés. A la place, vous allez répertorier d'abord tous les champs de données contact, puis les valeurs pour les champs à choix unique et multiples. La configuration que vous définissez ici sera utilisée à la fois pour le téléchargement de données initial et toutes les synchronisations ultérieures, pour les deux types de contact.
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.
Pour les deux configurations vous pouvez économiser 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.
Si vous possédez plus d'une boutique Magento, vous devrez répéter ces étapes pour chaque boutique séparément.
Pour associer vos champs de données de contact, ouvrez le menu Emarsys et allez à > Configurations > Client.
- Si vous avez plus d'une boutique, sélectionner la bonne à partir de menu déroulant Vue de la boutique :

- Dans le menu déroulant Sélectionner la configuration , sélectionnez Client. Vous verrez alors toutes les caractéristiques client Magento et pourrez les associer aux caractéristiques Emarsys (champs de données de contact).
- Si vous ne l'avez pas encore fait, cliquez sur Mettre à jour le Schéma pour vous assurer que tous vos champs Emarsys sont accessibles dans la colonne Caractéristiques de client Emarsys.
- Pour chaque Caractéristique client Magento , sélectionnez le champ Emarsys approprié dans le menu déroulant. Vous pourrez rechercher une caractéristiques particulière à l'aide du champ Rechercher .
Assurez-vous de répertorier des champs Emarsys de même type. Si le type de champ n'est pas adapté aux données, vous rencontrerez des problèmes à la création de segments basés sur ces champs dans Emarsys.
- Lorsque vous avez fini, sauvegardez vos modifications pour afficher la nouvelle configuration.
- Sélectionnez maintenant le Champ-Client dans le menu déroulant Sélectionner la configuration.
- Tous les champs à choix unique et multiples configurés apparaissent et vous devez maintenant configurer les valeurs pour chacun d'entre eux.
3. Préparer l'auto-importation Emarsys
Une fois que vous aurez répertorier tous vos champs, vous devrez installer deux auto-importations dans votre compte Emarsys, une pour les clients Magento et une autre pour les abonnés.
Dans votre compte Emarsys, ouvrez le menu Contacts > Auto-importations et faites les paramétrages suivants :
Paramètres du fichier source (la première page de l'assistant)
- Où chercher le fichier d'importation - Sélectionnez Emarsys WebDAV et saisissez le chemin.
- Paramètres du fichier d'importation / Nom du fichier - Les fichiers de téléchargement Magento initiaux seront nommés customers_<timestamp>.csv et subscribers_<timestamp>.csv, vous devrez donc saisir customers_*.csv et subscribers_*.csv pour vos deux profiles d'auto-importation.
Échantillon (deuxième page)
- Il vous faudra télécharger un fichier échantillon contenant l'en-tête et au moins une ligne du fichier que vous utiliserez pour votre chargement initial, avec tous vos champs configurés. Votre système de classification vous le fournira peut-être, sinon vous pouvez faire une exportation initiale vers le WebDAV et utiliser ce fichier.
Associez les champs (troisième page)
- Vérifiez que les champs sont correctement configurés et sélectionnez votre identifiant unique.
Lorsque vous avez fini, assurez-vous que le statut est réglé sur Activé sur les Auto-importations de la page d'aperçu.
Les mêmes auto-importations seront aussi utilisées pour le mécanisme de sécurité-défaut de la synchronisation de contact (voir ci-dessous). Après la réalisation du chargement initial, vous serez peut-être bien avisé de retourner à votre auto-importation Emarsys pour en modifier le nom afin de distinguer les importations ultérieures de la première.
4. 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.
Si votre base de données de contact contient moins de 10 000 fichiers, le chargement de données initial se fera avec l'API Emarsys. Dans le cas contraire il utilisera le WebDav pour le transfert de fichier.
Ouvrez le menu Emarsys et allez à Paramètres> Synchronisation de contact.

- Dans la section Chargement DB initial sélectionnez le statut d'opt-in à appliquer aux contacts que vous importerez parmi :
- Régler le statut d'opt-in pour tous les utilisateurs sur vrai - Permet à Emarsys d'envoyer directement à tous les contacts importés. Nous recommandons de ne PAS utiliser cette option car vous risquez d'envoyer des campagnes à des contacts qui ne s'y sont pas explicitement abonnés.
- Régler le statut d'opt-in pour tous les utilisateurs sur vide - Vous ne pouvez envoyer à aucun contact depuis Emarsys avant que leur opt-in ait été confirmé par une autre méthode (double opt-in).
- Configurez le statut d'opt-in sur "true" pour tous les utilisateurs en fonction de la caractéristique - Vous pouvez faire passer la valeur d'opt-in de Magento à
TRUE
pour vos clients Magento selon la valeur fournie par Magento dans la caractéristique Statut abonné.
La sélection multiple n'est pas disponible actuellement pour ce menu déroulant, donc vous devez répéter l'exportation pour chacune des différentes valeurs de Statut abonné .
- Cliquez sur Exporter pour synchroniser tous vos clients Magento vers Emarsys.
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é.
Ne sauvegardez aucun des Paramètres de synchronisation contact avant de réaliser le chargement initial, car cela lancera immédiatement la synchronisation des données selon votre calendrier, et pourrait se terminer par l'effacement de vos données au moment du chargement initial.
5. 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.
Si vous apportez une modification quelconque à la configuration du champ, les nouveaux champs seront synchronisés pour les nouveaux contacts seulement. Pour mettre à jour les nouveaux champs pour les contacts existants, vous devrez lancer une autre exportation groupée (voir Entretenir l'intégration ci-dessous).
Il existe deux méthodes pour maintenir la synchronisation de vos données de contact, En temps réel-sécurité-défaut et Arrière-plan.
- Mode sécurité-défaut en temps réel (recommandé)- Ceci entretien la synchronisation du contact en temps réel à l'aide de l'API Emarsys, envoyant chaque mise à jour à Emarsys 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). En cas d'échec de mises à jour (dus par exemple à un temps d'arrêt du réseau ou un volume en excès), elles sont placées dans une queue de sécurité-défaut et sont traitées une fois par jour en selon les paramètres de votre d' Horaire d'exécution en arrière-plan et de Fréquence d'arrière-plan.
Pour activer cette option, réglez En temps réel-sécurité-défaut sur Oui. - Arrière-plan seul - Ceci collecte et met en attente toutes les mises à jour de contact et les synchronise selon vos paramètres d' Horaire d'exécution en arrière-plan et de Fréquence d'arrière-plan , en utilisant votre dossier WebDAV Emarsys. 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é.
Pour activer cette option, réglez En temps réel-sécurité-défaut sur Non. - Horaire d'exécution en arrière-plan- Vous saisissez ici l'heure du jour (en HH:MM:SS) à laquelle votre exportation sécurité-défaut sera exécutée (si vous utilisez l'option Sécurité-défaut en temps réel, ou à laquelle a lieu votre exportation d' Arrière-plan habituelle.
- Fréquence d'arrière-plan Vous avez le choix entre un rythme Quotidien et Horaire. Si vous sélectionnez horaire, la synchronisation tournera une fois par heure, au moment précis défini ci-dessus en minutes et secondes après l'heure.
- Champ unique- C'est l'identifiant unique qui assurera que les données sont synchronisées avec le bon contact dans Emarsys. Vous pouvez le composer à partir de l'adresse email, de l'identifiant Magento ou d'une combinaison d'adresse email, d'identifiant de site Web et d'identifiant de boutique.

Email#IdentifiantSiteWeb#IdentifiantBoutique est l'option que nous recommandons, mais gardez à l'esprit que si vous possédez diverses boutiques, cela créera des contacts Emarsys séparés par boutique, même s'il s'agit du même acheteur.
Après avoir installé le Champ Unique et synchronisé votre premier contact, ce réglage ne peut être modifié.
- Clé secrète de notification- Vous pouvez saisir ici n'importe quel mot de passe ou secret de votre choix. Il s'agit purement d'un code de sécurité interne pour protéger vos fichiers de données d'une interférence extérieure.
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.
6. Paramètres d'Opt-in
Vous devez maintenant définir la manière dont votre boutique Web gère les opt-ins et les opt-outs. Les événements réels qui déclenchent les messages de confirmation d'opt-in sont associés lorsque vous configurez vos messages transactionnels, comme décrit ci-dessous. Pour configurer votre stratégie d'opt-in, allez à Emarsys > Paramètres > Opt-in.

- Activer l'Opt-in - Si ceci est réglé sur Oui, vous remplacez les paramètres d'opt-in Magento par défaut par les paramètres que vous configurez dans cette intégration et pouvez déclencher des messages de confirmation en provenance d'Emarsys.
- Stratégie d'Opt-in - Vous disposez de deux options :
- Double-Opt-In- C'est notre méthode de prédilection car elle garantit que la personne qui s'abonne est la même que celle qui possède l'adresse email utilisée. On vous demandera d'associer deux événements Emarsys pour vos emails transactionnels - le premier pour déclencher l'email de confirmation et le second pour mettre à jour le statut d'opt-in après que le client aura cliqué sur le lien de confirmation.
- Opt-In-unique - Il vous suffit d'associer cet événement unique pour mettre à jour le statut d'opt-in immédiatement.
- Abonnement à la newsletter au moment du règlement - Ceci vous permet d'ajouter une case à cocher pour adhérer à la newsletter sur votre page de règlement. Collez le fragment de code sur votre page de règlement comme indiqué et l'information d'adhésion sera transmise à Emarsys.
Il est fortement conseillé de gérer l' état d'opt-in autant que possible dans Emarsys. Si vous modifiez l'état dans Magento, cela peut prendre jusqu'à 24 heures pour atteindre Emarsys dans le cas d'une synchronisation d'arrière-plan ou de sécurité-défaut. Pendant ce temps le contact peut éventuellement recevoir d'autres emails.
7. Quelles données sont synchronisées ?
- De Magento à Emarsys- La base de données contact de Magento est considérée comme la base de données maîtresse en ce qui concerne les informations de contact, et toutes les valeurs synchronisées pour les champs associés remplaceront les valeurs existantes dans l'application Emarsys.
Les nouveaux contacts seront exportés vers Emarsys avec les mêmes champs que pour l'exportation initiale. - D'Emarsys à Magento Une fois par jour, à l'horaire d'exécution en l'arrière-plan spécifié, Emarsys vérifie aussi qu'aucun champ d'Opt-in d'aucun contact Magento n'a été modifié. Dans ce cas-là, cette modification est synchronisée en retour vers Magento.
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 votre catalogue produit Magento est correctement chargé, et régulièrement synchronisé, sur Emarsys.
A la différence des données de contact et de ventes, l'intégralité (et pas seulement le delta) du catalogue produit est toujours actualisée. C'est pourquoi le chargement initial et la synchronisation continue sont en fait le même processus.
La méthode recommandée pour ce faire est d'utiliser l' API du catalogue produit. Si vous employez une autre méthode, vous devez configurer le serveur FTP comme décrit ci-dessus, et vous devrez aussi configurer quelques paramètres sur la page Données de produit de votre compte Emarsys. Si les deux méthodes sont configurées, l'API sera utilisée.
1. Paramètres d'API du catalogue produit
Pour configurer l'API du Catalogue produit, ouvrez le menu Emarsys et allez à Paramètres > Catalogue produit puis faites dérouler jusqu'au bas de la page.

- Activer l'Exportation d'API - Réglez cela sur Oui.
- Identifiant Marchand - Saisissez votre Identifiant marchand Emarsys, que vous trouverez dans votre compte Emarsys à la page Menu admin > Sources de données, dans la case Informations de compte sur la droite.
- Jeton de porteur - Saisissez votre jeton de porteur, que vous pouvez récupérer dans votre compte Emarsys au menu Admin > Sources de données > page Données de ventes , quand vous cliquez sur Afficher les détails du téléversement de l'API.
2. Associez les attributs au produit
Vous devez associer vos champs de caractéristiques produit Magento aux champs de données de produit Emarsys corrects, pour vous assurer que votre catalogue produit a les bonnes colonnes et les bons types de champ, en conformité avec nos standards de catalogue produit. Pour plus d'informations, veuillez consulter : Préparer votre fichier de Données Produit.
Pour associer vos caractéristiques produit, allez à Emarsys > Configurations > Produit. Si vous avez plus d'une boutique, sélectionnez la bonne à partir de menu déroulant Vue de la boutique :
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 requis ici. Il devient alors immédiatement disponible dans le menu déroulant qui énumère les champs ouverts au mapping. Le préfixe
c_
sera ajouté au nom de champ, ce qui assure que l'en-tête sera automatiquement créé en tant que champ personnalisé dans votre base de données produit Emarsys. - 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 pour sauvegarder vos paramètres.
3. Configurer le flux de données produit
Une fois que vous avez associé vos champs de données produit, configurez le calendrier de synchronisation de votre catalogue produit. Pour ce faire, allez à Emarsys > Paramètres > Catalogue produit.
Si vous avez besoin de téléverser votre catalogue immédiatement, vous pouvez le faire en faisant une exportation groupée.
- Activer l'exportation nocturne du flux produit - Réglez cela sur Oui.
- Inclure les bouquets de Produits - Si c'est réglé sur Oui, cela intégrera les bouquets de produits au flux.
- Exclure des catégories - Si vous voulez exclure des catégories de produit quelconques du catalogue, sélectionnez les à partir de la vue en arborescence.
- Exécuter et exporter à - Règle l'heure de la journée pour le flux produit (en HH:MM:SS).
- Fréquence - Réglez-la sur Horaire ou bien Quotidienne, en fonction de vos besoins.
- Horaire - Recommandé si votre catalogue produit change plusieurs fois par jour. C'est aussi l'option recommandée pour les fonctionnalités telles que le Panier Abandonné Predict.
- Quotidienne - Si votre catalogue produit est très fourni, ou change moins fréquemment, sélectionnez cette option pour réduire la charge sur votre système.
Quand vous cliquez sur Sauvegarder la Configuration le catalogue produit est exporté de Magento à Emarsys selon le calendrier que vous avez défini. A chaque exportation l'intégralité du catalogue sera remplacé 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 Smart Insight Emarsys et que les bonnes catégories sont configurées pour vos conditions de segmentation Smart Insight.
La méthode recommandée pour ce faire est d'utiliser l' API Smart Insight. Si vous n'utilisez pas cette méthode, vous devez configurer le serveur FTP comme décrit ci-dessus. Si les deux méthodes sont configurées, l'API sera utilisée.
1. Paramètres d'API de Smart Insight
Si vous utilisez l'API Smart Insight, allez à Emarsys >Paramètres > Smart Insight et faites défiler jusqu'aux Paramètres de l'API Smart Insight.

- Activer l'Exportation d'API - Réglez cela sur Oui.
- Identifiant Marchand - Saisissez votre Identifiant marchand Emarsys, que vous trouverez dans votre compte Emarsys à la page Menu admin > Sources de données, dans la case Informations de compte sur la droite.
- Jeton de porteur - Saisissez votre jeton de porteur, que vous pouvez récupérer dans votre compte Emarsys au menu Admin > Sources de données > page Données de ventes , quand vous cliquez sur Afficher les détails du téléversement de l'API.
- Nombre de fichiers maximum - Ceci définit combien de fichiers sont transférés par appel API. Vous pouvez choisir dans une fourchette de 100 à 10 000 fichiers, en fonction de vos besoins.
2. Associer les caractéristiques de commande
Allez d'abord à Emarsys> Configurations> Commande. Vous donnez ici aux colonnes de commande Magento les noms qui apparaîtront sur les écrans Smart Insight en tant que caractéristiques d' Achat.
Il y a un ensemble de colonnes déjà configurées fixé par défaut - celles-ci sont nommées dans la colonne Caractéristique de commande Emarsys et ne peuvent pas être modifiées.
Vous pouvez ajouter n'importe quelle autre colonne à l'exportation en saisissant un nom de caractéristique. Si vous laissez ce champ vide, cette colonne ne sera pas intégrée au fichier d'exportation.
3. Le chargement de données de ventes initial
Une fois que vous avez nommé toutes les colonnes dans le fichier d'exportation, vous devriez réaliser l'exportation groupée de vos données de ventes historiques. Pour ce faire, ouvrez le menu Emarsys et allez à Opérations> Exportation groupée.

- Type d'entité d'exportation - Sélectionnez Commande.
- Les champsDe et A - Sélectionnez la période relative aux données de commande Magento. Il n'y a aucune limite aux données que vous pouvez exporter, mais nous recommandons d'inclure au moins les deux dernières années si vous pouvez.
- Exporter vers - Sélectionnez CSV.
Cliquez sur Exporter. Les données de commande Magento seront alors chargées sur la base de données Smart Insight et seront exploitables pour la segmentation Smart Insight dans Emarsys.
Ne sauvegardez aucun des Paramètres Smart Insight avant de réaliser le chargement initial, car cela lancera immédiatement la synchronisation des données selon votre calendrier, et pourrait se terminer par le redoublement du chargement de certaines données de ventes au moment du chargement initial. Smart Insight ne re-duplique pas les données de ventes et les commandes répétées auront un impact négatif sur votre score eRFM et votre modèle de données e-commerce en général.
4. Paramètres de synchronisation des données de ventes
Après votre chargement de données de ventes initial, vous devez configurer le chargement continu de nouvelles données de ventes. Pour ce faire, allez à Emarsys> Paramètres> Smart Insight.
- Smart Insight Activé - Réglez cela sur Oui.
- Exporter en utilisant l'email comme identifiant - Si cela est réglé sur Oui, l'adresse email du contact Magento sera ajoutée au fichier d'exportation et utilisée pour associer les données de ventes à un contact Emarsys, à la place de l'identifiant de client Magento. Cela a son importance si vous incluez les abonnés Magento à vos campagnes marketing, puisque vous ne possédez pas d'identifiant client Magento les concernant.
- Exporter les commandes de règlement d'invités - Définit si les commandes d'invités (anonymes) seront exportées ou pas. Elles ne peuvent être utilisées pour la segmentation Smart Insight mais vous aideront à améliorer le modèle d'affinité produit.
- Fréquence - Horaire ou Quotidien. Nous vous conseillons de choisir une fréquence horaire, car cela permettra d'opérer sur des fichiers de taille réduite.
- Exportation de commande pour les statuts- 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. Pour utiliser cette information dans Emarsys, sélectionnez les statuts pour lesquels les commandes doivent être exportées. Vous pouvez faire une sélection multiple en tenant enfoncée la touche CTRL.
Quand vous cliquez sur Sauvegarder la configuration, Magento exporte toutes les commandes qui sont passées par l'un des états sélectionnés depuis la dernière exportation, au moment désigné.
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.
Vérifier l'installation
Abonnés
Pour tester le bon fonctionnement de la synchronisation d'abonné, procédez comme suit :
- Naviguez vers le devant de votre boutique Magento.
- Faites défiler jusqu'en bas.
- Saisissez une adresse email dans la case d'abonnement à la newsletter. Vous devriez recevoir ensuite un message confirmant la réussite de l'opération.
- Allez au panel admin Magento.
- Sous Marketing > Abonné à la newsletter, un registre d'abonné a été ajouté.
- Connectez-vous à votre compte Emarsys.
- Dans le coin en haut à droite, sélectionnez recherche.
- Tapez l'adresse email pour effectuer une recherche par email.
- Vous devriez voir un enregistrement synchronisé avec la valeur d'opt-in true (opt-in unique).
Contacts
Pour tester le bon fonctionnement de la synchronisation de contact, procédez comme suit :
- Naviguez vers le devant de votre boutique Magento.
- Cliquez sur Enregistrer le compte.
- Saisissez les informations comme prénom, nom et adresse email puis cliquez sur S'inscrire, . Vous devriez recevoir ensuite un message confirmant la réussite de l'opération.
- Allez au panel admin Magento.
- Sous Clients > Tous les clients, un registre de client a été ajouté.
- Connectez-vous à votre compte Emarsys.
- Dans le coin en haut à droite, sélectionnez recherche.
- Tapez l'adresse email pour effectuer une recherche par email.
- Vous devriez voir un enregistrement synchronisé avec Emarsys contenant tous les détails saisis.
Données de produit
Pour tester le bon fonctionnement de la synchronisation des données de produit, procédez comme suit :
- Ajoutez un nouveau produit à votre magasin Magento.
- Attendez que les données produit soient synchronisées (selon votre configuration).
- Recherchez les données dans Emarsys pour vérifier que le nouveau produit a été importé correctement.
Emails transactionnels
Pour tester si les événements Magento déclenchent correctement les emails transactionnels dans Emarsys, suivez les étapes ci-dessous.
Nouvel abonnement
- Ouvrez le devant de la boutique Magento.
- Abonnez un utilisateur à partir du pied de page.
- Dans les logs, vous verrez un événement déclenché pour le nouvel abonnement.
- Si une campagne active est associé à l'événement, l'abonné recevra un email.
Nouveau compte
- Ouvrez le devant de la boutique Magento.
- Créez un nouvel utilisateur en utilisant l'option S'inscrire ou Créer un compte.
- Dans les logs, vous verrez un événement déclenché pour le nouveau compte.
- Si une campagne active est associé à l'événement, le client recevra un email.
Nouvelle commande
- Ouvrez le devant de la boutique Magento.
- Connectez-vous au compte de l'utilisateur ou créez-en un.
- Passez une commande test.
- Dans les logs, vous verrez un événement déclenché pour la nouvelle commande.
- Si une campagne active est associé à l'événement, le client recevra un email.
Collecte de données Web Extend
Pour voir si les scripts de collecte de données Web Extend sont actifs dans votre boutique Web, procédez comme suit :
- Allez sur le devant de la boutique Web.
- Dans la barre d'adresse de votre navigateur, ajoutez /#sc_inspector au bout de l'url (e.g. www.mystore.com/#sc_inspector).
- Le revêtement Inspector sera affiché dans le navigateur, montrant votre id marchand.
- Si Produits recommandés sur les pages est déjà sélectionné pour chaque page, vous verrez les recommandations dans le revêtement.
- Si vous naviguez jusqu'à une catégorie, vous la verrez dans le revêtement.
- Connectez-vous à un compte ou créez un nouvel utilisateur et l'email ou bien l'identifiant client apparaîtra dans le revêtement.
- Sélectionnez un produit à acheter et ajoutez le au panier : dans le revêtement, sous l'en-tête panier vous verrez l'article accompagné d'informations telles que le prix, la quantité, le sku ou l'identifiant de produit.
Configurer vos messages transactionnels
Magento 2 possède un certain nombre d'événements orientés clients, dont certains peuvent être utilisés comme déclencheurs de campagnes transactionnelles dans Emarsys. Il vous faudra associer ces événements aux événements extérieurs dans Emarsys qui déclencheront la campagne. 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 2 et Emarsys
Après avoir préparé vos campagnes dans Emarsys, allez à Emarsys> Configurations> Événements.
- Pour tout événement Magento disponible sélectionnez l'événement externe approprié dans Emarsys.
- Mettre à jour le Schéma - Importe tous les événements Emarsys disponibles vers Magento.
- Configuration recommandée - Associe automatiquement les événements sur la base de leurs noms. Cela peut vous faire économiser du temps si vous avez beaucoup d'événements.
Événements d'opt-in uniques et doubles
Dans Magento, deux événements gèrent votre stratégie d'adhésion à la newsletter. En fonction de la configuration que vous avez choisie pour les Paramètres d'Opt-in, vous devrez associer les événements suivants en conséquence :
- Opt-in unique - Seul l'événement Abonnement à la newsletter réussi doit être associé à un message confirmant la réussite de l'inscription. Confirmation d'abonnement à la Newsletter ne sera pas déclenché.
- Double Opt-in - Vous devez associer la Confirmation d'abonnement à la newsletter à l'événement Emarsys qui déclenche le message contenant le lien de confirmation. Vous devez ensuite associer l' Abonnement à la newsletter réussi à l'événement qui déclenche le message confirmant la réussite de l'inscription.
Événements Magento disponibles
Les événements Magento suivants sont actuellement configurables :
- 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
3. Personnaliser votre message
Puisque vos contacts Magento sont synchronisés avec Emarsys, vous pouvez bien sûr intégrer à votre message toutes les options de personnalisation habituellement disponibles dans Emarsys, y compris le contenu conditionnel et le ciblage par bloc. Il se peut toutefois que des informations importantes concernant l'événement ne soient accessibles que dans 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 espaces réservés peuvent être n'importe quelle chaîne de texte et sont utilisés uniquement pour s'assurer que les bonnes valeurs dans l'objet JSON sont ajoutées à la bonne place 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.
Vous devrez les configurer pour chaque événement, et vous avez donc intérêt à soigneusement tracer quel caractère fictif vous avez inclus dans quel message transactionnel.
4. Configurer les caractères fictifs
Après avoir configurés vos événements, vous pouvez associer les variables Magento aux caractères fictifs que vous avez ajoutés au contenu de votre campagne Emarsys. Pour chaque événement, cliquez sur Caractères fictifs.
Pour chaque variable Magento, ajoutez le caractère fictif Emarsys que vous intégrerez au contenu du message. Ceci peut être n'importe quelle chaîne de texte sans espaces et sera inclus dans le message entre des symboles % doubles. Voyez
Le lien de confirmation de double opt-in
A chaque fois que vous créez dans Emarsys une campagne qui contient un lien de confirmation pour un double opt-in, vous devez associer le caractère fictif de lien à la même variable Magento qui réglera l'état d'opt-in du contact sur TRUE
et déclenchera le message de suivi (s'il est prévu). Vous pouvez trouver cette variable dans l'événement Confirmation d'abonnement à la newsletter :
{{var subscriber.getConfirmationLink()}}
Puisque ceci récupère l'URL du lien de confirmation, vous devrez l'ajouter à votre message en tant que lien vers l'appel à agir pour la confirmation d'abonnement.
Par exemple, si le caractère fictif Emarsys que vous définissez pour cette variable est subscriber_confirmationlink, vous aurez besoin d'une balise HTML telle que celle-ci en tant que lien de confirmation dans votre message :
- <a href= %%subscriber_confirmationlink%% >I confirm my subscription</a>.
5. Vérifier le JSON
Il est conseillé de vérifier la charge utile JSON qui sera transmise à Emarsys, pour s'assurer que touts les caractères fictifs ont été configurés correctement. Pour ce faire, 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.
Cela affichera seulement la requête JSON Magento envoyée à Emarsys, sans inclure aucun contenu ni aucune personnalisation que vous avez intégré au message Emarsys.
6. Activer les messages transactionnels
Une fois votre configuration achevée, allez au menu Emarsys > Paramètres > Email transactionnel et activez cette fonctionnalité.

- Activer les Emails transactionnels Emarsys - Réglez cela sur Oui.
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 au menu Admin, 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 nouvelles ressources (champs, événements extérieurs, etc.) dans Emarsys, vous pouvez mettre à jour votre interface Magento à tout moment en cliquant sur Mettre à jour le Schéma.
Vous pouvez aussi programmer une vérification régulière en arrière-plan, pour voir si de nouvelles ressources ont été créées. Pour ce faire, ouvrez le menu Emarsys et allez à Paramètres> Email transactionnel et réglez l'heure et la fréquence de la vérification.

Si la vérification trouve une nouvelle ressource, vous recevrez une notification vous enjoignant de mettre à nouveau à jour votre schéma.
Faire une exportation groupée
Sous Emarsys> Opérations> Exportation groupée vous pouvez exporter manuellement en une fois vos données Magento vers Emarsys.
Pour exporter les données, quatre options s'offrent à vous.
- Clients et Abonnés - Sélectionnez ceux-ci si vous voulez mettre à jour vos contacts Magento dans Emarsys, par exemple après avoir ajouté un nouveau champ Magento ou modifié la configuration du champ.
- Pour les Clients, vous devrez indiquer une plage temporelle. Tous les clients enregistrés sur cette période seront synchronisés.
- Pour les Abonnés, vous n'avez pas besoin de définir de plage temporelle. Tous les abonnés dans votre compte Magento seront synchronisés.
Si vous configurez de nouveaux champs pour les clients ou les abonnés dans Magento, assurez-vous de mettre à jour les profiles d'auto-importation Emarsys correspondants.
- Commande - Ceci est principalement utilisé pour le chargement de données de ventes initial. Vous pourrez synchroniser plus tard toutes les données de commande sur une période donnée, par exemple si votre boutique en ligne est restée déconnectée pendant un moment. Mais vous devez faire très attention quand vous faites cela, car Smart Insight ne va pas dé-dupliquer les données et vous pourriez vous retrouver avec des doublons de commandes, ce qui aura un impact négatif sur votre score eRFM et votre modèle de données e-commerce en général.
- Produit - Puisque l'intégralité du catalogue produit est téléchargée à chaque fois, ceci n'est utile que si vous voulez réaliser une exportation immédiate de votre catalogue produit, sans attendre la synchronisation programmée. Quant aux paramètres de flux de données produit , vous pouvez choisir d'exclure certaines catégories de produit de la synchronisation.
Registres
Sous Emarsys > Opérations > Registres vous trouverez une liste de tous les événements d'intégration entre Magento et Emarsys. Cela vous aidera à déboguer l'intégration pendant l'installation, et à la surveiller ensuite.
Pour des informations plus détaillées sur un événement particulier, cliquez sur Vue.
Sous Emarsys > Paramètres > Registres vous pouvez définir la durée de stockage des registres, nettoyer vos fichiers de registre, programmer un calendrier pour les rapports de registre et télécharger les fichiers de registre actuels.
- Sauvegarder les Jours de registre - Voici comment nous conservons les registres de l'intégration.
- sActiver le nettoyage de registre - Active la suppression automatique des registres obsolètes. Réglez-le sur Oui pour économiser de l'espace.
- Envoyer le rapport de registre - Ceci télécharge une fois par jour les registres des 24 dernières heures et les envoie par email au Support Emarsys.
- Télécharger les registres - Télécharge l'intégralité du fichier de registre localement sous forme de fichier .csv.
- Supprimer les registres - Supprime tous les registres sauvegardés.
- Supprime les données du Cron -
Support
Sous Emarsys > Aide > Support vous pouvez ouvrir un ticket de support directement à partir de votre interface Magento.

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.
Types de cache invalides après la mise à jour de la configuration
Il se peut qu'après avoir opéré une modification quelconque de la configuration du plugin, vous voyez apparaître ce message :
Un ou plusieurs des Types de cache sont invalidés : Configuration, Cache de page. Veuillez vous rendre à la Gestion de cache et rafraîchir les types de cache.
Il s'agit d'un comportement normal de la part de Magento, cliquez simplement sur le lien indiqué et supprimez le cache Magento.