Amazon Simple Email Service
Guía del desarrollador

Monitorización utilizando 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 o Amazon Kinesis Data Firehose en función de las características de correo electrónico detallado que defina. Por ejemplo, puede clasificar los correos electrónicos por finalidad (transacciones frente a marketing), detalles del producto, el dominio ("From") del destinatario, etc.

Puede realizar un seguimiento de varios tipos de eventos de envío de correo electrónico, incluidos envíos, entregas, mensajes abiertos, clics, rebotes, reclamaciones y rechazos. 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 realizan un seguimiento del rendimiento de sus campañas de correo electrónico.

Cómo funciona la publicación de eventos

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 a la llamada a la API o como encabezado de correo electrónico específico de Amazon SES. Para obtener más información acerca de los conjuntos de configuración, consulte Uso de conjuntos de configuración de Amazon SES.

Además de las etiquetas de mensajes que especifique, Amazon SES también añade etiquetas automáticas a los mensajes que envía. 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 envía con Amazon SES.

Etiquetas automáticas de Amazon SES

Nombre de etiqueta automática Descripción
ses:configuration-set El nombre del conjunto de configuración asociado al correo electrónico.
ses:caller-identity La identidad de IAM del usuario de Amazon SES que ha enviado el correo electrónico.
ses:from-domain El dominio de la dirección del remitente ("From").
ses:source-ip La dirección IP que el intermediario utilizó para enviar el correo electrónico.
ses:outgoing-ip La dirección IP que Amazon SES utilizó para enviar el correo electrónico.

Cómo utilizar la publicación de eventos

Las siguientes secciones contienen la información que tiene que configurar y utilizar la publicación de eventos de Amazon SES.

Terminología de publicación de eventos

La siguiente lista define términos relacionados con la publicación de eventos de Amazon SES.

Evento de envío de correo electrónico

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

  • Sends (Envíos): la llamada a Amazon SES se realizó correctamente y Amazon SES intentará entregar el correo electrónico.

  • Rejects (Rechazos): Amazon SES aceptó el correo electrónico, determinó que contenía un virus y lo rechazó. Amazon SES no intentará entregar el correo electrónico al servidor de correo del destinatario.

  • Rebotes: el servidor de correo del destinatario ha rechazado permanentemente el correo electrónico. Este evento se corresponde con rebotes permanentes. Los rebotes provisionales solo se incluyen cuando Amazon SES no puede entregar el correo electrónico tras intentarlo durante un periodo de tiempo.

  • Complaints (Reclamaciones): el correo electrónico se ha entregado correctamente al destinatario. El destinatario marcó el correo electrónico como spam.

  • Entregas: Amazon SES entregó correctamente el correo electrónico al servidor de correo del destinatario.

  • Abiertos: el destinatario recibió el mensaje y lo abrió en su cliente de correo electrónico.

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

  • Rendering Failures (Errores de representación): el correo electrónico no se ha enviado por un problema de representación de la plantilla. Este tipo de evento solo se produce cuando se envía correo electrónico mediante las operaciones SendTemplatedEmail o SendBulkTemplatedEmail de la API. 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.

Conjunto de configuración

Un constructo de Amazon SES que encapsula dónde desea publicar los eventos de envío de correo electrónico y qué eventos de envío de correo electrónico 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

Una construcción de Amazon SES que representa un servicio de AWS en el que se publican los eventos de envío de correo electrónico de Amazon 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 envíe un correo electrónico, especifica la etiqueta del mensaje como parámetro a la llamada a la API o como encabezado de correo electrónico específico de Amazon 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 "From", la dirección IP de salida del intermediario, la dirección IP saliente de Amazon SES y la identidad de IAM del intermediario.

Para obtener información y ver disertaciones sobre diversos temas relacionados con Amazon SES, consulte el Blog de AWS sobre mensajería y selección de destinatarios. Para buscar y publicar preguntas, visite Foro de Amazon SES.