Ejemplos de eventos por correo electrónico Atributos de los eventos de correo electrónico

Transmisión de datos de eventos por correo electrónico desde Amazon Pinpoint

Si utiliza Amazon Pinpoint para enviar correos electrónicos, Amazon Pinpoint puede transmitir datos de eventos relacionados con esos correos electrónicos. Tras configurar la transmisión de eventos, Amazon Pinpoint recupera los datos del evento del destino que especificó durante la configuración para que los vea. Para obtener información sobre cómo configurar la transmisión de eventos, consulte. Configure Amazon Pinpoint para transmitir datos de eventos de aplicaciones a través de Amazon Kinesis o Amazon Data Firehose Amazon Pinpoint transmite datos sobre los siguientes tipos de eventos para los mensajes de correo electrónico:

Envíos
Entregas
Rebotes
Reclamos
Aperturas
Clics
Rechazos
Cancelaciones de suscripciones
Fallos de representación

Estos tipos de eventos se explican en detalle enAtributos de los eventos de correo electrónico.

En función de la API configuración que utilices para enviar mensajes de correo electrónico, es posible que veas más tipos de eventos o datos diferentes. Por ejemplo, si envía mensajes mediante conjuntos de configuración que publican datos de eventos en Amazon Kinesis, como los que proporciona Amazon Simple Email Service SES (Amazon), los datos también pueden incluir eventos relacionados con errores de representación de plantillas. Para obtener información sobre esos datos, consulte Supervisión mediante la publicación de SES eventos de Amazon en la Guía para desarrolladores de Amazon Simple Email Service. Para poder ver sus eventos, debe configurar la transmisión de eventos, consulte Configure Amazon Pinpoint para transmitir datos de eventos de aplicaciones a través de Amazon Kinesis o Amazon Data Firehose . Al configurar la transmisión de eventos, especifique un destino en el que se guardarán los datos del evento y, a continuación, podrá usar el destino para recuperar los datos del evento para su visualización.

Ejemplos de eventos por correo electrónico

Envío de correo electrónico

El JSON objeto de un evento de envío de correo electrónico contiene los datos que se muestran en el siguiente ejemplo.


{
  "event_type": "_email.send",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622025,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "received"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "send": {}
      }
    }
  }
}

Entrega de correo electrónico

El JSON objeto de un evento de entrega de correo electrónico contiene los datos que se muestran en el siguiente ejemplo.


{
  "event_type": "_email.delivered",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622690,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "delivered"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "delivery": {
          "smtp_response": "250 ok:  Message 82080542 accepted",
          "reporting_mta": "a8-53.smtp-out.amazonses.com",
          "recipients": ["recipient@example.com"],
          "processing_time_millis": 1310
        }
      }
    }
  }
}

Clic en correo electrónico

El JSON objeto de un evento de clic en un correo electrónico contiene los datos que se muestran en el siguiente ejemplo.


{
  "event_type": "_email.click",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618713751,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "https://aws.amazon.com/pinpoint/"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "click": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15",
          "link": "https://aws.amazon.com/pinpoint/"
        }
      }
    }
  }
}

Apertura de correo electrónico

El JSON objeto de un evento de apertura de correo electrónico contiene los datos que se muestran en el siguiente ejemplo.


{
  "event_type": "_email.open",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618712316,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "opened"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "open": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)"
        }
      }
    }
  }
}

Atributos de los eventos de correo electrónico

En esta sección se definen los atributos que se incluyen en el ejemplo anterior de los datos de transmisión de eventos que Amazon Pinpoint genera al enviar mensajes de correo electrónico.

Atributo	Descripción
`event_type`	El tipo de evento. Los valores posibles son los siguientes: _email.send: Amazon Pinpoint aceptó el mensaje e intentó entregarlo al destinatario. _email.delivered: el mensaje se envió al destinatario. _email.rejected: Amazon Pinpoint determinó que el mensaje contenía malware y no intentó enviarlo. _email.hardbounce: un problema permanente impedía que Amazon Pinpoint entregara el mensaje. Amazon Pinpoint no volverá a realizar un intento de entrega del mensaje. _email.softbounce: un problema temporal impedía que Amazon Pinpoint entregara el mensaje. Amazon Pinpoint volverá a realizar un intento de entrega del mensaje durante un tiempo determinado. Si el mensaje sigue sin poder entregarse, no se realizarán más reintentos. El estado final del correo electrónico será SOFTBOUNCE entonces. _email.complaint: el destinatario recibió el mensaje y, a continuación, informó del mensaje al proveedor de correo electrónico como spam (por ejemplo, mediante la característica “Denunciar spam” del cliente de correo electrónico). _email.open: el destinatario recibió el mensaje y lo abrió. _email.click: el destinatario recibió el mensaje e hizo clic en su enlace. _email.unsubscribe: el destinatario recibió el mensaje e hizo clic en su enlace para cancelar la suscripción. _email.rendering_failure: el correo electrónico no se envió debido a un error de presentación. Esto se puede producir cuando faltan datos en la plantilla o cuando los parámetros y los datos de la plantilla no coinciden.
`event_timestamp`	Hora en que se envió el mensaje, que se muestra en formato de tiempo Unix en milisegundos. Este valor suele ser el mismo para todos los eventos que se generan para un mensaje.
`arrival_timestamp`	La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos.
`event_version`	La versión del JSON esquema de eventos. sugerencia Compruebe esta versión en la aplicación de procesamiento de eventos para saber cuándo actualizar la aplicación en respuesta a una actualización del esquema.
`application`	Información sobre el proyecto de Amazon Pinpoint asociado al evento. Consulte la tabla de la sección Aplicación para obtener más información.
`client`	Información sobre el cliente de la aplicación instalado en el dispositivo que notificó el evento. Consulte la tabla de la sección Client (Cliente) para obtener más información.
`device`	Información sobre el dispositivo que notificó el evento. Para obtener más información, consulte la tabla Dispositivos. Para los eventos de correo electrónico, este objeto está vacío.
`session`	Para los eventos de correo electrónico, este objeto está vacío.
`attributes`	Atributos asociados al evento. Consulte la tabla de la sección Attributes (Atributos) para obtener más información. Para los eventos notificados por una de sus aplicaciones, este objeto puede incluir atributos personalizados definidos por la aplicación. Para los eventos que se crean al enviar un mensaje desde una campaña o recorrido, este objeto contiene atributos que están asociados a la campaña o recorrido. Para los eventos que se generan al enviar mensajes de transacciones, este objeto contiene información relacionada con el propio mensaje.
`client_context`	Para eventos de correo electrónico, este objeto contiene un objeto `custom`, que contiene un atributo `legacy_identifier`. El valor del atributo `legacy_identifier` es el ID del proyecto desde el que se envió el mensaje.
`facets`	Información adicional sobre el mensaje, como los encabezados de correo electrónico. Consulte la tabla de la sección Facetas para obtener más información.
`awsAccountId`	El ID de la AWS cuenta que se utilizó para enviar el mensaje.

