Contenu des données d'événements publiées par Amazon SES sur Firehose - Amazon Simple Email Service
Objet de haut niveau JSONObjet mailObjet bounceObjet de réclamationObjet DeliveryObjet SendObjet RejectObjet OpenObjet ClickObjet Rendering FailureDeliveryDelay objetObjet Abonnement

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Contenu des données d'événements publiées par Amazon SES sur Firehose

Amazon SES publie des enregistrements d'événements d'envoi d'e-mails à Amazon Data Firehose au JSON format. Lorsque vous publiez des événements sur Firehose, Amazon SES suit chaque JSON enregistrement avec un caractère de nouvelle ligne.

Vous pouvez trouver des exemples de registres pour tous ces types de notifications dans Exemples de données d'événements publiées par Amazon SES sur Firehose.

Objet de haut niveau JSON

L'JSONobjet de niveau supérieur d'un enregistrement d'événement d'envoi d'e-mail contient les champs suivants.

Nom de champ Description

eventType

Chaîne qui décrit le type d'événement. Valeurs possibles : Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay ou Subscription.

Si vous n'avez pas effectué la Configuration de la publication d'événements, ce champ est nommé notificationType.

mail

JSONObjet contenant des informations sur l'e-mail à l'origine de l'événement.

bounce

Ce champ est présent uniquement si eventType a la valeur Bounce. Il contient des informations sur le retour à l'expéditeur.

complaint

Ce champ est présent uniquement si eventType a la valeur Complaint. Il contient des informations sur la réclamation.

delivery

Ce champ est présent uniquement si eventType a la valeur Delivery. Il contient des informations sur la remise.

send

Ce champ est présent uniquement si eventType a la valeur Send.

reject

Ce champ est présent uniquement si eventType a la valeur Reject. Il contient des informations sur le rejet.

open

Ce champ est présent uniquement si eventType a la valeur Open. Il contient des informations sur l'événement ouvert.

click

Ce champ est présent uniquement si eventType a la valeur Click. Il contient des informations sur l'événement de clic.

failure

Ce champ est présent uniquement si eventType a la valeur Rendering Failure. Il contient des informations sur l'événement d'échec d'affichage.

deliveryDelay

Ce champ est présent uniquement si eventType a la valeur DeliveryDelay. Il contient des informations sur la livraison différée d'un e-mail.

subscription

Ce champ est présent uniquement si eventType a la valeur Subscription. Il contient des informations sur les préférences d'abonnement.

Objet de l'e-mail

Chaque registre d'événement d'envoi d'e-mail contient des informations sur l'e-mail d'origine dans l'objet mail. L'JSONobjet contenant des informations relatives à un mail objet comporte les champs suivants.

Nom de champ Description

timestamp

Date et heure, au format ISO86 01 (YYYY-MM DDThh -:MM:SS.sz), auxquelles le message a été envoyé.

messageId

Un identifiant unique SES attribué par Amazon au message. Amazon vous SES a renvoyé cette valeur lorsque vous avez envoyé le message.

Note

Cet identifiant de message a été attribué par AmazonSES. Vous trouverez l'ID de message de l'e-mail d'origine dans les champs headers et commonHeaders de l'objet mail.

source

