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

Il faudra que Magento vous fournisse :

• Pour les Éditions Communauté plus anciennes que 1.8, et les Éditions Entreprise plus anciennes que 1.13.1, remplacez le fichier curl.php situé dans MAGE_ROOT_DIR/lib/Varien/Http/Adapter/ (le fichier de remplacement est fourni par Emarsys). Le fichier curl.php plus ancien ne peut pas gérer les en-têtes passés par l'API Emarsys et n'affichera pas la liste de champs sur la page de configuration.
• Assurez-vous que la limite de mémoire PHP de votre serveur est réglée sur un minimum de 512 MB. Cela est nécessaire parce que certains travaux d'extension importants nécessitent une mémoire PHP augmentée.
• Assurez-vous que le chemin suivant est exclu de tous les mécanismes d'antémémoire que vous utilisez : app/design/frontend/base/default/template/emarsys/javascripttracking.phtml. C'est ici que résideront les scripts de collecte de données Web Extend et la mise en antémémoire perturbera leur fonctionnement.

• Le planificateur AOE (ou assimilé) n'est pas obligatoire mais fortement conseillé, car il expose les tâches planifiées visuellement et nous aidera à vous assister. Veuillez noter que le Planificateur AOE n'est pas disponible pour PHP 5.6 et au-dessus.
• Configurez votre Cron Magento pour tourner toutes les minutes pour les éditions Magento Entreprise et toutes les cinq minutes pour les éditions Communauté Magento. Certains travaux planifiés sont trop gros pour être pris en charge par le planificateur Magento et expireront si vous les tentez. Vous pouvez consulter la documentation Magento pour trouver des instructions permettant de faire cela ou bien demander à votre fournisseur Magento de le faire à votre place.
• Le port TCP 21, 32000-35000 doit être ouvert (c'est obligatoire pour que le fichier soit transféré au FTPES).
• Assurez-vous d'avoir le niveau d'accès nécessaire pour installer les extensions du Marché Magento dans votre boutique Magento.
• Emarsys doit absolument disposer d'un accès Admin aux étapes d'organisation et de production pour pouvoir supporter l'Extension, ainsi qu'un accès SSH à votre serveur Web (un accès SSH direct est préférable, mais pas obligatoire, tant qu'il y a de votre côté une ressource capable d'accéder au serveur en cas de besoin).

Si vous avez déjà utilisé une précédente intégration Magento pour Emarsys, assurez-vous qu'elle n'ait bien été désinstallée. Et sinon, vous aurez besoin de la part d'Emarsys :

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

• Votre Identifiant de marchand Emarsys (vous la trouverez à la page Admin menu > Sources de données dans votre compte Emarsys).
• Vos identifiants pour l'API Emarsys API (pour la synchronisation de données de contact en continu).
• Votre dossier et identifiants FTP Emarsys (réservé aux clients Smart Insight).

• Le pack d'installation (téléchargeable ici).
• Mettez l'adresse IP 185.4.123.111 et la plage 217.175.192.0/24 sur liste blanche (obligatoire pour la synchronisation d'opt-in retour d'Emarsys à Magento).

En plus de cela, vous devrez créer les choses suivantes dans votre compte Emarsys.

• Un événement et une campagne extérieurs pou chacun de vos événements Magento configurés (voir ci-dessous).
• Tous les champs de données personnalisés dont vous avez besoin pour faire la correspondance avec les champs client Magento.
• Des champs personnalisés du type champ de Texte Court (max. 60 caractères) avec les noms suivants :
  • Identifiant client Magento
  • Identifiant de souscripteur Magento

• Dans Github, naviguez jusqu'au dossier /app/ puis copiez le dossier app et le fichier package.xml vers la racine de projet Magento, par exemple : /var/www/html/magento/.

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

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

• Le Tableau de bord du Panel Admin Magento possédera maintenant aussi une entrée menu : Emarsys Email:

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 activer ces scripts, ouvrez le menu Système ,allez à Configuration > Emarsys Connect > Web Extend et effectuez les paramétrages suivants.

• Activer Web Extend - Réglez sur Oui.
• Identifiant Marchand - Votre Identifiant marchand Emarsys (vous le trouverez à la page Admin menu > Sources de données dans votre compte Emarsys).
• Mode Test - S'il est réglé sur Oui, il active la commande testMode de la référence API JavaScript, ce qui vous permet de tester votre compte sans affecter la cohérence de vos données. Pour une intégration en live il faut le régler sur Non.
• Identifier le Client enregistré et connecté par - La clé externe qui identifier le contact dans Emarsys. Dans la plupart des cas, nous conseillons d'utiliser l' Adresse Email. Voir Sélectionner l'Identifiant Clé ci-dessous.

• Identification unique de l'article - La clé qui associera les articles à votre flux de données produit.

• Monnaie d'usage de base - Pertinent seulement si vous possédez plusieurs boutiques Magento configurées sur un seul compte Emarsys.
  • Si Oui, tous les prix seront convertis dans la devise de votre boutique par défaut avant d'être envoyés à Emarsys.
  • Si Non, tous les prix seront envoyés dans la monnaie locale de la boutique.
• Tracer les prix avec les impôts - Si vous avez des boutiques dans différentes régions avec différents niveaux de TVA, vous pouvez choisir d'éluder ces impôts et de n'envoyer que les prix en net à Emarsys.
  • Si Oui, tous les prix seront envoyés taxes comprises.
  • Si Non, tous les prix seront envoyés taxes déduites.
• Utiliser la mise à jour Ajax - Si vous nous autorisez à interdire au chemin du modèle la mise en antémémoire comme décrit dans les besoins pour Magento 1 ci-dessus, cela vous aidera à empêcher les données Web Exend d'être mises en antémémoire.
  • Si Oui, aucune donnée Web Extend ne sera mise en antémémoire.
  • Si Non, vous courrez le risque de la mise en antémémoire de données, ce qui pourrait entraîner des incohérences de données dans Emarsys.
• Utiliser jQuery - Si votre site Magento supporte jQuerry, vous devriez l'utiliser en priorité, sinon la méthode de Mise à jour Ajax sera utilisée.
  • Si Oui, aucune donnée Web Extend ne sera mise en antémémoire.
  • Si Non, vous courrez le risque de la mise en antémémoire de données, ce qui pourrait entraîner des incohérences de données dans Emarsys.

Lorsque vous avez établi vos paramètres et cliqué sur Sauvegarder la Configuration, les scripts Web Extend seront ajoutés aux thèmes et aux modèles de votre site et la collecte de données commencera immédiatement.

Pour configurer la connexion API Emarsys, ouvrez le menu Système et allez à Configuration > Emarsys Connect > Paramètres de la Suite.

File d'attente actuelle

Cela vous montre combien de nouveaux clients se sont enregistrés sur le site depuis la dernière synchronisation des données. Le compteur retourne à zéro après chaque synchronisation (cela peut parfois prendre quelques minutes, en fonction de la connectivité du réseau).

Paramètres d'API

• Activés Réglez le sur Oui pour activer le plugin.
• Point d'extrémité d'API Cela peut être l'une de ces deux valeurs :
  • Par défaut - C'est l'option conseillée qui utilise l'URL API Emarsys standard pour votre environnement (par exemple https://suitexx.emarsys.net/api/v2).
  • URL personnalisée - Cela vous permet de modifier l'URL par défaut si besoin.
  • CDN - Pour les clients situés hors Europe (par exemple dans l'APAC), vous pouvez utiliser un CDN pour améliorer la performance. Si vous pensez que ce sera une meilleure option pour vous, veuillez consulter le Support Emarsys car nous devrons configurer quelques paramètres de notre côté.
• URL d'API personnalisée Si vous avez sélectionné cette option plus haut, saisissez votre URL par défaut modifiée ici. Assurez-vous de ne pas inclure de / surnuméraire à la fin de l'URL ou vous recevrez un message d' erreur pendant la configuration des champs.
• Debuger Si réglé sur Oui, cela enregistre des événements d'intégration supplémentaires, ce qui est utile quand vous voulez permettre à des modules de debugage supplémentaires d'examiner des activités spécifiques (par exemple tracer l'activité de synchronisation quand nous commençons à exporter les fichiers de contacts et de ventes après l'installation).
• Profileur de plugin Si réglé sur Oui, cela enregistre le temps et les ressources consommées par le plugin pour accomplir n'importe quelle action déterminée. Voyez : Sur l'enregistrement, ci-dessous.
• Nettoyer les fichiers de module d'enregistrement - Cela supprime les derniers fichiers d'enregistrement. Si vous laissez les options d'enregistrement activées après que l'intégration a été installée avec succès, vous devriez faire ça régulièrement (chaque jour).
• Télécharger les fichiers du module d'enregistrement Télécharge les fichiers d'enregistrement pour toutes les options d'enregistrement que vous avez activées.
• Le Ping API du service Cron Cela doit être Activé, puisqu'il permet à l'extension d'établir que la connexion est encore active et enregistre les erreurs quand elle ne l'est pas (si Debuger est réglé sur Oui). La perte de connexion entraînera la mise en attente des appels API, ce qui limitera les fonctionnalités en temps réel de l'intégration. Ce ping vous permettre de voir quand et pourquoi la connexion a été perdue.
• Nom d'utilisateur pour l'API de la Suite API et Mot de passe pour l'API de la Suite Saisissez vos identifiants d'API Emarsys (pas vos identifiants de compte Emarsys). Le Support Emarsys a dû vous les fournir pendant votre intégration.
  Votre Propriétaire de compte Emarsys peut aussi créer de nouveaux utilisateurs et mots de passe d'API à la page Admin menu > Paramètres de sécurité , voir : Utilisateurs API.
• Cliquez sur Sauvegarder la Configuration pour sauvegarder vos paramètres.
• Cliquez sur Tester la connexion pour vérifier que vous avez saisi ces identifiants correctement. Le bouton Tester la connexion devrait passer au vert pour signaler que la connexion a été établie entre Magento et votre compte sur la Plateforme Marketing Emarsys.

Nous conseillons de maintenir les deux options d'enregistrement sur Oui jusqu'à ce que vous ayez complètement configuré et testé cette intégration. Cela vous aidera (et nous aussi) à identifier les causes de tout problème qui se pose.

Le Profileur de plugin surveille l'allocation du temps et de la mémoire du cycle de chargement d'une application à intervalles réguliers. En activant le paramètre Profileur de plugin , nous pouvons collecter les informations concernant le temps et les ressources globaux consommés par le plugin pour l'accomplissement de n'importe quelle action spécifique.

Lorsque ce paramètre est activé, il enregistre les données liées dans un fichier d'enregistrement appelé emarsys-profiler.log qui peut être téléchargé via les bouton et lien Télécharger les fichiers d'enregistrement du module.

Le fichier d'enregistrement contient les données suivantes :

• Compte - Le nombre de fois qu'un code particulier a été utilisé/exécuté.
• realmem et realmem_start - Cette colonne montre le volume de mémoire alloué à PHP. C'est un mix entre la fonction PHP principale memory_get_usage() sans le paramètre VRAI activé, moins les valeurs du chronomètre.
• emalloc et emalloc_start - Cette colonne montre les valeurs PHP supplémentaires qui aident à détecter les problèmes de mémoire.

Dans certaines instances de Magento, activer le Profileur de plugin peut causer des problèmes. Si vous recevez un tel message d'erreur de la part de Magento, vous pouvez faire passer votre Profileur de plugin sur Non si Debuger est réglé sur Oui. De cette manière, vous pourrez toujours enregistrer certains événements d'intégration, voire tous.

Une fois l'installation complétée, vous devez faire passer les deux options sur Non.

A partir de là, vous devriez avoir l'impression que l'intégration ne réalise pas la performance attendue :

1. Nettoyez les fichiers d'enregistrement du module
2. Activez les deux options d'enregistrement
3. Débuguez l'intégration
4. Nettoyez les fichiers d'enregistrement à nouveau
5. Désactivez les deux options d'enregistrement

Une connexion FTP est nécessaire pour les utilisateurs Smart Insight et Predict. Pour configurer cette connexion, ouvrez le menu Système et allez à Configuration > Emarsys Connect > Smart Insight > Paramètres FTP.

• Nom de l'hôte, Nom de l'utilisateur et Mot de passe - Saisissez vos identifiants tels que fournis par le Support Emarsys. Si vous êtes un client Predict qui n'utilise pas Smart Insight, vous pouvez saisir ici les détails de votre propre serveur à la place.
• Répertoire - Si vous avez créé un sous-directoire sur le serveur pour séparer les exportations manuelles des exportations programmées ordinaires, saisissez le nom de ce dossier ici (précédé de /).
• Utiliser FTP plutôt que SSL(FTPS) - Réglez cela sur Oui (conseillé).
• Utiliser le mode passif - Réglez cela sur Oui ou Non en fonction de vos besoins IT.
• Cliquez sur Sauvegarder la Configuration lorsque vous avez fini.
• Cliquez sur Tester la Connexion pour vérifier que tout fonctionne. Magento affichera un message pour confirmer si cela fonctionne ou pas.

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.

Les clients Magento possèdent un profil client très complet qui offre un certain nombre de champs. En fonction de votre business model et de vos besoins, vous ne serez probablement intéressé que par un sous-ensemble de ces champs.

Par contraste, les abonnés Magento ne disposent que de quatre champs pour la synchronisation :

• Prénom
• Le nom
• L'adresse email
• L'état d'abonnement (opt-in)

Pour coordonner les champs entre Emarsys et Magento, allez à Système > Configuration > Emarsys Connect > Synchronisation de contact et ouvrez la section Configuration de champ .

Cliquez sur Mettre à jour le Schéma pour vous assurer que tous vos champs Emarsys sont disponibles dans Magento.

Sélectionnez chaque champ Magento que vous voulez synchroniser et le champ cible approprié dans l'application Emarsys, puis utilisez la flèche droite pour déplacer les paires associées.

Remarque : En plus des champs que vous sélectionnez pour la configuration, trois champs Magento sont toujours inclus pour la synchronisation par défaut :

• Opt-in
• Identifiant client
• Identifiant abonné

Une fois que vous avez préparé vos données client comme décrit ci-dessus, vous pouvez réaliser le chargement de données initial pour importer tous vos clients et abonnés Magento vers Emarsys.

Ouvrez le menu Système et allez à > Configuration > Emarsys Connect > Synchronisation de contact et ouvrez la section Paramètres de synchronisation .

• Activer l'exportation clients et Activer l'exportation abonnés - Réglez les deux sur Oui pour activer les deux boutons Exportation (après avoir réalisé votre exportation vous devriez les refaire passer sur Non).
• Utiliser l'URL de notification sécurisée - Si l'URL de votre boutique en ligne commence par https://, vous devez le régler sur Oui. On peut le régler sur Non pour faire un test ou organiser les installations.
• Mode synchronisation Ignorez cela pour l'instant.
• Temps d'exécution en arrière-plan Ignorez cela pour l'instant.
• Clé secrète de notification C'est le mot de passe requis pour les notifications d'exportation.
• Identifiant clé Sélectionnez votre identifiant unique pour les contacts.

Lorsque vous avez terminé, vous pouvez réaliser le chargement de données initial en cliquant sur les deux boutons Exporter. Vous pouvez exécuter les deux exportations en même temps, mais vous ne devez pas les faire commencer en même temps car toutes deux ont besoin de quelques secondes pour initier l'exportation. La durée exacte dépendra de la taille de votre base de données mais le système vous informera si vous démarrer la seconde exportation trop rapidement.

Lorsque vous ferez le chargement de données initial, la chose suivante se produira :

• Pour les clientsMagento, tous les champs définis dans la Configuration de champ ci-dessus seront synchronisés, ainsi que les champs Opt-in et Identifiant client .
• Pour les abonnés Magento, seuls les Prénom, Nom, Adresse email, Opt-in et Identifiant abonné sont synchronisés.

La synchronisation débutera au prochain multiple de cinq minutes. Si le processus semble bloqué, il se peut que vous deviez vider le cache de Magento 1, voir : Résolution des problèmes.

Une fois réalisé le chargement de données initial, vous devrez définir les paramètres de la synchronisation continue des nouvelles données.

Dans la section Paramètres de synchronisation , faites les paramétrages suivants :

• Activer l'exportation clients et Activer l'exportation abonnés Réglez les à nouveau sur Non pour désactiver les deux boutons Exporter, afin d'empêcher uns synchronisation accidentelle de l'intégralité de votre base de données de contact.
• Mode synchronisation Sélectionnez Temps réel-sécurité défaut ou bien Arrière-plan seulement selon vos besoins (voir ci-dessous).
• Temps d'exécution en arrière-plan Réglez l'heure de la journée pour la synchronisation de données quotidiennes;

Cliquez sur Sauvegarder la Configuration pour sauvegarder vos paramètres. La prochaine exportation aura lieu à l'heure programmée.

• De Magento à Emarsys

La base de données de contact Magento est considérée comme la base de données Maîtresses en ce qui concerne les renseignements sur le contact, et toutes les valeurs synchronisées pour les champs associés écraseront le valeurs existantes dans l'application Emarsys. Pour les Clients Magento, les nouveaux contacts seront exportés avec les mêmes champs qu'à l'exportation initiale. Pour les Abonnés Magento, seuls les champs Adresse Email et Opt-in sont exportés, puisque les champs Prénom et Nom ne peuvent être modifiés dans Magento.

• D'Emarsys à Magento

Une fois par jour, au Moment d'exécution de l'arrière-plan spécifié, Emarsys vérifie aussi qu'aucun champ d'Opt-in des contacts Magento n'a été modifié. Dans ce cas-là, cette modification est synchronisée en retour vers Magento.

Il est toutefois fortement recommandé de ne pas modifié l'état d'opt-in dans l'application Emarsys car la mise à jour vers Magento mettre 24 heures, durant lesquelles le contact pourrait recevoir encore d'autres emails (transactionnels). Les meilleurs pratiques reviendraient à faire la mise à jour dans Magento, de sorte que le contact Emarsys soit mis à jour comme spécifié en mode synchronisation.

Vous devez associer vos champs de caractéristiques produit Magento aux champs de données produit Emarsys corrects, pour vous assurer que votre fichier de données produit a les bonnes colonnes et les bons types de champ, en conformité avec nos standards. Pour plus d'informations, veuillez consulter : Préparer votre fichier de données produit.

Pour associer les caractéristiques produit, allez à Emarsys > Association de caractéristique produit.

Ici vous associez les colonnes du flux de données produit. Pour chaque caractéristique Magento, sélectionnez le champ Emarsys approprié.

• Ajoutez une caractéristique Emarsys - S'il vous manque un champ Emarsys, vous pouvez créer l'en-tête de colonne ici. Le nom de champ se verra ajouter automatiquement le préfixe c_.

• Mettre à jour le Schéma - Importe tous les champs Emarsys disponibles vers Magento.
• Association recommandée - Associe automatiquement les champs sur la base de leurs noms. Cela peut vous faire économiser du temps si vous avez beaucoup de champs.

Quand vous avez terminé, cliquez sur Sauvegarder l'association pour sauvegarder vos paramètres.

Allez maintenant à Système > Configuration > Emarsys Connect > Exportation du catalogue complet. Ici vous configurez votre flux de données produit et sélectionnez les types de produit à y intégrer.

• Activer l'Exportation de catalogue complet - Réglez cela sur Oui. Peu importe si une exportation planifiée a lieu avant que vous ayez fait votre chargement initial, puisque l'intégralité du fichier de données produit est systématiquement écrasée à chaque fois.
• Inclure les produits désactivés - Inclut les produits qui ne sont plus disponibles à la vente. Dans la plupart des cas cela doit être réglé sur Oui, pour assurer la cohérence des données à long terme.
• Inclure les types de produit - Ici vous sélectionnez quels types de produit à intégrer. Référez-vous à la Documentation Magento pour plus de précisions.
• Heure de début - Règle l'heure de la journée pour le flux produit (en HH:MM:SS).
• Fréquence - Réglez cela sur Quotidienne. Les options Hebdomadaire ou Mensuelle ne doivent être utilisées que si vous êtes sûr que vous ne modifiez pas plus fréquemment que cela votre fichier de données produit.

Quand vous cliquez sur Sauvegarder la Configuration le fichier de données produit est exporté de Magento à Emarsys selon le calendrier que vous avez défini. A chaque exportation l'intégralité du fichier sera remplacée par la nouvelle version.

Vous devez d'abord faire une exportation en masse de vos données de ventes historiques. Pour faire cela, allez à Système > Configuration > Emarsys Connect > Smart Insight.

Si vous n'avez pas encore configuré votre serveur FTP comme décrit dans les Paramètres FTP ci-dessus, vous devez le faire maintenant.

• Smart Insight activé Réglez cela sur Oui.
• Exportation utilisant l'email comme identifiant Réglez cela sur Oui pour vous assurer de ne pas créer de doublons de contacts. Si le réglage est sur Non, l' Identifiant client sera utilisé, ce qui désactivera l'option Exporter les commandes d'encaissement d'invité (puisque nous n'avons pas d'Identifiants client pour les encaissements d'invité, seulement les adresses email).
• Exporter les commandes d'encaissement d'invité Sélectionnez Oui si vous voulez faire passer des données de commande anonymes à Smart Insight (elles seront utilisées pour améliorer l'affinité produit et d'autres variables).
• Exécuter à - Régler cela sur une heure fixe ne déclenchera pas d'exportation avant que le chargement de données initial ne soit complété. Par exemple, s'il est actuellement 14h, réglez-le sur 12h20. Il est important qu'aucun flux planifié n'arrive pendant que le chargement de données initial est en cours de traitement, sinon vous risquez de vous retrouver avec des doublons de données de ventes dans Emarsys.
• Inclure les bouquets de produits - Si c'est réglé sur Oui, cela intégrera les bouquets de produits au flux.
• Utiliser la monnaie de base dans l'exportation - On doit trouver ici la même valeur que pour Utiliser la monnaie de base dans les paramètres Collecte de données Web Extend. Cela assurera que les données collectées par Web Extend comme celles chargées par Smart Insight sont cohérentes en termes de monnaie et de langue.
• Calculer le prix du bouquet - A régler sur Oui si vous voulez inclure le prix total du bouquet dans le fichier de données.

Lorsque vous avez fait vos paramétrages, cliquez sur Générez maintenant pour exporter les deux dernières années de données de commande et les transmettre à Emarsys. Vous devriez vérifier que le fichier .csv créé contient toutes les commandes des deux dernières années avec tous les champs requis (identifiant produit, prix, quantité, etc.) correctement remplis.

Les scripts de collecte Web Emarsys transmettrons la plupart de événements de données de ventes à Emarsys, mais certains événements ne sont pas repérés par ces scripts, par exemple les informations d'expédition, les dates de livraison prévue ou les méthodes de paiement via des fournisseurs tiers tels que PayPal.

Vous pouvez transmettre cette information à Emarsys et l'utiliser pour la segmentation Smart Insight ou comme partie d'un programme automatisé en intégrant ces états dans l'exportation.

Sur la même page, dans la section Etats de commande , sélectionnez les états pour lesquels les commandes doivent être exportées. Vous pouvez faire une sélection multiple en tenant enfoncée la touche CTRL.

Lorsque vous cliquez sur Sauvegarder la Configuration, Magento inclut les commandes qui sont passées par l'un des états sélectionnés au flux de synchronisation des données de ventes.

Lorsque vous avez fait votre exportation initiale, reconfigurez le champ Exécutez à à l'heure du jour ou la fréquence dont vous avez besoin, puis cliquez sur Sauvegarder la configuration.

Magento exportera toutes les commandes qui sont passées par l'un des états sélectionnés depuis la dernière exportation, à l'heure prévue.

Si vous réglez le champ sur Inclure les produits en bouquet sur Non, votre fichier d'exportation ne contiendra que les données de produit :

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

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

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

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

Lorsque vous avez préparé vos campagnes dans Emarsys, ouvrez le menu Emarsys Email .

Puisque vos contacts Magento sont synchronisés avec Emarsys, vous pouvez bien sûr intégrer à votre contenu email toutes les variables de personnalisation disponibles dans l'application Emarsys, y compris le contenu conditionnel et le ciblage de section. Toutefois, il se peut que des informations importantes sur l'événement qui déclenche l'email ne soient accessible que depuis Magento (par exemple, l'URL du lien de confirmation dans un email de confirmation).

