Monitoreo del envío de correo electrónico mediante la publicación de eventos de Amazon SES - Amazon Simple Email Service

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.

Monitoreo del envío de correo electrónico mediante la publicación de eventos de Amazon SES

Para habilitar el seguimiento del envío de correo electrónico de forma detallada, puede configurar Amazon SES para publicar eventos de envío de correo electrónico en Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service o Amazon EventBridge en función de las características que defina.

Puede realizar un seguimiento de varios tipos de eventos de envío de correo electrónico, incluidos envíos, entregas, aperturas, clics, rebotes, quejas, rechazos, fallos de representación y retrasos en la entrega. Esta información puede resultar útil para fines operativos y de análisis. Por ejemplo, puede publicar sus datos de envío de correo electrónico a CloudWatch y crear paneles que realicen un rastreo del rendimiento de sus campañas de correo electrónico o puede utilizar Amazon SNS para que le envíe notificaciones cuando se produzcan determinados eventos.

Funcionamiento de la publicación de eventos con conjuntos de configuración y etiquetas de mensajes

Para utilizar la publicación de eventos, primero debe configurar uno o varios conjuntos de configuración. Un conjunto de configuración especifica dónde publicar los eventos y qué eventos publicar. A continuación, cada vez que envíe un correo electrónico, proporcione el nombre del conjunto de configuración y una o varias etiquetas de mensajes, en forma de pares nombre/valor, para clasificar el correo electrónico. Por ejemplo, si promociona libros, puede denominar una etiqueta del mensaje como género y asignarle un valor de ciencia ficción o western, cuando envíe un correo electrónico para la campaña asociada.

En función de la interfaz de envío de correo electrónico que utilice, tendrá que proporcionar la etiqueta del mensaje como parámetro al campo EmailTags de la operación SendEmail de la API o agregar la etiqueta de mensaje al encabezado de correo electrónico X-SES-MESSAGE-TAGS específico de SES. Para obtener más información acerca de los conjuntos de configuración, consulte Uso de conjuntos de configuración en Amazon SES.

Además de las etiquetas de mensajes que especifique, SES también agrega etiquetas automáticas a los mensajes que se envían. No necesita realizar ningún paso adicional para utilizar etiquetas automáticas.

En la siguiente tabla, se muestran las etiquetas automáticas que se aplican automáticamente a los mensajes que se envían con SES.

Etiquetas automáticas de SES
Nombre de etiqueta automática Descripción
ses:caller-identity Identidad de IAM del usuario de SES que ha enviado el correo electrónico.
ses:configuration-set El nombre del conjunto de configuración asociado al correo electrónico.
ses:from-domain El dominio de la dirección del remitente ("From").
ses:outgoing-ip Dirección IP que SES ha utilizado para enviar el correo electrónico.
ses:source-ip La dirección IP que el intermediario utilizó para enviar el correo electrónico.
ses:source-tls-version La versión del protocolo TLS que el intermediario usó para enviar el correo electrónico.
ses:outgoing-tls-version Versión del protocolo TLS que el intermediario ha utilizado para enviar el correo electrónico.

Retroalimentación detallada de las campañas de correo electrónico

ses:feedback-id-<a or b> es una etiqueta de mensaje opcional que se puede considerar híbrida o semiautomática. Si bien es similar a las etiquetas automáticas descritas en la sección anterior, la diferencia es que hay que agregarla manualmente y usar la clave de prefijo ses:. Puede utilizar hasta dos de estas etiquetas definidas como ses:feedback-id-a y ses:feedback-id-b.

Cuando se especifican estas etiquetas, SES las agrega automáticamente al encabezado Feedback-ID estándar que se utiliza para proporcionar estadísticas de entrega, como las tasas de quejas y spam, dentro de un bucle de retroalimentación (FBL); consulte Bucles de retroalimentación. El encabezado Feedback-ID consta del identificador, SESInternalID, que SES utiliza para recopilar información de las quejas, y de la etiqueta estática, AmazonSES, que identifica a SES como la plataforma de envío; por ejemplo:

FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))

Estas etiquetas opcionales de identificación de la retroalimentación se ofrecen como una forma de generar retroalimentación detallada; por ejemplo, para los mensajes que se envían en el marco de una campaña de correo electrónico. Puede utilizar ses:feedback-id-<a or b> especificándolo como etiqueta de mensaje en el campo EmailTags de la solicitud de la operación SendEmail, como se muestra en el siguiente ejemplo:

{ "FromEmailAddress": "noreply@example.com", "Destination": { "ToAddresses": [ "customer@example.net" ] }, "Content": { "Simple": { "Subject": { "Data": "Hello and welcome" }, "Body": { "Text": { "Data": "Lorem ipsum dolor sit amet." }, "Html": { "Data": "Lorem ipsum dolor sit amet." } } } }, "EmailTags": [ { "Name": "ses:feedback-id-a", "Value": "new-members-campaign" }, { "Name": "ses:feedback-id-b", "Value": "football-campaign" } ], "ConfigurationSetName": "football-club" }

