**Aviso de fin de soporte:** el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte [Fin de soporte de Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: en** lo APIs que respecta a los SMS, este cambio no afecta a los mensajes de voz, a las notificaciones push móviles, a las OTP y a la validación de números de teléfono, y son compatibles con la mensajería para el usuario AWS final.
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.
# Transmitir datos de eventos de aplicación a través de Kinesis y Firehose con Amazon Pinpoint
En Amazon Pinpoint, un *evento* es una acción que se produce cuando un usuario interactúa con una de las aplicaciones, cuando envía un mensaje desde una campaña o recorrido o cuando envía un mensaje de correo electrónico o SMS transaccional. Por ejemplo, si envía un mensaje de correo electrónico, se producen varios eventos:
+ Cuando envía el mensaje, se produce un evento de *envío*.
+ Cuando el mensaje llega a la bandeja de entrada del destinatario, se produce un evento de *entrega*.
+ Cuando el destinatario abre el mensaje, se produce un evento de *apertura*.
Puede configurar Amazon Pinpoint para enviar información sobre eventos a Amazon Kinesis. La plataforma Kinesis ofrece servicios que puede utilizar para recopilar, procesar y analizar datos de los servicios de AWS en tiempo real. Amazon Pinpoint puede enviar datos de eventos a Firehose, que transmite estos datos a almacenes de datos de AWS como Amazon S3 o Amazon Redshift. Amazon Pinpoint también puede transmitir datos a Kinesis Data Streams, que ingiere y almacena varios flujos de datos para que los procesen las aplicaciones de análisis.
La secuencia de eventos de Amazon Pinpoint incluye información acerca de las interacciones de los usuarios con las aplicaciones (apps) que conecte a Amazon Pinpoint. También incluye información sobre todos los mensajes que envíe desde campañas, a través de cualquier canal y de recorridos. Esto también puede incluir cualquier evento personalizado que haya definido. Por último, incluye información sobre los correos electrónicos y los mensajes SMS de transacciones que envíe.
**nota**
Amazon Pinpoint no transmite información sobre mensajes de voz ni notificaciones de inserción de transacciones.
En este capítulo se proporciona información acerca de la configuración de Amazon Pinpoint para transmitir datos de eventos a Kinesis. También contiene ejemplos de los datos de eventos transmitidos por Amazon Pinpoint.
**Topics**
+ [Configurar Amazon Pinpoint para transmitir datos de eventos de aplicación a través de Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md)
+ [Flujo de datos de eventos de aplicación desde Amazon Pinpoint](event-streams-data-app.md)
+ [Flujo de datos de eventos de campaña desde Amazon Pinpoint](event-streams-data-campaign.md)
+ [Datos de eventos de recorrido de Amazon Pinpoint](event-streams-data-journey.md)
+ [Flujo de datos de eventos de correo electrónico desde Amazon Pinpoint](event-streams-data-email.md)
+ [Flujo de datos de eventos de SMS desde Amazon Pinpoint](event-streams-data-sms.md)
+ [Eliminar un flujo de eventos de Amazon Pinpoint](event-streams-disable.md)
# Configurar Amazon Pinpoint para transmitir datos de eventos de aplicación a través de Amazon Kinesis o Amazon Data Firehose
Puede configurar Amazon Pinpoint para enviar datos de eventos a un flujo de Amazon Kinesis o un flujo de entrega de Amazon Data Firehose. Amazon Pinpoint puede enviar datos de eventos para campañas, recorridos y mensajes transaccionales de correo electrónico y SMS.
En esta sección se incluye información sobre la configuración del streaming de eventos mediante programación. También puede utilizar la consola de Amazon Pinpoint para configurar la transmisión de eventos. Para obtener información acerca de la configuración de la transmisión de eventos mediante la consola de Amazon Pinpoint, consulte [Configuración de la transmisión de eventos](https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-event-streams.html) en la *Guía del usuario de Amazon Pinpoint*.
## Requisitos previos
Los ejemplos de esta sección requieren los datos siguientes:
+ El ID de aplicación de una aplicación que está integrada con Amazon Pinpoint y eventos de notificación. Para obtener información acerca de cómo efectuar la integración, consulte [Integrar Amazon Pinpoint con la aplicación](integrate.md).
+ El nombre del recurso de Amazon (ARN) de una transmisión de Kinesis o Firehose de su cuenta. AWS Para obtener información acerca de la creación de estos recursos, consulte [Creating and Managing Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) en la *Guía para desarrolladores de Amazon Kinesis Data Streams* o [Creating an Amazon Data Firehose delivery stream](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) en la *Guía para desarrolladores de Amazon Data Firehose*.
+ El ARN de un rol AWS Identity and Access Management (IAM) que autoriza a Amazon Pinpoint a enviar datos a la transmisión. Para obtener información acerca de la creación de un rol, consulte [Rol de IAM para la transmisión de eventos a Kinesis](permissions-streams.md).
## AWS CLI
En el siguiente AWS CLI ejemplo, se utiliza el comando. [put-event-stream](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/put-event-stream.html) Este comando configura Amazon Pinpoint para enviar eventos a una secuencia de Kinesis:
```
aws pinpoint put-event-stream \
--application-id projectId \
--write-event-stream DestinationStreamArn=streamArn,RoleArn=roleArn
```
## AWS SDK para Java
El siguiente ejemplo de Java configura Amazon Pinpoint para enviar eventos a una secuencia de Kinesis:
```
public PutEventStreamResult createEventStream(AmazonPinpoint pinClient,
String appId, String streamArn, String roleArn) {
WriteEventStream stream = new WriteEventStream()
.withDestinationStreamArn(streamArn)
.withRoleArn(roleArn);
PutEventStreamRequest request = new PutEventStreamRequest()
.withApplicationId(appId)
.withWriteEventStream(stream);
return pinClient.putEventStream(request);
}
```
En este ejemplo, se crea un `WriteEventStream` objeto que almacena la transmisión ARNs de Kinesis y la función de IAM. El objeto `WriteEventStream` se transfiere a un objeto `PutEventStreamRequest` para configurar Amazon Pinpoint de forma que transmita los eventos de una aplicación específica. El objeto `PutEventStreamRequest` se transfiere al método `putEventStream` del cliente de Amazon Pinpoint.
Puede asignar una secuencia de Kinesis a varias aplicaciones. Si lo hace, Amazon Pinpoint envía datos de los eventos codificados en base64 desde cada aplicación a la secuencia, lo que le permite analizar los datos como una colección. El siguiente método de ejemplo acepta una lista de aplicaciones (aplicaciones) IDs y utiliza el método del ejemplo anterior para asignar una transmisión a cada aplicación: `createEventStream`
```
public List createEventStreamFromAppList(
AmazonPinpoint pinClient, List appIDs,
String streamArn, String roleArn) {
return appIDs.stream()
.map(appId -> createEventStream(pinClient, appId, streamArn,
roleArn))
.collect(Collectors.toList());
}
```
Aunque es posible asignar una secuencia a varias aplicaciones, no es posible asignar varias secuencias a una aplicación.
# Flujo de datos de eventos de aplicación desde Amazon Pinpoint
Después de integrar la aplicación (app) con Amazon Pinpoint y configurar la transmisión de eventos, Amazon Pinpoint recupera los datos de actividad del usuario, eventos personalizados y entregas de mensajes de la aplicación desde el destino que haya especificado durante la configuración para que pueda verlos. Para obtener información sobre cómo configurar transmisiones de eventos para poder ver los datos de los eventos, consulte [Configurar Amazon Pinpoint para transmitir datos de eventos de aplicación a través de Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md).
## Ejemplo de evento de aplicación
El objeto JSON de un evento de aplicación contiene los datos que se muestran en el siguiente ejemplo.
```
{
"event_type": "_session.stop",
"event_timestamp": 1487973802507,
"arrival_timestamp": 1487973803515,
"event_version": "3.0",
"application": {
"app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
"package_name": "main.page",
"sdk": {
"name": "aws-sdk-mobile-analytics-js",
"version": "0.9.1:2.4.8"
},
"title": "title",
"version_name": "1.0",
"version_code": "1"
},
"client": {
"client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
"cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
},
"device": {
"locale": {
"code": "en_US",
"country": "US",
"language": "en"
},
"make": "generic web browser",
"model": "Unknown",
"platform": {
"name": "android",
"version": "10.10"
}
},
"session": {
"session_id": "f549dea9-1090-945d-c3d1-e4967example",
"start_timestamp": 1487973202531,
"stop_timestamp": 1487973802507
},
"attributes": {},
"metrics": {}
}
```
## Atributos de los eventos de aplicación
En esta sección se definen los atributos que se han incluido en el ejemplo anterior de la secuencia de eventos de la aplicación.
| Atributo | Descripción |
| --- | --- |
| event\$1type | El tipo de evento. Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-app.html) |
| event\$1timestamp | La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| arrival\$1timestamp | La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| event\$1version | La versión del esquema JSON del evento. 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)](#event-streams-data-app-attributes-application) para obtener más información. |
| client | Información sobre el punto de enlace que notificó el evento. Consulte la tabla de la sección [Client (Cliente)](#event-streams-data-app-attributes-client) 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](#event-streams-data-app-attributes-device). |
| session | Información sobre la sesión que generó el evento. Consulte la tabla de la sección [Session (Sesión)](#event-streams-data-app-attributes-session) para obtener más información. |
| attributes | Atributos asociados al evento. Para los eventos notificados por las aplicaciones, este objeto incluye los atributos personalizados que usted defina. |
| metrics | Métricas relacionadas con el evento. Si lo desea, puede configurar las aplicaciones para que envíen métricas personalizadas a Amazon Pinpoint. |
### Aplicación
Incluye información sobre el proyecto de Amazon Pinpoint al que está asociado el evento.
| Atributo | Descripción |
| --- | --- |
| app\$1id | El ID único del proyecto de Amazon Pinpoint que notificó el evento. |
| cognito\$1identity\$1pool\$1id | El ID del grupo de identidades de Amazon Cognito al que está asociado el punto de conexión. |
| package\$1name | El nombre del paquete de la aplicación, como `com.example.my_app`. |
| sdk | Información sobre el SDK que se utilizó para notificar el evento. Consulte la tabla de la sección [SDK](#event-streams-data-app-attributes-application-sdk) para obtener más información. |
| title | El nombre de la aplicación. |
| version\$1name | El nombre de la versión de la aplicación, como, por ejemplo, `V2.5`. |
| version\$1code | El número de versión de la aplicación, como, por ejemplo, `3`. |
#### SDK
Incluye información sobre el SDK que se utilizó para notificar el evento.
| Atributo | Descripción |
| --- | --- |
| name | El nombre del SDK que se utilizó para notificar el evento. |
| version | La versión del SDK. |
### Cliente
Incluye información sobre el punto de enlace que generó el evento.
| Atributo | Descripción |
| --- | --- |
| client\$1id | ID del punto de enlace. |
| cognito\$1id | El token del ID de Amazon Cognito asociado al punto de conexión. |
### Dispositivo
Incluye información sobre el dispositivo del punto de enlace que generó el evento.
| Atributo | Descripción |
| --- | --- |
| locale | Información sobre la configuración de idioma y región del dispositivo del punto de enlace. Consulte la tabla de la sección [Locale (Local)](#event-streams-data-app-attributes-device-locale) para obtener más información. |
| make | El fabricante del dispositivo del punto de enlace. |
| model | El identificador del modelo del dispositivo del punto de enlace. |
| platform | Información sobre el sistema operativo en el dispositivo del punto de enlace. Consulte la tabla de la sección [Platform (Plataforma)](#event-streams-data-app-attributes-device-platform) para obtener más información. |
#### Locale
Incluye información sobre la configuración de idioma y región del dispositivo del punto de enlace.
| Atributo | Descripción |
| --- | --- |
| code | El identificador de configuración regional asociado al dispositivo. |
| country | El país o la región que está asociado a la configuración regional del dispositivo. |
| language | El idioma asociado a la configuración regional del dispositivo. |
#### Plataforma
Incluye información sobre el sistema operativo en el dispositivo del punto de enlace.
| Atributo | Descripción |
| --- | --- |
| name | El nombre del sistema operativo del dispositivo. |
| version | La versión del sistema operativo del dispositivo. |
### Sesión
Incluye información sobre la sesión que generó el evento.
| Atributo | Descripción |
| --- | --- |
| session\$1id | ID único que identifica la sesión. |
| start\$1timestamp | La fecha y la hora en que comenzó la sesión, que se muestra en formato de tiempo Unix en milisegundos. |
| stop\$1timestamp | La fecha y la hora en que finalizó la sesión, que se muestra en formato de tiempo Unix en milisegundos. |
# Flujo de datos de eventos de campaña desde Amazon Pinpoint
Si utiliza Amazon Pinpoint para enviar campañas a través de un canal, Amazon Pinpoint puede transmitir datos de eventos sobre esas campañas. Tras configurar la transmisión de eventos, Amazon Pinpoint recupera los datos de los eventos de la aplicación para los mensajes de correo electrónico o SMS que usted envíe desde una campaña 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](event-streams-data-email.md) y [Flujo de datos de eventos de SMS desde Amazon Pinpoint](event-streams-data-sms.md). 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](event-streams-setup.md).
## Ejemplo de evento de campaña
El objeto JSON para un evento de campaña contiene los datos que se muestran en el siguiente ejemplo.
```
{
"event_type": "_campaign.send",
"event_timestamp": 1562109497426,
"arrival_timestamp": 1562109497494,
"event_version": "3.1",
"application": {
"app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"sdk": {}
},
"client": {
"client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
},
"device": {
"platform": {}
},
"session": {},
"attributes": {
"treatment_id": "0",
"campaign_activity_id": "5473285727f04865bc673e527example",
"delivery_type": "GCM",
"campaign_id": "4f8d6097c2e8400fa3081d875example",
"campaign_send_status": "SUCCESS"
},
"client_context": {
"custom": {
"endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
}
},
"awsAccountId": "123456789012"
}
```
## Atributos de los eventos de campaña
En esta sección se definen los atributos que se incluyen en la secuencia de eventos de la campaña.
| Atributo | Description (Descripción) |
| --- | --- |
| event\$1type | El tipo de evento. Los valores posibles son los que se indican a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-campaign.html) |
| event\$1timestamp | La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| arrival\$1timestamp | La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| event\$1version | La versión del esquema JSON del evento. 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)](#event-streams-data-campaign-attributes-application) para obtener más información. |
| client | Información sobre el punto de enlace al que está asociado el evento. Consulte la tabla de la sección [Client (Cliente)](#event-streams-data-campaign-attributes-client) para obtener más información. |
| device | Información sobre el dispositivo que notificó el evento. Para los mensajes de campaña y de transacciones, este objeto está vacío. |
| session | Información sobre la sesión que generó el evento. Para las campañas, este objeto está vacío. |
| attributes | Atributos asociados al evento. 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 una campaña, este objeto contiene atributos asociados a la campaña. Para los eventos que se generan al enviar mensajes de transacciones, este objeto contiene información relacionada con el propio mensaje. Consulte la tabla de la sección [Attributes (Atributos)](#event-streams-data-campaign-attributes-attrs) para obtener más información. |
| client\$1context | Contiene un objeto custom, que contiene una propiedad endpoint. La propiedad endpoint contiene el contenido del registro del punto de enlace al que se envió la campaña. |
| 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 | Description (Descripción) |
| --- | --- |
| app\$1id | El ID único del proyecto de Amazon Pinpoint que notificó el evento. |
| sdk | El SDK que se utilizó para notificar el evento. |
### Atributos
Incluye información sobre la campaña que produjo el evento.
| Atributo | Description (Descripción) |
| --- | --- |
| treatment\$1id | Si el mensaje se envió mediante una campaña de A/B prueba, este valor representa el número de tratamiento del mensaje. Para las campañas estándar, este valor es `0`. |
| campaign\$1activity\$1id | El ID único que Amazon Pinpoint genera cuando se produce el evento. |
| delivery\$1type | El método de entrega de la campaña. No confunda este atributo con el campo `ChannelType` especificado en la propiedad `endpoint` de `client_context`. El campo `ChannelType` se basa normalmente en el punto de conexión al que se envía el mensaje. En el caso de los canales que admiten solo un tipo de punto de conexión, los campos `delivery_type` y `ChannelType` tienen el mismo valor. Por ejemplo, para el canal de correo electrónico, los campos `delivery_type` y `ChannelType` tienen el mismo valor de CORREO ELECTRÓNICO. Sin embargo, esta condición no siempre se cumple en los canales que admiten distintos tipos de puntos de conexión, como los canales personalizados. Puede usar un canal personalizado para distintos puntos de conexión, como EMAIL, SMS, CUSTOM, etc. En este caso, `delivery_type` identifica un evento de entrega personalizado, CUSTOM, y `ChannelType` especifica el tipo de punto de conexión al que se envió la campaña, como EMAIL, SMS, CUSTOM, etc. Para obtener más información sobre la creación de canales personalizados, consulte [Crear un canal personalizado en Amazon Pinpoint mediante un webhook o una función de Lambda](channels-custom.md). Los valores posibles son los que se indican a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-campaign.html) |
| campaign\$1id | El ID único de la campaña desde la que se envió el mensaje. |
| campaign\$1send\$1status | Indica el estado de la campaña para el punto de enlace de destino. Los valores posibles son:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-campaign.html) |
### Cliente
Incluye información sobre el punto de enlace al que se dirigía la campaña.
| Atributo | Description (Descripción) |
| --- | --- |
| client\$1id | El ID del punto de enlace al que se envió la campaña. |
# Datos de eventos de recorrido de Amazon Pinpoint
Cuando publica un recorrido, Amazon Pinpoint puede transmitir datos de eventos de los mensajes de correo electrónico, SMS, 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](event-streams-data-email.md) y [Flujo de datos de eventos de SMS desde Amazon Pinpoint](event-streams-data-sms.md). 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](event-streams-setup.md).
## 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\$1type | 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\$1timestamp | La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| arrival\$1timestamp | La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| event\$1version | La versión del esquema JSON del evento. 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)](#event-streams-data-journey-attributes-application) 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)](#event-streams-data-journey-attributes-client) 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)](#event-streams-data-journey-attributes-attrs) para obtener más información. |
| client\$1context | 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\$1id | 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\$1id | ID del punto de enlace. |
### Atributos
Incluye información sobre el recorrido que generó el evento.
| Atributo | Descripción |
| --- | --- |
| journey\$1run\$1id | 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\$1send\$1status | Indica el estado de entrega del mensaje que está asociado al evento. Los valores posibles son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-journey.html) |
| journey\$1id | El identificador único del recorrido que generó el evento. |
| journey\$1activity\$1id | El identificador único de la actividad de recorrido que generó el evento. |
| journey\$1activity\$1type | El tipo de actividad de recorrido del evento. Esto puede ser **EMAIL**, **SMS**, **PUSH**, **CONTACT\$1CENTER** o **CUSTOM**. **VOICE** no es un tipo de actividad de recorrido compatible. El campo `journey_activity_type` no está presente cuando `journey_send_status` se establece en **QUIET\$1TIME\$1WAIT\$1FINISHED**. |
| `journey_send_status_message` | La descripción del estado del evento de envío. |
| journey\$1send\$1status\$1code | El código de estado HTTP de la solicitud. |
# Flujo de datos de eventos de correo electrónico desde Amazon Pinpoint
Si utiliza Amazon Pinpoint para enviar correos electrónicos, Amazon Pinpoint puede transmitir datos de eventos sobre esos correos electrónicos. Tras configurar la transmisión de eventos, Amazon Pinpoint recupera los datos de los eventos desde el destino que haya especificado durante la configuración para que pueda verlos. 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](event-streams-setup.md). 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 en [Atributos de los eventos de correo electrónico](#event-streams-data-email-attributes).
En función de la API y de la configuración que utilice para enviar mensajes de correo electrónico, es posible que vea tipos de eventos adicionales o datos diferentes. Por ejemplo, si envía mensajes mediante conjuntos de configuración que publican datos de eventos en Amazon Kinesis, como los proporcionados por Amazon Simple Email Service (Amazon SES), los datos también pueden incluir eventos para errores de representación de plantillas. Para obtener información acerca de esos datos, consulte [Monitoreo mediante la publicación de eventos de Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) en la *Guía para desarrolladores de Amazon Simple Email Service*. Antes de poder ver sus eventos, debe configurar la transmisión de eventos; consulte [Configurar Amazon Pinpoint para transmitir datos de eventos de aplicación a través de Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md). Al configurar la transmisión de eventos, especifique un destino en el que se guardarán los datos del evento; después, podrá usar el destino para recuperar los datos del evento para su visualización.
## Ejemplos de eventos de correo electrónico
**Envío de correo electrónico**
El objeto JSON referente a 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 objeto JSON referente a 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 objeto JSON referente a un evento de *clic en 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 objeto JSON referente a 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 han incluido en el ejemplo anterior de los datos de la secuencia de eventos que Amazon Pinpoint genera cuando se envían mensajes de correo electrónico.
| Atributo | Descripción |
| --- | --- |
| event\$1type | El tipo de evento. Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-email.html) |
| event\$1timestamp | 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\$1timestamp | La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| event\$1version | La versión del esquema JSON del evento. 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\$1context | Para eventos de correo electrónico, este objeto contiene un objeto custom, que contiene un atributo legacy\$1identifier. El valor del atributo legacy\$1identifier 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 cuenta de AWS de 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\$1id | El ID único del proyecto de Amazon Pinpoint que notificó el evento. |
| sdk | El SDK que se utilizó para notificar el evento. Si envía un mensaje de correo electrónico de transacciones llamando directamente a la API de Amazon Pinpoint o con la consola de Amazon Pinpoint, este objeto estará 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 | Para los eventos `_email.click`, el valor de este atributo es la 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\$1id | 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\$1activity\$1id | El ID único que Amazon Pinpoint genera cuando se produce el evento. |
| campaign\$1id | 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\$1run\$1id | 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 | Para los eventos `_email.click`, el valor de este atributo es la 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\$1id | El identificador único del recorrido que envió el mensaje. |
| journey\$1activity\$1id | 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\$1id | El ID del cliente. El valor es el ID de punto de conexión para las campañas y los recorridos, para el envío transaccional, es un UUID. |
### Facetas
Incluye información sobre el mensaje y el tipo de evento.
| Atributo | Descripción |
| --- | --- |
| email\$1channel | 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\$1id | El ID único del mensaje. Amazon Pinpoint genera automáticamente este ID cuando acepta el mensaje. |
| message\$1send\$1timestamp | La fecha y la hora a la que se envió el mensaje, en el formato especificado en [RFC 822](https://datatracker.ietf.org/doc/html/rfc822). |
| from\$1address | 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\$1truncated | 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-email.html) |
| common\$1headers | 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. |
# Flujo de datos de eventos de SMS desde Amazon Pinpoint
Si el canal de SMS está habilitado para un proyecto, Amazon Pinpoint puede transmitir datos de eventos acerca de entregas de mensajes SMS para el proyecto. Tras configurar la transmisión de eventos, Amazon Pinpoint recupera los datos de los eventos desde el destino que haya especificado durante la configuración para que pueda verlos. 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](event-streams-setup.md).
**nota**
Los eventos de SMS generados por los operadores pueden tardar hasta 72 horas en recibirse y no se deben utilizar para determinar si hay un retraso en la entrega de los mensajes salientes. Transcurridas 72 horas, si Amazon Pinpoint no ha recibido un evento final de un operador, el servicio devuelve automáticamente el record\$1status UNKNOWN, ya que Amazon Pinpoint no sabe qué ha ocurrido con ese mensaje.
## Ejemplo de evento de SMS
El objeto JSON relacionado con un evento de SMS contiene los datos que se muestran en el siguiente ejemplo.
```
{
"event_type": "_SMS.SUCCESS",
"event_timestamp": 1553104954322,
"arrival_timestamp": 1553104954064,
"event_version": "3.1",
"application": {
"app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"sdk": {}
},
"client": {
"client_id": "123456789012"
},
"device": {
"platform": {}
},
"session": {},
"attributes": {
"sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
"campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
"origination_phone_number": "+12065550142",
"destination_phone_number": "+14255550199",
"record_status": "DELIVERED",
"iso_country_code": "US",
"treatment_id": "0",
"number_of_message_parts": "1",
"message_id": "1111-2222-3333",
"message_type": "Transactional",
"campaign_id": "52dc44b35c4742c98c5935269example"
"customer_context": "{\"userId\":\"user-id-4\"}"
},
"metrics": {
"price_in_millicents_usd": 645.0
},
"awsAccountId": "123456789012"
}
```
## Atributos de los eventos de SMS
En esta sección se definen los atributos que se han incluido en el ejemplo anterior de los datos de la secuencia de eventos que Amazon Pinpoint genera cuando se envían mensajes de SMS.
**Evento**
| Atributo | Descripción |
| --- | --- |
| event\$1type | El tipo de evento. Los valores posibles son los siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-sms.html) |
| event\$1timestamp | La hora a la que se notificó el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| arrival\$1timestamp | La hora a la que Amazon Pinpoint recibió el evento, que se muestra en formato de tiempo Unix en milisegundos. |
| event\$1version | La versión del esquema JSON del evento. 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)](#event-streams-data-sms-attributes-application) 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)](#event-streams-data-sms-attributes-client) 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](#event-streams-data-sms-attributes-device). Para los eventos de SMS, este objeto está vacío. |
| session | Para los eventos de SMS, este objeto está vacío. |
| attributes | Atributos asociados al evento. 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 una campaña, este objeto contiene atributos asociados a la campaña. Para los eventos que se generan al enviar mensajes de transacciones, este objeto contiene información relacionada con el propio mensaje. Consulte la tabla de la sección [Attributes (Atributos)](#event-streams-data-sms-attributes-attrs) para obtener más información. |
| metrics | Métricas adicionales asociadas al evento. Para obtener más información, consulte la tabla [Métricas](#event-streams-data-sms-attributes-metrics). |
| awsAccountId | El ID de la cuenta de AWS de que se utilizó para enviar el mensaje. |
### Aplicación
Incluye información sobre el proyecto de Amazon Pinpoint al que está asociado el evento y, si procede, el SDK que se utilizó para informar del evento.
| Atributo | Descripción |
| --- | --- |
| app\$1id | El ID único del proyecto de Amazon Pinpoint que notificó el evento. |
| sdk | El SDK que se utilizó para notificar el evento. Si envía un mensaje SMS transaccional llamando directamente a la API de Amazon Pinpoint o con la consola de Amazon Pinpoint, este objeto estará vacío. |
### Atributos
Incluye información sobre los atributos asociados al evento.
| Atributo | Descripción |
| --- | --- |
| sender\$1request\$1id | Un ID único asociado a la solicitud para enviar el mensaje SMS. |
| campaign\$1activity\$1id | El ID único de la actividad dentro de la campaña. |
| origination\$1phone\$1number | El número de teléfono desde el que se envió el mensaje. |
| destination\$1phone\$1number | El número de teléfono al que se ha intentado enviar el mensaje. |
| record\$1status | Información adicional sobre el estado del mensaje. Los valores posibles son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/event-streams-data-sms.html) |
| iso\$1country\$1code | El país que está asociado al número de teléfono del destinatario, mostrado en formato ISO 3166-1 alpha-2. |
| treatment\$1id | El ID del tratamiento del mensaje, si el mensaje se envió en una campaña A/B. |
| treatment\$1id | Si el mensaje se envió mediante una campaña de prueba A/B, este valor representa el número de tratamiento del mensaje. Para los mensajes SMS de transacciones, este valor es 0. |
| number\$1of\$1message\$1parts | El número de partes del mensaje que Amazon Pinpoint ha creado para enviar el mensaje. Por lo general, los mensajes SMS solo pueden contener 160 caracteres GSM-7 o 67 caracteres no GSM, aunque estos límites pueden variar según el país . Si envía un mensaje que supere estos límites, Amazon Pinpoint lo divide automáticamente en partes más pequeñas. La facturación se realiza en función del número de partes de mensajes que envíe. |
| message\$1id | El ID único que Amazon Pinpoint genera cuando acepta el mensaje. |
| message\$1type | Tipo de mensaje. Los valores posibles son **Promotional (Promocionales)** y **Transactional (Transaccionales)**. Este valor se especifica al crear una campaña o al enviar mensajes de transacciones mediante la operación [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) de la API de Amazon Pinpoint. |
| campaign\$1id | El ID único de la campaña DE Amazon Pinpoint que envió el mensaje. |
| customer\$1context | Una cadena JSON del contenido de la asignación `Context` enviada en una operación [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) de Amazon Pinpoint. |
### Cliente
Incluye información sobre el cliente de la aplicación instalada en el dispositivo que notificó el evento.
| Atributo | Descripción |
| --- | --- |
| client\$1id | Para los eventos generados por aplicaciones, este valor es el ID único del cliente de la aplicación instalada en el dispositivo. AWS Mobile SDK for iOS y AWS Mobile SDK para Android generan automáticamente este ID. Para los eventos que se generan al enviar campañas y mensajes de transacciones, este valor es igual al ID del punto de enlace al que envía el mensaje. |
| cognito\$1id | El ID exclusivo asignado al cliente de la aplicación en el grupo de identidades de Amazon Cognito utilizado por la aplicación. |
### Dispositivo
Incluye información sobre el dispositivo que notificó el evento.
| Atributo | Descripción |
| --- | --- |
| locale | La configuración regional del dispositivo. |
| make | La marca del dispositivo, como, por ejemplo, Apple o Samsung. |
| model | El modelo del dispositivo, como, por ejemplo, iPhone. |
| platform | La plataforma del dispositivo, como, por ejemplo, ios o android. |
### Métricas
Incluye información sobre las métricas asociadas al evento.
| Atributo | Descripción |
| --- | --- |
| price\$1in\$1millicents\$1usd | La cantidad que se cobra por enviar el mensaje. Este precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es `645`, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD). Esta propiedad no aparece en los mensajes con el `event_type` **\$1SMS.BUFFERED**. |
# Eliminar un flujo de eventos de Amazon Pinpoint
Si se asigna una secuencia de Kinesis a una aplicación, puede desactivar la transmisión de eventos para esa aplicación. Amazon Pinpoint deja de transmitir los eventos a Kinesis, pero puede ver los análisis de los eventos mediante la consola de Amazon Pinpoint.
## AWS CLI
Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-event-stream.html](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-event-stream.html):
```
aws pinpoint delete-event-stream --application-id application-id
```
## AWS SDK para Java
Utilice el método [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html) del cliente de Amazon Pinpoint:
```
pinClient.deleteEventStream(new DeleteEventStreamRequest().withApplicationId(appId));
```