Pour ajouter ce contenu Magento à votre email Emarsys, vous devez ajouter des caractères fictifs Magento spéciaux au contenu de l'email.

Dans votre compte Emarsys, ajoutez les caractères fictifs au contenu email, avec un double-% de chaque côté (par exemple, la variable first_name doit être écrite dans le contenu email %%first_name%%).

Ces balises Emarsys peuvent être n'importe quelle chaîne de texte et ne sont utilisées que pour s'assurer que les bonnes valeurs dans l'objet JSON sont ajoutées au bon endroit dans l'email. Ils ne référencent pas la base de données Emarsys et ne sont pas obligatoirement des chaînes identifiantes de champs Emarsys. Nous vous conseillons de leur attribuer un nom le plus proche possible des variables Magento auxquelles vous les associerez.

Une fois que vous savez quels balises sont utilisées dans quels emails, et que vous avez associé les événements correspondants, vous devez associer les variables Magento aux balises Emarsys. Vous devrez le faire pour chaque événement Magento.

• Sur la page Association d'événement Magento Emarsys , cliquez sur Balises à côté de l'événement en question.

• Pour chaque variable Magento, ajoutez la balise Emarsys correspondante.
• Cliquez sur Sauvegarder l'association.

Il est conseillé de vérifier la charge utile JSON qui sera transmise à Emarsys, pour s'assurer que toutes les balises ont été configurées correctement. Cliquez sur Requête JSON à côté de chaque événement pour afficher l'objet. Vous pouvez maintenant vérifier les balises et voir exactement quelles données sont transmises à Emarsys sans avoir à vous référer aux enregistrements.