Adresse e-mail à partir de laquelle le message a été envoyé (MAILFROMadresse de l'enveloppe).

sourceArn

Le nom de ressource Amazon (ARN) de l'identité utilisée pour envoyer l'e-mail. Dans le cas d'une autorisation d'envoi, sourceArn il s'agit ARN de l'identité que le propriétaire de l'identité a autorisé l'expéditeur délégué à utiliser pour envoyer l'e-mail. Pour en savoir plus sur l'autorisation d'envoi, consultez Méthodes d'authentification d'e-mail.

sendingAccountId

L' AWS identifiant du compte utilisé pour envoyer l'e-mail. Dans le cas de l'autorisation d'envoi, sendingAccountId correspond à l'ID de compte de l'expéditeur délégué.

destination

Liste des adresses e-mail destinataires de l'e-mail original.

headersTruncated

Chaîne qui spécifie si les en-têtes ont été tronqués dans la notification, ce qui a lieu s'ils ont une taille supérieure à 10 Ko. Les valeurs possibles sont true et false.

headers

Liste des en-têtes d'origine de l'e-mail. Chaque en-tête de la liste a un champ name et un champ value.

Note

Tout identifiant de message indiqué dans le headers champ provient du message d'origine que vous avez transmis à AmazonSES. L'ID du message qu'Amazon SES a ensuite attribué au message se trouve dans le messageId champ de l'mailobjet.

commonHeaders

Mappage des en-têtes originaux de l'e-mail communément utilisés.

Note

Tout identifiant de message dans le commonHeaders champ est l'ID de message qu'Amazon SES a ensuite attribué au message dans le messageId champ de l'mailobjet.

tags

Une liste des identifications associées à l'e-mail.

Objet bounce

L'JSONobjet contenant des informations sur un Bounce événement comportera toujours les champs suivants.

Nom de champ Description

bounceType

Le type de rebond, tel que déterminé par AmazonSES.

bounceSubType

Le sous-type du rebond, tel que déterminé par Amazon. SES

bouncedRecipients

Liste qui contient les informations sur les destinataires de l'e-mail d'origine ayant fait l'objet d'un retour à l'expéditeur.

timestamp

Date et heure, au format ISO86 01 (YYYY-MM-:MM:SS.sz DDThh), auxquelles la notification de rebond a été envoyée. ISP

feedbackId

ID unique du retour à l'expéditeur.

reportingMTA

La valeur du Reporting-MTA champ provenant duDSN. Il s'agit de la valeur de l'autorité de transfert de message (MTA) qui a tenté d'effectuer l'opération de livraison, de relais ou de passerelle décrite dans leDSN.

Note

Ce champ n'apparaît que si une notification d'état de livraison (DSN) a été jointe au rebond.

Destinataires à l'origine d'un retour à l'expéditeur

Un événement de retour à l'expéditeur peut se rapporter à un seul destinataire ou à plusieurs destinataires. Le champ bouncedRecipients contient une liste d'objets (un objet par destinataire auquel l'événement de retour à l'expéditeur s'applique), ainsi que le champ suivant.

Nom de champ Description

emailAddress

Adresse e-mail du destinataire. Si a DSN est disponible, il s'agit de la valeur du Final-Recipient champ provenant duDSN.

Facultativement, si un DSN est associé au rebond, les champs suivants peuvent également être présents.

Nom de champ Description

action

La valeur du Action champ provenant duDSN. Cela indique l'action effectuée par le signalement MTA à la suite de sa tentative de remise du message à ce destinataire.

status

La valeur du Status champ provenant duDSN. Il s'agit du code de statut indépendant du transport par destinataire qui indique le statut de remise du message.

diagnosticCode

Code d'état émis par le rapportMTA. Il s'agit de la valeur du Diagnostic-Code champ issu duDSN. Ce champ peut être absent du DSN (et donc également absent duJSON).

Types de retour à l'expéditeur

Chaque évènement de retour à l'expéditeur présente l'un des types affichés dans le tableau suivant.

Le système de publication d'événements publie uniquement les rebonds durs et les rebonds souples qui ne seront plus réessayés par Amazon. SES Lorsque vous recevez des rebonds marquésPermanent, vous devez supprimer les adresses e-mail correspondantes de votre liste de diffusion ; vous ne pourrez plus leur envoyer de messages à l'avenir. Transientdes rebonds vous sont envoyés lorsqu'un message a rebondi plusieurs fois et qu'Amazon SES a cessé d'essayer de le renvoyer. Plus tard, vous aurez peut-être la possibilité de renvoyer avec succès l'e-mail à une adresse ayant dans un premier temps généré un retour à l'expéditeur Transient.

bounceType bounceSubType Description

Undetermined

Undetermined

Amazon n'SESa pas été en mesure de déterminer la raison précise du rebond.

Permanent

General

Amazon SES a bénéficié d'un hard rebond général. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion.

Permanent

NoEmail

Amazon SES a reçu un hard bounce permanent car l'adresse e-mail cible n'existe pas. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion.

Permanent

Suppressed

Amazon SES a supprimé l'envoi à cette adresse car elle a récemment été renvoyée en tant qu'adresse non valide. Pour remplacer la liste de suppression globale, consultez Utilisation de la liste de suppression SES au niveau du compte Amazon.

Permanent OnAccountSuppressionList Amazon SES a supprimé l'envoi à cette adresse car elle figure sur la liste de suppression au niveau du compte. Cela n'est pas pris en compte dans votre métrique de taux de retours à l'expéditeur.

Transient

General

Amazon SES a bénéficié d'un rebond général. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir.

Transient

MailboxFull

Amazon SES a reçu un rebond complet de sa boîte aux lettres. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir.

Transient

MessageTooLarge

Amazon SES a reçu un message trop important. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous réduisez la taille du message.

Transient

CustomTimeoutExceeeded

Amazon n'SESa pas réussi à envoyer l'e-mail dans le délai spécifié par l'expéditeur de l'e-mail. (Le message de rebond indiquera la raison de tout échec éventuel de tentative de livraison dans les limites définiesTTL.)

Transient

ContentRejected

Amazon SES a reçu un rebond de contenu refusé. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous modifiez le contenu du message.

Transient

AttachmentRejected

Amazon SES a reçu une pièce jointe rejetée. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous supprimez ou modifiez la pièce jointe.

Objet de réclamation

L'JSONobjet contenant des informations sur un Complaint événement comporte les champs suivants.

Nom de champ Description

complainedRecipients

Liste contenant des informations sur les destinataires qui ont soumis la réclamation.

timestamp

Date et heure, au format ISO86 01 (YYYY-MM-:MM:SS.sz DDThh), auxquelles la notification de plainte a été envoyée. ISP

feedbackId

ID unique de la réclamation.

complaintSubType

Le sous-type de la plainte, tel que déterminé par AmazonSES.

De plus, si un rapport de commentaire est attaché à la réclamation, les champs suivants peuvent être présents.

Nom de champ Description

userAgent

Valeur du champ User-Agent du rapport de commentaires. Cette valeur indique le nom et la version du système ayant généré le rapport.

complaintFeedbackType

La valeur du Feedback-Type champ figurant dans le rapport de commentaires reçu duISP. La valeur contient le type de commentaires.

arrivalDate

La valeur du Received-Date champ Arrival-Date ou du rapport de commentaires au format ISO86 01 (YYYY-MM DDThh -:MM:SS.sz). Ce champ peut être absent du rapport (et donc également absent duJSON).

Destinataires à l'origine d'une réclamation

Le champ complainedRecipients contient la liste des destinataires susceptibles d'avoir déposé la réclamation.

Important

Étant donné que ISPs la plupart des utilisateurs suppriment l'adresse e-mail du destinataire qui a soumis la plainte à partir de leur notification de plainte, cette liste contient des informations sur les destinataires susceptibles d'avoir envoyé la plainte, en fonction des destinataires du message d'origine et ISP de la source de la plainte. Amazon SES effectue une recherche par rapport au message d'origine pour déterminer cette liste de destinataires.

JSONles objets de cette liste contiennent le champ suivant.

Nom de champ Description

emailAddress

Adresse e-mail du destinataire.

Types de réclamation

Vous pouvez voir les types de plaintes suivants complaintFeedbackType sur le terrain, tels qu'ils sont attribués dans le rapportISP, selon le site Web de l'Internet Assigned Numbers Authority :

Nom de champ Description

abuse

Indique un e-mail indésirable ou un autre type d'e-mail malveillant.

auth-failure

Rapport d'échec d'authentification d'e-mail.

fraud

Indique certains types de fraude ou d'activité d'hameçonnage.

not-spam

Indique que l'entité qui fournit le rapport ne considère pas le message en tant que courrier indésirable. Cette option permet de corriger un message qui a été mal balisé ou classé à tort comme courrier indésirable.

other

Indique tout autre commentaire ne pouvant être classé dans les autres types enregistrés.

virus

Signale qu'un virus a été détecté dans le message d'origine.

Objet Delivery

L'JSONobjet contenant des informations sur un Delivery événement comportera toujours les champs suivants.

Nom de champ Description

timestamp

Date et heure auxquelles Amazon SES a envoyé l'e-mail au serveur de messagerie du destinataire, au format ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).

processingTimeMillis

Le délai en millisecondes entre le moment où Amazon SES a accepté la demande de l'expéditeur et le moment où Amazon SES a transmis le message au serveur de messagerie du destinataire.

recipients

Liste des destinataires auxquels l'événement de remise s'applique.

smtpResponse

Le message de SMTP réponse de la télécommande ISP qui a accepté l'e-mail d'AmazonSES. Ce message varie en fonction du courrier électronique, du serveur de réception et de la réceptionISP.

reportingMTA

Le nom d'hôte du serveur de SES messagerie Amazon qui a envoyé le message.

Objet Send

L'JSONobjet contenant les informations relatives à un send événement est toujours vide.

Objet Reject

L'JSONobjet contenant des informations sur un Reject événement comportera toujours les champs suivants.

Nom de champ Description

reason

Raison du rejet de l'e-mail. La seule valeur possible estBad content, ce qui signifie qu'Amazon SES a détecté que l'e-mail contenait un virus. Lorsqu'un message est rejeté, Amazon SES arrête de le traiter et ne tente pas de le remettre au serveur de messagerie du destinataire.

Objet Open

L'JSONobjet contenant des informations sur un Open événement contiendra toujours les champs suivants.

Nom de champ Description

ipAddress

Adresse IP du destinataire.

timestamp

Date et heure auxquelles l'événement ouvert s'est produit au format ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).

userAgent

Agent utilisateur de l'appareil ou client de messagerie que le destinataire a utilisé pour ouvrir l'e-mail.

Objet Click

L'JSONobjet contenant des informations sur un Click événement contiendra toujours les champs suivants.

Nom de champ Description

ipAddress

Adresse IP du destinataire.

timestamp

Date et heure auxquelles l'événement de clic s'est produit au format ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).

