Manuel d'intégration pour Magento 2 (v1)

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.

Il faudra qu'Emarsys vous fournisse :

• Un compte sur la Plateforme Marketing Emarsys entièrement configuré et en état de marche.

• 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).

• 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

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.

• Dans Github, rendez-vous à emarsys/app/code/Emarsys puis copiez le dossier Emarsys dans votre registre app/code dans Magento.

• 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.

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.

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 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.

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.

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 :

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.

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.

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.

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.

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 .

• 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.

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.

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 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é.

• Cliquez sur Exporter pour synchroniser tous vos clients Magento vers Emarsys.

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.

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.

• 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.

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.

• 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.

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.

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.

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.

• 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.

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.

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.

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.

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é.

Pour tester le bon fonctionnement de la synchronisation d'abonné, procédez comme suit :

1. Naviguez vers le devant de votre boutique Magento.
2. Faites défiler jusqu'en bas.
3. 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.
4. Allez au panel admin Magento.
5. Sous Marketing > Abonné à la newsletter, un registre d'abonné a été ajouté.
6. Connectez-vous à votre compte Emarsys.
7. Dans le coin en haut à droite, sélectionnez recherche.
8. Tapez l'adresse email pour effectuer une recherche par email.
9. Vous devriez voir un enregistrement synchronisé avec la valeur d'opt-in true (opt-in unique).

Pour tester le bon fonctionnement de la synchronisation de contact, procédez comme suit :

1. Naviguez vers le devant de votre boutique Magento.
2. Cliquez sur Enregistrer le compte.
3. 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.
4. Allez au panel admin Magento.
5. Sous Clients > Tous les clients, un registre de client a été ajouté.
6. Connectez-vous à votre compte Emarsys.
7. Dans le coin en haut à droite, sélectionnez recherche.
8. Tapez l'adresse email pour effectuer une recherche par email.
9. Vous devriez voir un enregistrement synchronisé avec Emarsys contenant tous les détails saisis.

Pour tester le bon fonctionnement de la synchronisation des données de produit, procédez comme suit :

1. Ajoutez un nouveau produit à votre magasin Magento.
2. Attendez que les données produit soient synchronisées (selon votre configuration).
3. Recherchez les données dans Emarsys pour vérifier que le nouveau produit a été importé correctement.

Pour tester si les événements Magento déclenchent correctement les emails transactionnels dans Emarsys, suivez les étapes ci-dessous.

Pour voir si les scripts de collecte de données Web Extend sont actifs dans votre boutique Web, procédez comme suit :

1. Allez sur le devant de la boutique Web.
2. Dans la barre d'adresse de votre navigateur, ajoutez /#sc_inspector au bout de l'url (e.g. www.mystore.com/#sc_inspector).
3. Le revêtement Inspector sera affiché dans le navigateur, montrant votre id marchand.
4. Si Produits recommandés sur les pages est déjà sélectionné pour chaque page, vous verrez les recommandations dans le revêtement.
5. Si vous naviguez jusqu'à une catégorie, vous la verrez dans le revêtement.
6. Connectez-vous à un compte ou créez un nouvel utilisateur et l'email ou bien l'identifiant client apparaîtra dans le revêtement.
7. 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.

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).

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.

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.

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

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.

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).

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.

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é.

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.

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.

• 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.

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 -

Sous Emarsys > Aide > Support vous pouvez ouvrir un ticket de support directement à partir de votre interface Magento.

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.

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.