Une fois que vous avez associé vos événements et vos champs, vérifiez que vos campagnes email sont correctement configurées dans Emarsys.

• Dans votre compte Emarsys, pour chaque campagne ouvrez les Paramètres Email. Assurez-vous que la Source destinataire est réglée sur Générée par un événement puis sélectionnez l'événement extérieur adéquat.

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

Dans votre compte Magento, allez à Système Configuration et à partir du menu de gauche sélectionnez Configuration client.

• Pour chacune des options disponibles vous pouvez définir un email transactionnel. Dans cet exemple nous examinons Créer de nouvelles options de compte, qui a trois emails de bienvenue intégrés dans un processus d'inscription à double opt-in.

• Sous Emails de bienvenue par défaut, sélectionnez le modèle que vous voulez utiliser et cliquez sur Sauvegarder la Configuration.
• Répétez cette étape pour l' Email du lien de confirmation et l' Email de bienvenue.

Les campagnes email Emarsys associées au modèle se déclencheront maintenant à chaque fois que le déclencheur correspondant est activé dans Magento.

Lorsque vous avez terminé votre association, allez à Système > Configuration > Emarsys Connect > Configuration d'email transactionnel et activez cette fonctionnalité.

• Dans le menu déroulant Activer les emails transactionnels Emarsys , sélectionnez Oui.
• Cliquez sur Sauvegardez la configuration pour sauvegarder les paramètres.