userAgent

Agent utilisateur du client que le destinataire a utilisé pour cliquer sur un lien dans l'e-mail.

link

Le URL lien sur lequel le destinataire a cliqué.

linkTags

Liste des balises ajoutées au lien à l'aide de l'attribut ses:tags. Pour en savoir plus sur l'ajout de balises aux liens de vos e-mails, consultez Q5. Puis-je baliser les liens avec des identificateurs uniques ? dans le FAQ sur les métriques Amazon SES d'envoi d'e-mails.

Objet Rendering Failure

L'JSONobjet contenant des informations sur un Rendering Failure événement comporte les champs suivants.

Nom de champ Description

templateName

Nom du modèle utilisé pour envoyer l'e-mail.

errorMessage

Message qui fournit des informations supplémentaires sur l'échec d'affichage.

DeliveryDelay objet

L'JSONobjet contenant des informations sur un DeliveryDelay événement comporte les champs suivants.

Nom de champ Description

delayType

Type de retard. Les valeurs possibles sont :

  • InternalFailure— Un SES problème interne à Amazon a retardé le message.

  • Généralités — Un échec générique s'est produit au cours de la SMTP conversation.

  • MailboxFull— La boîte aux lettres du destinataire est pleine et ne peut pas recevoir de messages supplémentaires.

  • SpamDetected— Le serveur de messagerie du destinataire a détecté un grand nombre d'e-mails non sollicités provenant de votre compte.

  • RecipientServerError— Un problème temporaire avec le serveur de messagerie du destinataire empêche la livraison du message.

  • IPFailure— L'adresse IP qui envoie le message est bloquée ou limitée par le fournisseur de messagerie du destinataire.

  • TransientCommunicationFailure— Un échec de communication temporaire s'est produit lors de la SMTP conversation avec le fournisseur de messagerie du destinataire.

  • BYOIPHostNameLookupUnavailable— Amazon n'SESa pas pu rechercher le DNS nom d'hôte de vos adresses IP. Ce type de délai ne se produit que lorsque vous utilisez Bring Your Own IP (Fourniture de vos propres adresses IP).

  • Indéterminé : Amazon SES n'a pas été en mesure de déterminer la raison du retard de livraison.

  • SendingDeferral— Amazon SES a jugé approprié de reporter le message en interne.

