Contenido de los datos de eventos que Amazon SES publica en Firehose

Amazon SES publica el correo electrónico enviando registros de eventos a Amazon Data Firehose en JSON formato. Al publicar eventos en Firehose, Amazon SES sigue cada JSON registro con un carácter de nueva línea.

Puede encontrar registros de ejemplo para todos estos tipos de notificación en Ejemplos de datos de eventos que Amazon SES publica en Firehose.

Objeto de nivel superior JSON

El JSON objeto de nivel superior de un registro de eventos de envío de correo electrónico contiene los siguientes campos.

Nombre del campo	Descripción
eventType	Una cadena que describe el tipo de evento. Valores posibles: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay o Subscription. Si no configuró la publicación de eventos este campo se denomina notificationType.
mail	Un JSON objeto que contiene información sobre el correo electrónico que produjo el evento.
bounce	Este campo solo está presente si eventType es Bounce. Contiene información sobre el rebote.
complaint	Este campo solo está presente si eventType es Complaint. Contiene información sobre la reclamación.
delivery	Este campo solo está presente si eventType es Delivery. Contiene información sobre la entrega.
send	Este campo solo está presente si eventType es Send.
reject	Este campo solo está presente si eventType es Reject. Contiene información sobre el rechazo.
open	Este campo solo está presente si eventType es Open. Contiene información sobre el evento de apertura.
click	Este campo solo está presente si eventType es Click. Contiene información sobre el evento de clic.
failure	Este campo solo está presente si eventType es Rendering Failure. Contiene información sobre el evento de error de presentación.
deliveryDelay	Este campo solo está presente si eventType es DeliveryDelay. Contiene información sobre el retraso en la entrega de un correo electrónico.
subscription	Este campo solo está presente si eventType es Subscription. Contiene información sobre las preferencias de suscripción.

Objeto Mail

Cada registro de evento de envío de correo electrónico contiene información acerca del correo electrónico original en el objeto mail. El JSON objeto que contiene información sobre un mail objeto tiene los siguientes campos.

Nombre del campo	Descripción
timestamp	La fecha y la hora, en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ), en que se envió el mensaje.
messageId	Un identificador único que Amazon SES asignó al mensaje. Amazon te SES devolvió este valor cuando enviaste el mensaje. nota Amazon asignó este identificador de mensajeSES. Puede encontrar el ID de mensaje del correo electrónico original en los campos headers y commonHeaders del objeto mail.
source	La dirección de correo electrónico desde la que se envió el mensaje (la MAIL FROM dirección del sobre).
sourceArn	El nombre del recurso de Amazon (ARN) de la identidad que se utilizó para enviar el correo electrónico. En el caso de la autorización de envío, sourceArn es la identidad que el propietario ARN de la identidad autorizó al remitente delegado a utilizar para enviar el correo electrónico. Para obtener más información acerca de la autorización de envío, consulte Métodos de autenticación del correo electrónico.
sendingAccountId	El ID de AWS cuenta de la cuenta que se utilizó para enviar el correo electrónico. En el caso de la autorización de envío, el sendingAccountId es el ID de cuenta del remitente delegado.
destination	Una lista de direcciones de correo electrónico que han sido destinatarios del correo electrónico original.
headersTruncated	Una cadena que especifica si los encabezados están truncados en la notificación, que se produce si los encabezados tienen un tamaño superior a 10 KB. Los posibles valores son true y false.
headers	Una lista de los encabezados originales del correo electrónico. Cada encabezado de la lista tiene un campo name y un campo value. nota Cualquier identificador de mensaje incluido en el headers campo corresponde al mensaje original que pasaste a AmazonSES. El identificador de mensaje que Amazon asignó SES posteriormente al mensaje se encuentra en el messageId campo del mail objeto.
commonHeaders	Un mapeo de los encabezados originales del correo electrónico utilizados habitualmente. nota Cualquier identificador de mensaje incluido en el commonHeaders campo es el identificador de mensaje que Amazon asignó SES posteriormente al mensaje en el messageId campo del mail objeto.
tags	Una lista de etiquetas asociadas al correo electrónico.

Objeto Bounce

El JSON objeto que contiene información sobre un Bounce evento siempre tendrá los siguientes campos.