Aplicación

Incluye información sobre el proyecto de Amazon Pinpoint al que está asociado el evento.

Atributo	Descripción
`app_id`	El ID único del proyecto de Amazon Pinpoint que notificó el evento.
`sdk`	El SDK que se usó para informar del evento. Si envía un mensaje de correo electrónico transaccional llamando directamente a Amazon API Pinpoint o utilizando la consola Amazon Pinpoint, este objeto está vacío.

Atributos

Incluye información sobre la campaña o el recorrido que produjo el evento.

Campaña

Incluye información sobre la campaña que produjo el evento.

Atributo	Descripción
`feedback`	En el caso de los `_email.click` eventos, el valor de este atributo es el URL del enlace en el que el destinatario hizo clic en el mensaje para generar el evento. Para otros eventos, el valor representa el tipo de evento, como `received`, `opened` o `clicked`.
`treatment_id`	Si el mensaje se envió mediante una campaña de prueba A/B, este valor representa el número de tratamiento del mensaje. Para campañas estándar y mensajes de correo electrónico de transacciones, este valor es `0`.
`campaign_activity_id`	El ID único que Amazon Pinpoint genera cuando se produce el evento.
`campaign_id`	El ID único de la campaña que envió el mensaje.

Recorrido

Incluye información sobre el recorrido que produjo el evento.

Atributo	Descripción
`journey_run_id`	El ID único del recorrido ejecutado que envió el mensaje. Amazon Pinpoint genera y asigna este ID automáticamente a cada nueva ejecución de un recorrido.
`feedback`	En el caso de los `_email.click` eventos, el valor de este atributo es el URL del enlace en el que el destinatario hizo clic en el mensaje para generar el evento. Para otros eventos, el valor representa el tipo de evento, como `received`, `delivered` o `opened`.
`journey_id`	El identificador único del recorrido que envió el mensaje.
`journey_activity_id`	El identificador único de la actividad de recorrido que envió el mensaje.

Cliente

El identificador único del cliente al que se dirigió la campaña o el recorrido.

Atributo	Descripción
`client_id`	El ID del cliente. El valor es el ID de punto final para las campañas y los viajes, y para el envío transaccional, es un. UUID

Incluye información sobre el mensaje y el tipo de evento.

Atributo	Descripción
`email_channel`	Contiene un objeto `mail_event`, que contiene dos objetos: `mail` y un objeto que se corresponde con el tipo de evento.

Mail

Incluye información sobre el contenido del mensaje de correo electrónico, así como metadatos relacionados con el mensaje.

Atributo	Descripción
`message_id`	El ID único del mensaje. Amazon Pinpoint genera automáticamente este ID cuando acepta el mensaje.
`message_send_timestamp`	La fecha y la hora en que se envió el mensaje, en el formato especificado en RFC822.
`from_address`	La dirección de correo electrónico desde la que se envió el mensaje.
`destination`	Una matriz que contiene las direcciones de correo electrónico a las que se envió el mensaje.
`headers_truncated`	Un valor booleano que indica si los encabezados de correo electrónico se han truncado.
`headers`	Un objeto que contiene varios pares nombre-valor que se corresponden con los encabezados del mensaje. Este objeto normalmente contiene información sobre los siguientes encabezados: `From`: la dirección de correo electrónico del remitente. `To`: la dirección de correo electrónico del destinatario. `Subject`: la línea de asunto del correo electrónico. sugerencia El encabezado del asunto no se incluye en los eventos de _email.send de la campaña. `MIME-Version`— Indica que el mensaje está en MIME formato. Si existe este encabezado, su valor siempre es `1.0`. `Content-Type`— El tipo de MIME soporte del contenido del mensaje.
`common_headers`	Contiene información sobre varios encabezados comunes para mensajes de correo electrónico. La información puede incluir la fecha en que se envió el mensaje y las líneas de De, Para y Asunto del mensaje.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Datos de eventos de viajes de Amazon Pinpoint

SMStransmisión de datos de eventos desde Amazon Pinpoint