Démarrer
Après que Email Déclenché a été activé pour votre compte, vous le trouvez sous le menu Canaux, Email Déclenché.
Toutes vos campagnes email ayant un Événement extérieur comme source destinataire seront listées sur l'onglet Flux Email . Si celles-ci ne contiennent aucun paramètre incompatible (voir ci-dessous), elles peuvent être utilisées directement comme flux email. Sinon elles doivent être copiées et leurs paramètres mis à jour avant qu'elles puissent être utilisées.
Ajouter une adresse d'expéditeur Email Déclenché
Une fois que Email Déclenché a été activé pour votre compte, de nouveaux flux email peuvent être configurés avec une adresse d'expéditeur dédiée qui doit être activée par Emarsys.
Une adresse d'expéditeur séparée est nécessaire parce que nous utilisons une infrastructure dédiée pour envoyer les emails déclenchés, afin d'assurer une délivrabilité optimale.
Vous pouvez avoir plusieurs adresses d'expéditeur sur un compte, mais celles que vous utilisez pour Email Déclenché doivent être activées par le Support Emarsys et ne peuvent pas être ajoutées via l'interface.
À propos des flux email
Un flux email est une campagne email qui est copiée, personnalisée et envoyée quand l'événement est déclenché. Il doit être associé à un événement extérieur et avoir l'adresse d'expéditeur dédiée sélectionnée dans le champ De (adresse email) avant de pouvoir être activé.
Les flux email sont créés comme n'importe quelle autre campagne email (voir ci-dessous).
L'onglet Flux email
Le deuxième onglet sur la page Email Déclenché est la liste de Flux email.
Celle-ci énumère toutes les campagnes email basées sur un événement extérieur dans votre compte, ainsi que tous les flux email ayant été créés depuis.
En plus du nom, du Déclencheur et de l' Admin (utilisateur) qui l'a créé, cette liste donne les informations et réglages suivants :
-
Modèle - Le modèle Emarsys utilisé pour créer le flux email. Il y a trois possibilités :
- S'il utilise un modèle Emarsys créé en utilisant l'un de nos anciens éditeurs de contenu, il affiche le nom du modèle.
- S'il utilise un modèle créé avec VCE, il affiche Basé sur les blocs (ceci sera rectifié dans une future release pour afficher le nom du modèle).
- Si aucun modèle n'est utilisé, il affichera HTML.
-
Statuts - Les statuts possibles sont :
- Actif - Le flux email est actif et peut envoyer des emails.
- Inactif - Le flux email était actif, mais a été désactivé et ne peut envoyer aucun email.
- En cours d'activation - Le flux email vient d'être activé et ses paramètres sont en cours de validation.
- En conception - Le flux email n'a pas encore été activé.
La source destinataire (l'événement extérieur sélectionné) ne peut être ajustée qu'avant que la campagne soit activée pour la première fois. Une fois qu'une campagne est activée ou que vous réglez la source sur événement extérieur, vous ne pouvez plus changer la source destinataire.
Pour changer la source destinataire, recréez la campagne ou bien contactez le Support Emarsys.
Flux email incompatibles
Si vous avez créé une campagne email et réglé la source destinataire sur Événement extérieur, mais n'avez pas assigné le bon domaine d'envoi, elle sera listée avec le reste des flux email mais ne peut pas être modifiée.
De tels flux email sont classés incompatibles et marqués comme tels dans la colonne Statuts.
Les flux email peuvent aussi être incompatible si leur envoi avait été planifié à une heure donnée située après que l'événement extérieur a été déclenché.
Pour utiliser un flux email incompatible comme flux email d'email déclenché, vous devez le copier puis changer les paramètres pour le rendre compatible.
Il se peut qu'un flux email apparaisse sur la liste comme à la fois Actif et Incompatible. Ceci indique que la campagne est une campagne basée sur un événement extérieur valide, qui a été envoyée à partir de la page Campagnes Email et utilise un domaine d'envoi différent.
De telles campagnes continueront à envoyer des emails jusqu'à ce qu'elles soient désactivées, et seront incluses dans le tableau de bord et le reporting Email Déclenché. Elles ne peuvent toutefois pas être modifiées. Pour réutiliser les contenus, vous devez copier la campagne et changer tous les paramètres (par ex. l'adresse d'expéditeur) ayant rendu l'original incompatible.
Sources de déclenchement
Vous pouvez choisir parmi les options suivantes de déclenchement de votre flux email :
- Événements extérieurs,
- Événements de diffusion,
- Événements Interactions.
Ceux-ci sont sélectionnés dans la section Paramètres de déclencheur de la page Paramètres Email.
En utilisant événements extérieurs
Quand vous sélectionnez Événement extérieur comme Source de déclencheur, vous devez choisir un événement extérieur pour votre flux email.
La limite de la taille de la charge utile des événements extérieurs évolue :
Nous introduisons une limite de 1 MB pour la taille de la charge utile des événements extérieurs à compter du 24 octobre 2023. Les événements dépassant cette limite ne seront pas acceptés et vous recevrez une réponse d'erreur de l'API. Par conséquent, les événements extérieurs dépassant la limite ne déclencheront pas de campagnes emails déclenchés, ni de programmes Automation Center ou Interactions.
La limite de la taille de la charge utile des événements extérieurs évolue :
Nous introduisons une limite de 500 KO pour la taille de la charge utile des événements extérieurs à compter du 1er juillet 2023. Les événements dépassant cette limite ne seront pas acceptés et vous recevrez une réponse d'erreur de l'API. Par conséquent, les événements extérieurs dépassant la limite ne déclencheront pas de campagnes emails déclenchés, ni de programmes Automation Center ou Interactions.
Emarsys fournit ensuite le paramètre event_id pour l'événement sélectionné dans l'interface et vous pouvez l'utiliser dans l'appel API qui déclenche le flux email.
Les événements extérieurs peuvent être créés des manières suivantes :
- Manuellement, sur la page Événements extérieurs (menu Gestion, Événements extérieurs).
- Manuellement, dans la section Paramètres de déclencheur de la page Paramètres Email (voir ci-dessus).
- Via l'appel API Créer un événement extérieur.
Utiliser des événements extérieurs est la manière normale d'utiliser Email Déclenché, et vous pouvez profiter de toutes les fonctionnalités prise en charge du module email Emarsys, telles que la personnalisation et le reporting.
Les événements extérieurs ne sont pas forcément réservés à un flux email, le même événement pouvant en déclencher plusieurs.
Utiliser des événements de diffusion
Vous devriez utiliser des événements de diffusion quand vous devez envoyer des emails déclenchés à des contacts qui ne sont pas dans votre base de données de contact.
Ici vous trouvez le paramètre email_id à utiliser dans l'API endpoint Envoyer une campagne email à des contacts virtuels.
Les emails de diffusion sont comptés comme des emails déclenchés normaux pour les besoins de la facturation. Ils souffrent toutefois des limitations suivantes :
- Personnalisation - Comme il ne référencent pas la base de données Emarsys, vous ne pouvez inclure aucune personnalisation basée sur les champs de base de données Emarsys. Si vous voulez personnaliser le contenu, vous pouvez le faire à partir de sources extérieures en ajoutant des caractères de remplissage au contenu du flux email, que vous inclurez aussi (avec les valeurs correspondantes) au paquet JSON livré avec l'appel API.
- Reporting - Emarsys ne trace la livraison ni les réponses d'aucun flux email d'événement de diffusion. Elles n'apparaissent dans aucun des écrans de reporting Emarsys et nous ne collectons pas non plus les données des vues Open Data.
- Gestion des réponses mail - Les réponses aux campagnes email de diffusion ne sont pas traitées par Emarsys, ce qui signifient qu'elles n'apparaissent pas dans la Gestion des réponses mail.
- Pièces jointes - Les flux email de diffusion ne prennent pas en charge les pièces jointes.
- BCC - La fonctionnalité BCC n'est pas disponible pour les flux email de diffusion, mais vous pouvez ajouter des adresses email supplémentaires à l'appel API.
L'envoi d'emails de diffusion est pris en charge dans les circonstances suivantes :
-
Traçage de lien : Vous ne tracez aucun lien dans les campagnes email de diffusion.
- La campagne peut être utilisée comme campagne de diffusion après l'annulation du traçage de tous les liens. Pour désactiver le traçage de lien pour les emails de type événementiel, tels que les emails de diffusion, utilisez l'interrupteur dans l' onglet Liens .
- Le traçage de tous les autres liens, tels que vers la version en ligne et la page désabonnement, doit aussi cesser.
-
Caractères de remplissage de personnalisation : Vous n'utilisez aucun caractère de remplissage se référant à des champs de contact, par exemple :
$pers_12345$oucontact.12345.- Vous n'utilisez aucun caractère de remplissage de personnalisation contenant des variables de personnalisation historiques, par exemple :
%%test_variable%%.
- Vous n'utilisez aucun caractère de remplissage de personnalisation contenant des variables de personnalisation historiques, par exemple :
- Désabonnements personnalisés : Vous ne pouvez pas utiliser une lien personnalisé de désabonnement de liste avec des références à des contacts dans des campagnes email de diffusion, car cela n'est pas compatible avec le concept de base des emails de diffusion. Si vous n'êtes pas sûr d'utiliser un lien de désabonnement de liste personnalisé, veuillez contacter le support Emarsys. Pour plus d'informations, voir List-unsubscribe.
-
Predict : Predict peut être activé pour votre compte, mais vous ne pouvez pas utiliser predict dans des campagnes email de diffusion.
- Vous ne pouvez pas créer et envoyer une campagne email de diffusion contenant une recommandation predict.
- Les recommandations predict ne peuvent pas être envoyées à une audience de diffusion.
Utiliser les événements Interactions
Choisissez des événements Interactions si vous souhaitez utiliser le flux email Email Déclenché dans des programmes Interactions.
Email Déclenché ignore le statut d'opt-in des contacts auxquels il envoie.
Un programme Interactions ne peut être envoyé qu'une fois que tous les flux email qu'il contient sont activés.
Créer des flux email
Il y a deux manières de créer un flux email.
1. Créer un flux email à partir d'une campagne email existante
Vous pouvez créer un flux email à partir de n'importe quelle campagne email existante dans votre compte Emarsys.
Assurez-vous d'utiliser soit des modèles d'email Basés sur les blocs (utilisant VCE), soit des modèles HTML personnalisés pour créer un flux email à partir d'une campagne email existante. Pour plus d'informations sur les modèles d'email, voir la documentation sur les modèles d'email.
Procédez comme suit :
- Copiez et renommez la campagne email - vous pouvez faire cela depuis la liste d' Emails ou bien depuis la liste de Flux email .
- Sélectionnez l'événement extérieur ou de diffusion qui déclenchera l'email.
- Vérifiez que le champ De (adresse email) a été correctement mis à jour avec l'adresse d'expéditeur Email Déclenché.
Une fois que vous avez enregistré vos paramètres, l'email apparaît comme un flux email valide dans la lite. Vous pouvez maintenant faire tous les changements que vous voulez et l'activer quand il est prêt à être envoyé.
2. Créer un nouveau flux email
Vous pouvez aussi créer un flux email à partir de la page Email déclenché.
Ceci ouvre exactement le même éditeur de contenu email que vous utilisez normalement pour la création d'email, mais avec les différences suivantes.
2.1. Paramètres de flus email
La page Paramètres email a une nouvelle section pour les Paramètres de flux email. Ici vous pouvez régler le flux email pour forcer des pièces-jointes et ajouter les adresses email BCC.
Vous n'êtes pas obligé de cocher la case Envoyer seulement avec une pièce-jointe pour pouvoir envoyer des pièces-jointes. Tous les appels API destinataires peuvent contenir une pièce-jointe, Email Déclenché les traitera comme prévu.
Si vous activez cette case, Emarsys annulera tous les emails de ce flux email ayant été déclenchés par un appel API qui ne contenait pas de pièce-jointe valide.
Ces emails seront listés sur le Tableau de bord comme Annulés sous la section Emails non-envoyés.
2.2. Paramètres de déclencheur
Au lieu de la Source destinataire, vous pouvez choisir entre les événements extérieurs ou les événements de diffusion (voir ci-dessus). Vous pouvez aussi créer un nouvel événement extérieur à partir de cette page.
2.3. De (adresse email)
Le champ De (adresse email) sur l'onglet Paramètres de base de l'email de la page Création de contenu contient votre adresse d'expéditeur Email Déclenché définie. Ceci ne peut pas être changé.
2.4. Planification
La page Planification n'a qu'un bouton pour activer le flux email.
Personnaliser le contenu email
Vous pouvez personnaliser l'email déclenché avec des données issues de votre base de données de contact et des données de la transaction.
- Pour utiliser des données de votre base de données de contact, ajoutez variables de personnalisation ou contenu conditionnel comme vous le feriez pour n'importe quel autre email.
- Pour utiliser des données de la transaction, veuillez voir Personnaliser votre email avec des données d'événements extérieurs et Capturer le contenu transactionnel pour plus de détails.
Utiliser des pièces-jointes
Avec Email Déclenché, vous pouvez joindre jusqu'à 10 fichiers par email. Quand vous utilisez des pièces-jointes, vous devez vous conformer aux normes suivantes :
- Taille maximum des pièces-jointes cumulées : 10 Mo.
- Taille maximum de l'email : 25 Mo.
- Formats pris en charge : .doc, .docx, .pdf, .rtf, .csv, .xml, .xlsx, .xls, .txt
- Les fichiers doivent être encodés en Base64 et envoyés avec l'appel JSON.
- La fréquence est limitée à 300 requêtes/minute. Au-delà les emails sont mis en attente et envoyés plus tard.
Les pièces-jointes seront aussi envoyées à toutes les adresses email en BCC.
Les pièces-jointes ne peuvent être envoyées que si vous utilisez l'API pour déclencher les flux email. Pour le moment, vous ne pouvez pas utiliser les pièces-jointes dans Interactions.
Veuillez aussi noter que les pièces-jointes ne sont pas enregistrées du côté d'Emarsys. Pour suivre toutes les pièces-jointes envoyées, vous pouvez utiliser la fonctionnalité BCC pour envoyer des copies à l'une de vos boîtes mail.
Exemple JSON
Un exemple de paquet JSON d'un email déclenché contenant une pièce-jointe ressemblerait à cela :
{ "key_id": "3", "external_id": "t.odinson@example.com", "data": { "global": { "itemName": "hammer", "itemPrice": "123", "<placeholder_name>": "<placeholder_value>", ... } }, "attachment": [ { "filename": "example.pdf", "data": "ZXhhbXBsZQo=" } ] }Codes d'erreur de pièce-jointe
Il y a un certain nombre de raisons pour lesquelles une pièce-jointe peut causer une erreur.
| Code d'étatHTTP | Code de réponse | Message d'erreur |
| 400 | 5200 | Impossible d'ajouter la pièce-jointe; le format doit être un tableau. |
| 400 | 5201 | Impossible d'ajouter la pièce-jointe; l'extension de fichier doit être .pdf. |
| 400 | 5202 | Impossible d'ajouter la pièce-jointe; la clé \"filename\" est manquante. |
| 400 | 5203 | Impossible d'ajouter la pièce-jointe; la clé \"data\" est manquante. |
| 400 | 5204 | Impossible d'ajouter la pièce-jointe; l'encodage doit être en base64. |
| 400 | 0 | Pièce-jointe trop lourde. |
| 400 | 2004 | ID de champ clé invalide : [field_id] |
| 400 | 2005 | Aucune valeur donnée pour le champ clé : [field_id]. |
| 400 | 2008 | Aucun contact n'a été trouvé avec l'ID externe : [key_id] - [external_id]. |
| 400 | 2010 | Plus de contact ont été trouvés avec l'ID externe : [key_id]. |
| 400 | 5001 | ID d'événement invalide pour le client. |
| 400 | 2012 | ID de congtact invalide pour le client. |
| 400 | 5005 | Aucun programme ni aucune campagne n'est déclenché. |
| 400 | 7000 | Aucune pièce-jointe n'a été trouvée. |
Forcer des pièces-jointes
Si votre email déclenché nécessite une pièce-jointe, par exemple une facture, vous pouvez empêcher l'email d'être envoyé si la pièce-jointe n'est pas présente.
Pour ce faire, allez à la page Paramètres Email et activez la case à cocher N'envoyer qu'avec une pièce-jointe.
Si, quand l'email est déclenché, aucune pièce-jointe ne peut être trouvée ou que le fichier de pièce-jointe ne peut pas être envoyé pour l'une des raisons décrites ci-dessus, une erreur sera retournée et l'email sera listé dans la page de reporting Résumé des résultats sous Aucune pièce-jointe et dans le rapport à menu déroulant concernant la section Emails non-envoyés du Tableau de bord.
Tester des flux email
Il y a deux manières de tester un flux email.
1. Envoyer un testmail
Avant que le flux email soit activé, vous pouvez utiliser la fonctionnalité testmail standard de l'éditeur d'email pour tester le design et le contenu de l'email.
- Si votre adresse email d'expéditeur dédiée est déjà configurée, vous pouvez utiliser la fonctionnalité testmail normalement.
- Si vous n'avez pas encore votre adresse email d'expéditeur, vous devez sélectionner comme source destinataire quelque chose d'autre qu'événement extérieur, ainsi qu'une adresse différente. Quand vous êtes assurés que les contenus sont corrects, réglez à nouveau la source sur événement extérieur.
2. Tester le flux email
Une fois que vous avez testé le contenu, vous pouvez aussi tester le flux email en l'activant et en déclenchant l'événement extérieur vous-même, avant qu'il ait été implémenté dans un environnement live.
Activer des flux email
Une fois que vous avez fini de créer l'email, vous pouvez activer le flux email d'une de ces deux manières :
- Manuellement, sur la page Planification (voir ci-dessus).
- Manuellement, via l'interrupteur sur la liste de Flux email (voir ci-dessus).
L'activation peut prendre quelques minutes, le temps que tous les paramètres soient vérifiés et validés. Si d'aventure un paramètre est incompatible avec Email Déclenché, vous recevrez une notification d'erreur et devrez changer les paramètres avant d'activer à nouveau le flux email.
Déclencher des emails
Une fois que vous avez activé votre flux email avec succès et l'avez associé à l'événement extérieur, vous devez associer cet événement avec l'activité quelle qu'elle soit qui déclenchera le flux email. Vous pouvez faire cela des manières suivantes :
- En utilisant l'API endpoint Déclencher des événements extérieurs pour déclencher l'email de son côté.
- En associant l'événement extérieur à un événement dans une plateforme tierce (si une intégration Emarsys existe pour cette plateforme).
- En utilisant l'API endpoint Déclencher des événements extérieurs pour déclencher un programme Interaction avec Événement extérieur comme point d'entrée (pas recommandé - voir ci-dessous).
En utilisant Email Déclenché avec Interactions
Vous pouvez associer un email déclenché à un événement extérieur qui est le noeud d'entrée d'un programme automatisé. Vous pouvez aussi filtrer avec les attributs d'événement et les utiliser pour personnaliser votre contenu dans Interactions.
Données extérieures
Toutes les données extérieures contenues dans l'appel API d'événement extérieur seront conservées par Interactions pour chaque contact, le temps que ce contact reste dans le programme. Elles peuvent être ré-utilisées pour personnaliser du contenu dans n'importe quel autre email du programme.
Vous pouvez aussi baser un programme sur les résultats d'un email déclenché, auquel cas vous devriez configurer un point d'entrée de filtre récurrent et filtrer les réponses à l'email originel.²
Vous pouvez filtrer les emails déclenchés et transactionnels en utilisant des segments et des catégories.
Travailler avec des flux email actifs
Une fois qu'un flux email est actif, vous avez les options suivantes.
Modifier des flux email actifs
Vous pouvez modifier toutes les parties d'un flux email, à l'exception du domaine de lien.
Pour modifier le domaine de lien vous devez d'abord copier votre campagne email, ensuite vous pouvez mettre à jour son domaine de lien.
Pour modifier un flux email, complétez les étapes suivantes :
1. Désactivez le flux email de l'une des manières suivantes :
- Désactivez-le via l'interrupteur sur la Liste de flux email.
- Désactivez-le sur la page de Planification.
Pendant qu'un flux email est inactif, tous les événements extérieurs seront ignorés et vous n'en serez pas informé.
2. Copiez le flux email soit à partir de la liste d' Emails , soit à partir de la Liste de flux email.
Copier le flux email est fortement recommandé dans le cas d'emails critiques pour l'activité.
Pour modifier une campagne email exécutée dans un programme Interactions, vous devez d'abord geler le programme et désactiver le flux email. Quand vous êtes satisfait des changements, activez le flus email et redémarrez le programme.
3. Modifiez le flux email copié.
4. Remplacez le vieux flux email par le nouveau, modifié.
Une fois que vous avez enregistré vos paramètres, l'email apparaît comme un flux email valide dans la lite.
5. Activez le nouveau flux email mis à jour sur la page Planification.
Utilisez le même événement extérieur ou bien définissez-en un nouveau
Vous pouvez utiliser le même événement extérieur ou bien en définir un nouveau, selon vos besoins :
- Utiliser le même événement extérieur signifie que vous n'avez pas à modifier le déclencheur ou l'appel API, mais vous devrez gérer (mettre en pause) les déclencheurs entrant de votre côté pendant que vous désactivez le vieux flux email et activez le nouveau.
- Utiliser un nouvel événement extérieur signifie que vous devrez faire passer les déclencheurs au nouvel événement, mais cela assure qu'aucun déclencheur entrant ne puisse se perdre entre temps.
Interrompre des flux email incompatibles
Si vous avez une campagne d'événement extérieur dans votre liste de flux email, vous ne pouvez pas la modifier ou la désactiver, mais seulement l'interrompre.
Si vous voulez apporter des changements à une telle campagne, copiez-la et faites les changements dans la copie. Assurez-vous ensuite que la copie soit un flux email valide, avant de l'activer et d'interrompre la campagne historique.
Utiliser Email Déclenché avec les intégrations extérieures
Si vous utilisez une intégration Emarsys avec un fournisseur tiers, vous devriez utiliser Email Déclenché pour envoyer tous vos emails transactionnels pour l'intégration.
Configurez et activez simplement le flux email comme décrit ci-dessus, puis associez les événements extérieurs correspondant selon les instructions du manuel d'intégration.
Reporting Email Déclenché
Pour voir la page Reporting d'un flux email, cliquez sur l'icône Reporting dans la liste de Flux email.
Il s'ouvrira dans l'onglet Rapport de tendance, affichant l'évolution des réponses et des taux de conversion pour le flux email au cours du temps. Tous les écrans de reporting habituels sont aussi disponibles.
Le rapport de flux email est aussi accessible sur la page Analyse Email habituelle.
Problèmes et limitations connus
Voici une liste des limitations actuelles de ce produit.
- Liste de flux email - Les modèles d'email créés à l'aide de VCE seront listés comme Basés sur les blocs dans la liste Flux email, et non par leur nom.
-
Modifier des flux email envoyés - Modifier des flux email déjà envoyés n'est possible qu'en utilisant l'éditeur basé sur les blocs ou la nouvelle version de l'éditeur HTML. Utiliser la vieille version de l'éditeur HTML entraînera le message d'erreur suivant : "Ce message est planifié ou a déjà été envoyé et ne peut pas être modifié."
- Pour modifier un flux email envoyé, cliquez sur Passer au nouvel éditeur en haut de l'ancienne version de l'éditeur HTML.
- Emails déclenchés par des tests A/B - Pour tester correctement vos emails déclenchés, vous devez les inclure dans des programmes Interactions.
Pour plus d'informations sur l'utilisation d'Email Déclenché avec Interactions, voir Envoyer un email.
N'utilisez pas le ciblage de bloc en association avec des campagnes Email basé sur un déclencheur/Événement extérieur (Emails transactionnels).