Nombre del campo	Descripción
bounceType	El tipo de rebote, según lo determine AmazonSES.
bounceSubType	El subtipo del rebote, según lo determine Amazon. SES
bouncedRecipients	Una lista que contiene información acerca de los destinatarios del mensaje de correo electrónico original que dio lugar a un rebote.
timestamp	La fecha y la hora, en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ), en las que se envió la notificación de rebote. ISP
feedbackId	Un ID único para el rebote.
reportingMTA	El valor del campo de. Reporting-MTA DSN Este es el valor de la autoridad de transferencia de mensajes (MTA) que intentó realizar la operación de entrega, retransmisión o puerta de enlace descrita en elDSN. nota Este campo solo aparece si se ha adjuntado una notificación del estado de la entrega (DSN) al rebote.

Destinatarios con rebote

Un evento de rebote podría pertenecer a un único destinatario o a varios destinatarios. El campo bouncedRecipients aloja una lista de objetos (un objeto por destinatario a quien pertenece el evento de rebote) y siempre contendrá el campo siguiente.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico del destinatario. Si a DSN está disponible, este es el valor del Final-Recipient campo deDSN.

Opcionalmente, si a DSN está asociado al rebote, también pueden estar presentes los siguientes campos.

Nombre del campo	Descripción
action	El valor del Action campo deDSN. Indica la acción realizada por el MTA denunciante como resultado de su intento de entregar el mensaje a este destinatario.
status	El valor del Status campo deDSN. Se trata del código de estado independiente del transporte por destinatario que indica el estado de entrega del mensaje.
diagnosticCode	El código de estado emitido por el informeMTA. Este es el valor del Diagnostic-Code campo deDSN. Este campo puede estar ausente en el DSN (y, por lo tanto, también ausente en elJSON).

Tipos de rebote

Cada evento se rebote será uno de los tipos que se muestra en la tabla siguiente.

El sistema de publicación de eventos solo publica los rebotes duros y los rebotes suaves que Amazon ya no volverá a intentar. SES Cuando recibas rebotes marcadosPermanent, debes eliminar las direcciones de correo electrónico correspondientes de tu lista de correo; no podrás enviarlas en el futuro. TransientLos rebotes se envían cuando un mensaje ha sido rechazado varias veces y Amazon SES ha dejado de intentar volver a entregarlo. Es posible que en el futuro pueda volver a enviar correctamente a una dirección que inicialmente ha dado lugar a un rebote Transient.

bounceType	bounceSubType	Descripción
Undetermined	Undetermined	Amazon no SES ha podido determinar un motivo de rebote específico.
Permanent	General	Amazon SES recibió un fuerte rebote general. Si recibe este tipo de rebote, debería eliminar la dirección de correo electrónico del destinatario de su lista de correo.
Permanent	NoEmail	Amazon SES recibió un rebote permanente porque la dirección de correo electrónico de destino no existe. Si recibe este tipo de rebote, debería eliminar la dirección de correo electrónico del destinatario de su lista de correo.
Permanent	Suppressed	Amazon SES ha suprimido el envío a esta dirección porque tiene un historial reciente de devoluciones por ser una dirección no válida. Para anular la lista de supresión global, consulte Uso de la lista de supresión a SES nivel de cuenta de Amazon.
Permanent	OnAccountSuppressionList	Amazon SES ha suprimido el envío a esta dirección porque está en la lista de supresión a nivel de cuenta. Esto no se toma en cuenta para calcular la métrica de porcentaje de rebotes.
Transient	General	Amazon SES recibió un rebote general. Es posible que pueda enviar correctamente a este destinatario en el futuro.
Transient	MailboxFull	Amazon SES recibió un buzón de correo rebotado por completo. Es posible que pueda enviar correctamente a este destinatario en el futuro.
Transient	MessageTooLarge	Amazon SES ha recibido un mensaje con un rebote demasiado grande. Es posible que pueda enviar correctamente a este destinatario si reduce el tamaño del mensaje.
Transient	CustomTimeoutExceeeded	Amazon no SES ha podido entregar correctamente el correo electrónico en el tiempo especificado por el remitente del correo electrónico. (El mensaje de rebote especificará el motivo de cualquier posible error en el intento de entrega dentro de lo definido)TTL.
Transient	ContentRejected	Amazon SES ha recibido un rebote de contenido rechazado. Es posible que pueda enviar correctamente a este destinatario si cambia el contenido del mensaje.
Transient	AttachmentRejected	Amazon SES ha recibido un rebote de un archivo adjunto rechazado. Es posible que pueda enviar correctamente a este destinatario si elimina o cambia el archivo adjunto.

Objeto Complaint

El JSON objeto que contiene información sobre un Complaint evento tiene los siguientes campos.