delayedRecipients

Objet contenant des informations sur le destinataire de l'e-mail.

expirationTime

Date et heure auxquelles Amazon SES cessera d'essayer de transmettre le message. Cette valeur est affichée au format ISO 8601.

reportingMTA

Adresse IP de l'agent de transfert de messages (MTA) qui a signalé le retard.

timestamp

Date et heure auxquelles le retard s'est produit, affichées au format ISO 8601.

Destinataires retardés

L'objet delayedRecipients contient les valeurs suivantes.

Nom de champ Description

emailAddress

Adresse électronique ayant entraîné un retard dans la livraison du message.

status

Le code SMTP d'état associé au délai de livraison.

diagnosticCode

Code de diagnostic fourni par l'agent de transfert de message récepteur (MTA).

Objet Abonnement

L'JSONobjet contenant des informations sur un Subscription événement comporte les champs suivants.

Nom de champ Description

contactList

Nom de la liste sur laquelle figure le contact.

timestamp

Date et heure, au format ISO86 01 (YYYY-MM-:MM:SS.sz DDThh), auxquelles la notification d'abonnement a été envoyée. ISP

source

Adresse e-mail à partir de laquelle le message a été envoyé (MAILFROMadresse de l'enveloppe).

newTopicPreferences

JSONStructure de données (carte) qui indique le statut d'abonnement de tous les sujets de la liste de contacts et indique le statut après un changement (contact abonné ou désabonné).

oldTopicPreferences

Une JSON structure de données (carte) qui indique le statut d'abonnement de tous les sujets de la liste de contacts en indiquant le statut avant le changement (contact abonné ou désabonné).

Préférences de la nouvelle ou de l'ancienne rubrique

Les objets newTopicPreferences et oldTopicPreferences contiennent les valeurs suivantes.

Nom de champ Description

unsubscribeAll

Indique si le contact s'est désabonné de toutes les rubriques de la liste de contacts.

topicSubscriptionStatus

Spécifie le statut d'abonnement du sujet dans le topicName champ indiquant s'il est actuellement abonné pour recevoir des notifications SES pour le type d'événement spécifié. Les valeurs possibles sont OptIn(abonné) ou OptOut(désabonné) dans le subscriptionStatus champ.

topicDefaultSubscriptionStatus

Spécifie le statut d'abonnement par défaut du sujet dans le topicName champ déterminant si les nouveaux sujets ajoutés à la destination de l'événement seront abonnés ou désabonnés par défaut. Les valeurs possibles sont OptIn(abonné par défaut) ou OptOut(désabonné par défaut) dans le subscriptionStatus champ.