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.
Para que pueda realizar un seguimiento detallado de sus envíos de correo electrónico, puede configurar Amazon SES para que publique los eventos de envío de correos electrónicos a Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service o EventBridge Amazon 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 CloudWatch y crear paneles que hagan un seguimiento del rendimiento de sus campañas de correo electrónico, o puede utilizar Amazon SNS para enviarle 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.
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-<
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 a
or
b
>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 Feedback-ID
encabezado está compuesto por el identificador, el SESInternalID, que utiliza SES para recopilar la información sobre las quejas, y 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-<
especificándolo como etiqueta de mensaje en el campo a
or
b
>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-<
al encabezado X-SES-MESSAGE-TAGS específico de SES.a
or
b
>
La etiqueta de ses:feedback-id-<
mensaje también se puede rastrear en Amazon CloudWatch especificándola como fuente de CloudWatch valor como cualquier otra etiqueta de mensaje, consulte Añadir un destino de eventos de CloudWatch (Se aplican cargos adicionales, consulte Precio por métrica para) CloudWatch.a
or
b
>
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— El correo electrónico no se envió debido a un problema de representació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
oSendBulkTemplatedEmail
). -
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 suaves solo se incluyen cuando SES ya no vuelve a intentar entregar el correo electrónico. Por lo general, estos rebotes suaves indican un error en la entrega, aunque en algunos casos se puede devolver un rebote suave incluso cuando el correo llega correctamente a la bandeja de entrada del destinatario. Esto suele ocurrir cuando el destinatario envía una respuesta out-of-office automática. Obtén más información sobre los rebotes suaves 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— No se pudo entregar el correo electrónico 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 enlaceUnsubscribe
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
-
Un AWS servicio en el que se publican los eventos de envío de correos electrónicos 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.