Nombre del campo	Descripción
complainedRecipients	Una lista que contiene información sobre destinatarios que podrían haber enviado la reclamación.
timestamp	La fecha y la hora, en formato ISO86 01 (YYYY-MM-:MM:SS.SZ DDThh), en las que se envió la notificación de queja. ISP
feedbackId	Un ID único para el reclamo.
complaintSubType	El subtipo de la queja, según lo determine AmazonSES.

Además, si se adjunta un informe de retroalimentación a la reclamación, podrían estar presentes los siguientes campos.

Nombre del campo	Descripción
userAgent	El valor del campo User-Agent del informe de retroalimentación. Esto indica el nombre y la versión del sistema que generó el informe.
complaintFeedbackType	El valor del Feedback-Type campo del informe de comentarios recibido delISP. Contiene el tipo de retroalimentación.
arrivalDate	El valor del Received-Date campo Arrival-Date o del informe de comentarios en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ). Este campo puede estar ausente en el informe (y, por lo tanto, también en el). JSON

Destinatarios con reclamaciones

El campo complainedRecipients contiene una lista de destinatarios que podrían haber enviado la reclamación.

importante

Como la ISPs mayoría borra la dirección de correo electrónico del destinatario que presentó la queja en su notificación de queja, esta lista contiene información sobre los destinatarios que podrían haber enviado la queja, en función de los destinatarios del mensaje original y ISP del remitente de la queja. Amazon SES realiza una búsqueda en el mensaje original para determinar esta lista de destinatarios.

JSONlos objetos de esta lista contienen el siguiente campo.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico del destinatario.

Tipos de reclamación

Según el sitio web de la Autoridad de Números Asignados en Internet, puede ver los siguientes tipos de quejas en el complaintFeedbackType campoISP, según lo asignado en el informe:

Nombre del campo	Descripción
abuse	Indica correo electrónico no solicitado o algún otro tipo de abuso de correo electrónico.
auth-failure	Informe de error de autenticación de correo electrónico.
fraud	Indica algún tipo de fraude o actividad de phishing.
not-spam	Indica que la entidad que proporciona el informe no considera el mensaje como spam. Esto se puede utilizar para corregir un mensaje que estaba mal etiquetado o clasificado como spam.
other	Indica cualquier otra retroalimentación que no encaje en otros tipos registrados.
virus	Notifica que se ha encontrado un virus en el mensaje de origen.

Objeto Delivery

El JSON objeto que contiene información sobre un Delivery evento siempre tendrá los siguientes campos.

Nombre del campo	Descripción
timestamp	La fecha y la hora en que Amazon SES entregó el correo electrónico al servidor de correo del destinatario, en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ).
processingTimeMillis	El tiempo en milisegundos transcurrido entre el momento en que Amazon SES aceptó la solicitud del remitente y el momento en que Amazon SES pasó el mensaje al servidor de correo del destinatario.
recipients	Una lista de los destinatarios a los que corresponden los eventos de entrega.
smtpResponse	El mensaje de SMTP respuesta del mando a distancia ISP que aceptó el correo electrónico de AmazonSES. Este mensaje variará según el correo electrónico, el servidor de correo receptor y el receptorISP.
reportingMTA	El nombre de host del servidor de SES correo de Amazon que envió el correo.

Objeto Send

El JSON objeto que contiene información sobre un send evento siempre está vacío.

Objeto Reject

El JSON objeto que contiene información sobre un Reject evento siempre tendrá los siguientes campos.

Nombre del campo	Descripción
reason	La razón por la que se rechazó el correo electrónico. El único valor posible esBad content, lo que significa que Amazon SES detectó que el correo electrónico contenía un virus. Cuando se rechaza un mensaje, Amazon SES deja de procesarlo y no intenta entregarlo al servidor de correo del destinatario.

Objeto Open

El JSON objeto que contiene información sobre un Open evento siempre contendrá los siguientes campos.

Nombre del campo	Descripción
ipAddress	La dirección IP del destinatario.
timestamp	La fecha y la hora en que se produjo el evento abierto en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.SZ).
userAgent	El agente del usuario del dispositivo o cliente de correo electrónico que el destinatario utiliza para abrir el correo electrónico.

Objeto Click

El JSON objeto que contiene información sobre un evento siempre contendrá los siguientes campos. Click

Nombre del campo	Descripción
ipAddress	La dirección IP del destinatario.
timestamp	La fecha y la hora en que se produjo el evento de clic en formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).
userAgent	El agente del usuario del cliente que el destinatario usó para hacer clic en un enlace en el correo electrónico.
link	El enlace en el que hizo clic el destinatario. URL
linkTags	Una lista de las etiquetas que se añadieron al enlace utilizando el atributo ses:tags. Para obtener más información sobre la adición de etiquetas a enlaces en sus correos electrónicos, consulte P5. ¿Puedo etiquetar enlaces con identificadores únicos? en la Preguntas frecuentes sobre métricas de envío de correo electrónico de Amazon SES.