Si lo envía en formato sin procesar, es preciso agregar la etiqueta de mensaje ses:feedback-id-<a or b> al encabezado X-SES-MESSAGE-TAGS específico de SES.

El seguimiento de la etiqueta de mensaje ses:feedback-id-<a or b> también se puede realizar en Amazon CloudWatch. Para ello, es preciso especificarla como origen de valor de CloudWatch, al igual que cualquier otra etiqueta de mensaje; consulte Agregar un destino de eventos de CloudWatch. (Se aplican cargos adicionales; consulte Price per metric for CloudWatch).

Cómo utilizar la publicación de eventos

Las siguientes secciones contienen la información necesaria para configurar y utilizar la publicación de eventos de SES.

Terminología de publicación de eventos

En la siguiente lista se definen los términos relacionados con la publicación de eventos de SES.

Evento de envío de correo electrónico

Información asociada con el resultado de un correo electrónico que envía a SES. Los eventos de envío incluyen lo siguiente:

  • Send (Envío): la solicitud de envío se realizó de forma correcta y Amazon SES intentará entregar el mensaje al servidor de correo del destinatario. (Si se está utilizando la supresión global o de nivel de cuenta, SES lo seguirá contando como un envío, pero la entrega se suprimirá).

  • RenderingFailure: no se envió el correo electrónico debido a un problema con la presentación de la plantilla. Este tipo de evento se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de la plantilla no coinciden. (Este tipo de evento solo se produce cuando envía correo electrónico con las operaciones de la API SendTemplatedEmail o SendBulkTemplatedEmail).

  • Reject (Rechazo): Amazon SES aceptó el correo electrónico, pero determinó que contenía un virus y no intentó entregarlo al servidor de correo del destinatario.

  • Delivery (Entregados): Amazon SES entregó correctamente el correo electrónico al servidor de correo del destinatario.

  • Rebotar: una devolución permanente que el servidor de correo del destinatario ha rechazado el correo electrónico de forma permanente. (Los rebotes temporales solo se incluyen cuando SES ya no vuelve a intentar entregar el correo electrónico. Por lo general, indican un error en la entrega, si bien en algunos casos se puede devolver un rebote temporal aunque el correo haya llegado correctamente a la bandeja de entrada del destinatario. Esto suele ocurrir cuando el destinatario envía una respuesta automática de fuera de la oficina. Puede obtener más información sobre los rebotes temporales en este artículo de AWS re:Post.)

  • Complaint (Reclamo): el correo electrónico se entregó correctamente al servidor de correo del destinatario, pero el destinatario lo marcó como spam.

  • DeliveryDelay: el correo electrónico no se pudo entregar al servidor de correo del destinatario porque se produjo un problema temporal. Pueden producirse retrasos en la entrega, por ejemplo, si la bandeja de entrada del destinatario está llena o el servidor de recepción de email experimenta un problema transitorio.

  • Subscriptions (Suscripciones): el correo electrónico se entregó correctamente, pero el destinatario actualizó las preferencias de suscripción al hacer clic en List-Unsubscribe en el encabezado del correo electrónico o el enlace Unsubscribe del pie de página.

  • Open (Abiertos): el destinatario recibió el mensaje y lo abrió en su cliente de correos electrónicos.

  • Clic: el destinatario hizo clic en uno o varios enlaces incluidos en el correo electrónico.

Conjunto de configuración

Conjunto de reglas que define el destino en el que SES publica los eventos de envío de correo electrónico y los tipos de eventos de envío de correo electrónico que se desea publicar. Cuando envíe un correo electrónico que desea utilizar con la publicación de eventos, especifique el conjunto de configuración que asociar con el correo electrónico.

Destino de eventos

Servicio de AWS en el que se publican los eventos de envío de correo electrónico de SES. Cada destino de eventos que configure pertenece a uno y solo a un conjunto de configuración.

Etiqueta de mensajes

Un par nombre/valor que utiliza para clasificar un correo electrónico para fines de publicación de eventos. Los ejemplos son campaña/libro y campaña/ropa. Cuando se envía un correo electrónico, se especifica la etiqueta del mensaje como parámetro a la llamada a la API o como encabezado de correo electrónico específico de SES.

Etiqueta automática

Las etiquetas de mensajes que se incluyen automáticamente en informes de publicación de eventos. Hay una etiqueta automática para el nombre del conjunto de configuración, el dominio de la dirección de origen, la dirección IP de salida del intermediario, la dirección IP saliente de SES y la identidad de IAM del intermediario.