Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Contenido de los datos de eventos que Amazon SES publica en Firehose
<a name="event-publishing-retrieving-firehose-contents"></a>

Amazon SES publica los registros de eventos de envío de correo electrónico en Amazon Data Firehose en formato JSON. Al publicar eventos en Firehose, Amazon SES agrega a cada registro JSON 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](event-publishing-retrieving-firehose-examples.md).

**Topics**
+ [Objeto JSON de nivel superior](#event-publishing-retrieving-firehose-contents-top-level-json-object)
+ [Objeto Mail](#event-publishing-retrieving-firehose-contents-mail-object)
+ [Objeto Bounce](#event-publishing-retrieving-firehose-contents-bounce-object)
+ [Objeto Complaint](#event-publishing-retrieving-firehose-contents-complaint-object)
+ [Objeto Delivery](#event-publishing-retrieving-firehose-contents-delivery-object)
+ [Objeto Send](#event-publishing-retrieving-firehose-contents-send-object)
+ [Objeto Reject](#event-publishing-retrieving-firehose-contents-reject-object)
+ [Objeto Open](#event-publishing-retrieving-firehose-contents-open-object)
+ [Objeto Click](#event-publishing-retrieving-firehose-contents-click-object)
+ [Objeto Rendering Failure](#event-publishing-retrieving-firehose-contents-failure-object)
+ [DeliveryDelay objeto](#event-publishing-retrieving-firehose-delivery-delay-object)
+ [Objeto suscripción](#event-publishing-retrieving-firehose-subscription-object)

## Objeto JSON de nivel superior
<a name="event-publishing-retrieving-firehose-contents-top-level-json-object"></a>

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


| Nombre del campo | Description (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](monitor-sending-using-event-publishing-setup.md) este campo se denomina `notificationType`.  | 
|  `mail`  |  Un objeto JSON que contiene información acerca del mensaje de 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
<a name="event-publishing-retrieving-firehose-contents-mail-object"></a>

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 objeto JSON que contiene información acerca de un objeto `mail` tiene los campos siguientes.


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `timestamp`  |  La fecha y la hora, en ISO8601 formato (*AAAA-MM DDThh -:MM:SS.sz*), en que se envió el mensaje.  | 
|  `messageId`  |  Un ID exclusivo que Amazon SES asignó al mensaje. Amazon SES le devolvió este valor cuando envió el mensaje.  Este ID de mensaje lo asignó Amazon SES. 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 dirección MAIL FROM del sobre).  | 
|  `sourceArn`  |  El nombre de recurso de Amazon (ARN) de la identidad que se utilizó para enviar el correo electrónico. En el caso de una autorización de envío, el `sourceArn` es el ARN de la identidad que el propietario de la identidad autorizó utilizar al remitente delegado 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ónicoUso de la autorización de envío](sending-authorization.md).  | 
|  `sendingAccountId`  |  El identificador de la AWS 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`.  Cualquier ID de mensaje dentro del campo `headers` procede del mensaje original que pasó a Amazon SES. El ID de mensaje que Amazon SES asignó seguidamente al mensaje está en el campo `messageId` del objeto `mail`.   | 
|  `commonHeaders`  |  Un mapeo de los encabezados originales del correo electrónico utilizados habitualmente.  El ID de mensaje dentro del campo `commonHeaders` es el ID de mensaje que Amazon SES asignó seguidamente al mensaje en el campo `messageId` del objeto `mail`.   | 
|  `tags`  |  Una lista de etiquetas asociadas al correo electrónico.  | 

## Objeto Bounce
<a name="event-publishing-retrieving-firehose-contents-bounce-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `bounceType`  |  El tipo de rebote, tal como determina Amazon SES.  | 
|  `bounceSubType`  |  El subtipo de rebote, tal como determina 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 ISO8601 formato (*AAAA-MM DDThh -:MM:ss.sz*), en las que el ISP envió la notificación de rebote.  | 
|  `feedbackId`  |  Un ID único para el rebote.  | 
|  `reportingMTA`  |  El valor del campo `Reporting-MTA` del DSN. Se trata del valor de la autoridad de transferencia de mensajes (MTA) que intentó realizar la operación de entrega, retransmisión o gateway descrita en el DSN.  Este campo solo aparece si se ha adjuntado una notificación de estado de entrega (DSN) al rebote.   | 

### Destinatarios con rebote
<a name="event-publishing-retrieving-firehose-contents-bounced-recipients"></a>

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 | Description (Descripción) | 
| --- | --- | 
|  `emailAddress`  |  La dirección de correo electrónico del destinatario. Si hay un DSN disponible, se trata del valor del campo `Final-Recipient` del DSN.  | 

Opcionalmente, si hay un DSN adjunto al rebote, los siguientes campos también podrían estar presentes.


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `action`  |  El valor del campo `Action` del DSN. Esto indica la acción que realiza el MTA de notificación como resultado de su intento de entregar el mensaje a este destinatario.  | 
|  `status`  |  El valor del campo `Status` del DSN. 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 la MTA de notificación. Este es el valor del campo `Diagnostic-Code` del DSN. Este campo puede estar ausente en el DSN (y, por lo tanto, también ausente en el JSON).  | 

### Tipos de rebote
<a name="event-publishing-retrieving-firehose-contents-bounce-types"></a>

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 rechazos permanentes y rebotes temporales que Amazon SES ya no volverá a intentar. Si recibe rebotes marcados como `Permanent`, debería eliminar las direcciones de correo electrónico correspondientes de su lista de correo, ya que no podrá enviar mensajes a estas en el futuro. Los rebotes `Transient` se le envían cuando un mensaje ha tenido un rebote temporal varias veces y Amazon SES ha dejado de intentar volver a enviarlo. 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 | Description (Descripción) | 
| --- | --- | --- | 
|  `Undetermined`  |  `Undetermined`  |  Amazon SES no ha podido determinar un motivo específico de rebote.  | 
|  `Permanent`  |  `General`  |  Amazon SES recibió un rechazo permanente 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 rechazo 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 dado que tiene un historial reciente de rebotes como dirección no válida. Para anular la lista de supresión global, consulte [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md).   | 
| Permanent | OnAccountSuppressionList | Amazon SES ha suprimido el envío a esta dirección porque está en la [lista de supresión de nivel de cuenta](sending-email-suppression-list.md). 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 ha recibido un rebote completo de bandeja de entrada. Es posible que pueda enviar correctamente a este destinatario en el futuro.  | 
|  `Transient`  |  `MessageTooLarge`  |  Amazon SES recibió un rebote de mensaje demasiado grande. Es posible que pueda enviar correctamente a este destinatario si reduce el tamaño del mensaje.  | 
|  `Transient`  |  `CustomTimeoutExceeded`  |  Amazon SES no ha podido entregar correctamente el correo electrónico en el tiempo especificado por el remitente. *(El mensaje de rebote especificará el motivo de cualquier posible error en el intento de entrega dentro del TTL definido).*   | 
|  `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 archivo adjunto rechazado. Es posible que pueda enviar correctamente a este destinatario si elimina o cambia el archivo adjunto.  | 

## Objeto Complaint
<a name="event-publishing-retrieving-firehose-contents-complaint-object"></a>

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


| Nombre del campo | Description (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 (AAAA-MM-:MM:SS.SZ), en ISO8601 que el ISP envió la notificación de queja. DDThh*  | 
|  `feedbackId`  |  Un ID único para el reclamo.  | 
|  `complaintSubType`  |  El subtipo del reclamo, tal como determina Amazon SES.  | 

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


| Nombre del campo | Description (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 campo `Feedback-Type` del informe de retroalimentación recibido desde el ISP. Contiene el tipo de retroalimentación.  | 
|  `arrivalDate`  |  *El valor del campo o del informe de comentarios en formato (AAAA-MM `Arrival-Date` -:MM:SS.sz). `Received-Date` ISO8601 DDThh* Este campo puede estar ausente en el informe (y, por lo tanto, también ausente en el JSON).  | 

### Destinatarios con reclamaciones
<a name="event-publishing-retrieving-firehose-contents-complained-recipients"></a>

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

**importante**  
Como la mayoría de ISPs las veces no incluye 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, basada en los destinatarios del mensaje original y en el ISP del que recibimos la queja. Amazon SES realiza una búsqueda en el mensaje original para determinar esta lista de destinatarios.

Los objetos JSON de esta lista contienen el siguiente campo.


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `emailAddress`  |  La dirección de correo electrónico del destinatario.  | 

### Tipos de reclamación
<a name="event-publishing-retrieving-firehose-contents-complaint-types"></a>

Es posible que vea los siguientes tipos de reclamación en el campo `complaintFeedbackType` tal como los ha asignado el ISP que realiza la notificación, de acuerdo con el [sitio web de Internet Assigned Numbers Authority](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):


| Nombre del campo | Description (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
<a name="event-publishing-retrieving-firehose-contents-delivery-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `timestamp`  |  La fecha y la hora en que Amazon SES entregó el correo electrónico al servidor de correo del destinatario, en ISO8601 formato (*YYYY-MM* -:MM:SS.sz). DDThh  | 
|  `processingTimeMillis`  |  El tiempo en milisegundos desde el momento en que Amazon SES aceptó la solicitud del remitente hasta el momento en que Amazon SES transfirió el mensaje al servidor de email del destinatario.  | 
|  `recipients`  |  Una lista de los destinatarios a los que corresponden los eventos de entrega.  | 
|  `smtpResponse`  |  El mensaje de respuesta SMTP del ISP remoto que ha aceptado el correo electrónico desde Amazon SES. Este mensaje variará por email, por receptor de servidor de recepción de email y por ISP de recepción.  | 
|  `reportingMTA`  |  El nombre del anfitrión del servidor de email de Amazon SES que envió el email.  | 
|  `remoteMtaIp`  |  La dirección IP de la MTA a la que Amazon SES entregó el correo electrónico.  | 

## Objeto Send
<a name="event-publishing-retrieving-firehose-contents-send-object"></a>

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

## Objeto Reject
<a name="event-publishing-retrieving-firehose-contents-reject-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `reason`  |  La razón por la que se rechazó el correo electrónico. El único valor posible es `Bad content`, lo que significa que Amazon SES detectó que el correo electrónico contenía un virus. Cuando se rechaza un mensaje, Amazon SES detiene el procesamiento y no intenta entregarlo al servidor de correo del destinatario.  | 

## Objeto Open
<a name="event-publishing-retrieving-firehose-contents-open-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `ipAddress`  |  La dirección IP del destinatario.  | 
|  `timestamp`  |  *La fecha y la hora en que se produjo el evento de apertura en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 DDThh*  | 
|  `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
<a name="event-publishing-retrieving-firehose-contents-click-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `ipAddress`  |  La dirección IP del destinatario.  | 
|  `timestamp`  |  *La fecha y la hora en que se produjo el clic en el formato (AAAA-MM-:MM:SS.SZ). ISO8601 DDThh*  | 
|  `userAgent`  |  El agente del usuario del cliente que el destinatario usó para hacer clic en un enlace en el correo electrónico.  | 
|  `link`  |  La dirección URL del enlace en el que el destinatario hizo clic.  | 
|  `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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) en la [Métricas de envío de correo electrónico de Amazon SES FAQs](faqs-metrics.md).  | 

## Objeto Rendering Failure
<a name="event-publishing-retrieving-firehose-contents-failure-object"></a>

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


| Nombre del campo | Description (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
<a name="event-publishing-retrieving-firehose-delivery-delay-object"></a>

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


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
|  `delayType`  |  El tipo de retraso. Los valores posibles son los que se indican a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/ses/latest/dg/event-publishing-retrieving-firehose-contents.html)  | 
|  `delayedRecipients`  |  Objeto que contiene información sobre el destinatario del correo electrónico.  | 
|  `expirationTime`  |  La fecha y hora en que Amazon SES 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`  |  Fecha y hora en que se produjo el retraso, que se muestra en formato ISO 8601.  | 

### Destinatarios con retraso
<a name="event-publishing-retrieving-firehose-contents-delivery-delay-object-recipients"></a>

El objeto `delayedRecipients` contiene los siguientes valores.


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

## Objeto suscripción
<a name="event-publishing-retrieving-firehose-subscription-object"></a>

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


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

### Preferencias de tema nuevo o antiguo
<a name="event-publishing-retrieving-firehose-contents-subscription-object-topic-preferences"></a>

Los objetos `newTopicPreferences` y `oldTopicPreferences` contienen los siguientes valores.


| Nombre del campo | Description (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 campo `topicName`, lo que indica si actualmente tiene una suscripción para recibir notificaciones de SES sobre el tipo de evento especificado. Los valores posibles son (suscrito) o (cancelado) en el campo. **OptIn**OptOut****`subscriptionStatus`  | 
|  `topicDefaultSubscriptionStatus`  |  Especifica el estado de suscripción predeterminado del tema en el campo `topicName`, lo que determina si la suscripción a los nuevos temas que se agreguen al destino del evento se realizará o cancelará de forma predeterminada. Los valores posibles están **OptIn**(suscrito de forma predeterminada) o **OptOut**(cancelado de suscripción de forma predeterminada) en el campo. `subscriptionStatus`  |