Objeto Rendering Failure

El JSON objeto que contiene información sobre un Rendering Failure evento tiene los siguientes campos.

Nombre del campo	Descripción
templateName	El nombre de la plantilla que se usó para enviar el correo electrónico.
errorMessage	Un mensaje que proporciona más información sobre el error de presentación.

DeliveryDelay objeto

El JSON objeto que contiene información sobre un DeliveryDelay evento tiene los siguientes campos.

Nombre del campo	Descripción
delayType	El tipo de retraso. Los valores posibles son los siguientes: InternalFailure— Un SES problema interno de Amazon provocó que el mensaje se retrasara. General: se produjo un error genérico durante la SMTP conversación. MailboxFull— El buzón del destinatario está lleno y no puede recibir más mensajes. SpamDetected— El servidor de correo del destinatario ha detectado una gran cantidad de correo electrónico no solicitado de su cuenta. RecipientServerError— Un problema temporal con el servidor de correo electrónico del destinatario impide la entrega del mensaje. IPFailure— El proveedor de correo electrónico del destinatario bloquea o limita la dirección IP que envía el mensaje. TransientCommunicationFailure— Se produjo un error temporal de comunicación durante la SMTP conversación con el proveedor de correo electrónico del destinatario. BYOIPHostNameLookupUnavailable— Amazon no SES ha podido buscar el DNS nombre de host de tus direcciones IP. Este tipo de retraso únicamente se produce cuando se utiliza Bring Your Own IP. Indeterminado: Amazon SES no ha podido determinar el motivo del retraso en la entrega. SendingDeferral— Amazon SES ha considerado apropiado aplazar internamente el mensaje.
delayedRecipients	Objeto que contiene información sobre el destinatario del correo electrónico.
expirationTime	La fecha y la hora en SES que Amazon dejará de intentar entregar el mensaje. Este valor se muestra en formato ISO 8601.
reportingMTA	La dirección IP del agente de transferencia de mensajes (MTA) que informó del retraso.
timestamp	La fecha y la hora en que se produjo el retraso, mostradas en formato ISO 8601.

Destinatarios con retraso

El objeto delayedRecipients contiene los siguientes valores.

Nombre del campo	Descripción
emailAddress	La dirección de correo electrónico que provocó el retraso en la entrega del mensaje.
status	El código SMTP de estado asociado al retraso en la entrega.
diagnosticCode	El código de diagnóstico proporcionado por el agente de transferencia de mensajes receptor (MTA).

Objeto suscripción

El JSON objeto que contiene información sobre un Subscription evento tiene los siguientes campos.

Nombre del campo	Descripción
contactList	El nombre de la lista de contacto está activado.
timestamp	La fecha y la hora, en formato ISO86 01 (YYYY-MM-:MM:SS.SZ DDThh), en las que se envió la notificación de suscripción. ISP
source	La dirección de correo electrónico desde la que se envió el mensaje (la dirección del sobre). MAIL FROM
newTopicPreferences	JSONEstructura de datos (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos e indica el estado después de un cambio (contacto suscrito o cancelado).
oldTopicPreferences	Una JSON estructura de datos (mapa) que especifica el estado de suscripción de todos los temas de la lista de contactos e indica el estado anterior al cambio (contacto suscrito o cancelado).

Preferencias de tema nuevo o antiguo

Los objetos newTopicPreferences y oldTopicPreferences contienen los siguientes valores.

Nombre del campo	Descripción
unsubscribeAll	Especifica si se canceló la suscripción del contacto de todos los temas de la lista de contactos.
topicSubscriptionStatus	Especifica el estado de la suscripción del tema en el topicName campo que indica si está suscrito actualmente para recibir notificaciones sobre el tipo de evento especificadoSES. Los valores posibles son OptIn(suscrito) o OptOut(cancelado) en el campo. subscriptionStatus
topicDefaultSubscriptionStatus	Especifica el estado de suscripción predeterminado del tema en el topicName campo, lo que determina si los nuevos temas que se agreguen al destino del evento se suscribirán o cancelarán de forma predeterminada. Los valores posibles están OptIn(suscritos de forma predeterminada) o OptOut(cancelados de forma predeterminada) en el campo. subscriptionStatus