Datos de eventos de recorrido de Amazon Pinpoint - Amazon Pinpoint

Datos de eventos de recorrido de Amazon Pinpoint

Cuando publica un recorrido, Amazon Pinpoint puede transmitir datos de eventos de mensajes de correo electrónico, SMS, notificación push y personalizados que envíe desde el recorrido. Tras configurar la transmisión de eventos, Amazon Pinpoint recupera los datos desde el destino que haya especificado durante la configuración para que pueda verlos. Para obtener información detallada sobre los datos que Amazon Pinpoint transmite para mensajes de correo electrónico y SMS, consulte Flujo de datos de eventos de correo electrónico desde Amazon Pinpoint y Flujo de datos de eventos de SMS desde Amazon Pinpoint. Para obtener información sobre cómo configurar transmisiones de eventos, consulte Configurar Amazon Pinpoint para transmitir datos de eventos de aplicación a través de Amazon Kinesis o Amazon Data Firehose .

Ejemplo de evento de recorrido

El objeto JSON de un evento de recorrido contiene los datos que se muestran en el siguiente ejemplo.

{ "event_type":"_journey.send", "event_timestamp":1572989078843, "arrival_timestamp":1572989078843, "event_version":"3.1", "application":{ "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk":{ } }, "client":{ "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample" }, "device":{ "platform":{ } }, "session":{ }, "attributes":{ "journey_run_id":"edc9a0b577164d1daf72ebd15example", "journey_send_status":"SUCCESS", "journey_id":"546401670c5547b08811ac6a9example", "journey_activity_id":"0yKexample", "journey_activity_type": "EMAIL", "journey_send_status_message": "200", "journey_send_status_code": "200" }, "client_context":{ "custom":{ "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}" } }, "awsAccountId":"123456789012" }

Atributos de eventos de recorrido

En esta sección se definen los atributos que se incluyen en los datos de la secuencia de eventos que Amazon Pinpoint genera para un recorrido.

Atributo Descripción
event_type

El tipo de evento. Para los eventos de recorrido, el valor de este atributo es siempre _journey.send, lo que indica que Amazon Pinpoint ejecutó el recorrido.

event_timestamp

La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos.

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 esquema JSON del evento.

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 Application (Aplicación) para obtener más información.

client

Información sobre el punto de enlace que está asociado al 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 recorridos, este objeto está vacío.

session

Información sobre la sesión que generó el evento. Para recorridos, este objeto está vacío.

attributes

Los atributos que están asociados con el recorrido y la actividad de recorrido que generó el evento. Consulte la tabla de la sección Attributes (Atributos) para obtener más información.

client_context Contiene un objeto custom, que contiene una propiedad endpoint. La propiedad endpoint contiene el contenido del registro de punto de enlace del punto de enlace asociado al evento.
awsAccountId

El ID de la cuenta de AWS que se utilizó para ejecutar el recorrido.

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 utilizó para notificar el evento.

Cliente

Incluye información sobre el punto de enlace al que está asociado con el evento.

Atributo Descripción
client_id ID del punto de enlace.

Atributos

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

Atributo Descripción
journey_run_id

El ID único del recorrido ejecutado que generó el evento. Amazon Pinpoint genera y asigna este ID automáticamente a cada nueva ejecución de un recorrido.

journey_send_status

Indica el estado de entrega del mensaje que está asociado al evento. Los valores posibles son:

  • SUCCESS: el mensaje se envió correctamente al punto de conexión.

  • FAILURE: el mensaje no se envió al punto de conexión porque se produjo un error.

  • CUSTOM_DELIVERY_FAILURE: se ha producido un error al realizar entrega personalizada.

  • FAILURE_PERMANENT: se ha producido un error permanente al enviar al punto de conexión.

    sugerencia

    Puede filtrar los eventos con el estado FAILURE_PERMANENT y journey_send_status_code establecido en 403 para determinar si existe una infracción de la política de acceso o del rol. En el caso de las campañas externas con voz, estas excepciones son habituales en los casos en que el rol de ejecución de la campaña de Connect que vincula los recorridos de Amazon Pinpoint a las campañas de Amazon Connect se elimina sin querer para las ejecuciones de recorridos en proceso.

  • THROTTLED: el envío estaba limitado.

  • UNSUPPORTED_CHANNEL: el canal no es compatible.

  • DAILY_CAP: el mensaje no se envió al punto de conexión porque el envío del mensaje superaría el número máximo de mensajes que el recorrido o el proyecto pueden enviar a un único punto de conexión en un periodo de 24 horas.

  • QUIET_TIME: el mensaje no se envió debido a las restricciones de tiempo de silencio durante el recorrido o el proyecto.

  • QUIET_TIME_MISSING_TIMEZONE: el mensaje no se envió porque la estimación de la zona horaria no pudo estimar un zona horaria para el punto de conexión y el modo silencioso está habilitado.

journey_id

El identificador único del recorrido que generó el evento.

journey_activity_id

El identificador único de la actividad de recorrido que generó el evento.

journey_activity_type

El tipo de actividad de recorrido del evento. Esto puede ser EMAIL, SMS, PUSH, CONTACT_CENTER o CUSTOM.

nota

VOICE no es un tipo de actividad de recorrido compatible.

journey_send_status_message

La descripción del estado del evento de envío.
journey_send_status_code El código de estado HTTP de la solicitud.