A partir de là, tous les événements associés dans Magento déclencheront l'événement extérieur correspondant dans Emarsys. Vous pouvez ensuite lier ces événements à l'action de votre choix dans Emarsys (par exemple lancer dans campagnes email, SMS ou Mobile Engage).

Une fois que vous avez fait vos premiers chargements de données et réglé le calendrier pour la synchronisation régulière de nouvelles données, vous pouvez tirer profit des outils de surveillance de données fournis par Emarsys pour vous assurer que le flux de données fonctionne correctement.

Ces outils valident chaque importation de données vers Emarsys. Si un problème est identifié, il est signalé et une solution vous est suggérée.

Les outils sont situés dans votre application Emarsys à la Page Sources de données.

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 nouveaux actifs (champs, événements externes, etc.) dans Emarsys, vous en serez informé via les notifications Magento.

Vous pouvez mettre à jour votre interface Magento à tout moment en cliquant sur Mettre à jour le Schéma sur n'importe quelle page où cela apparaît.

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.

Lorsque vous essayez de synchroniser manuellement des champs de données de contact et que l'exportation se bloque, vous devez d'abord vérifier que vos paramètres cron sont corrects. S'ils en ont l'air, videz alors le cache Magento 1 entièrement.

Si en testant l'intégration (ou après), vous trouvez que des données sont attribuées à la mauvaise session ou au mauvais contact, c'est peut-être que votre Web Extend est mis en cache. Vous devez ouvrir les paramètres Web Extend (Système menu > Configuration > Emarsys Connect > Web Extend) et vous assurer que les options Utiliser la mise à jour Ajax ou Utiliser jQuery sont activées de manière pertinente.