Eventos de aplicaciones

Después de integrar la aplicación (app) con Amazon Pinpoint, Amazon Pinpoint puede transmitir datos de eventos sobre la actividad del usuario, los eventos personalizados y las entregas de mensajes para la aplicación.

Ejemplo

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 incluyen en la secuencia de eventos de la aplicación.

Atributo	Descripción
event_type	El tipo de evento. Los valores posibles son los siguientes: _session.start: el punto de conexión inició una nueva sesión. _session.stop: el punto de conexión terminó una sesión. _userauth.sign_in: el punto de conexión se registró en la aplicación. _userauth.sign_up: un nuevo punto de conexión completó el proceso de registro en la aplicación. _userauth.auth_fail: el punto de conexión intentó iniciar sesión en la aplicación, pero no pudo completar el proceso. _monetization.purchase: el punto de conexión realizó una compra en la aplicación. _session.pause: el punto de conexión detuvo una sesión. Las sesiones en pausa se pueden reanudar para poder seguir recopilando métricas sin iniciar una sesión totalmente nueva. _session.resume: el punto de conexión reanudó una sesión.
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 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.
session	Información sobre la sesión que generó el evento. Consulte la tabla de la sección Session (Sesión) 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_id	El ID único del proyecto de Amazon Pinpoint que notificó el evento.
cognito_identity_pool_id	El ID del grupo de identidades de Amazon Cognito al que está asociado el punto de conexión.
package_name	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 para obtener más información.
title	El nombre de la aplicación.
version_name	El nombre de la versión de la aplicación, como, por ejemplo, V2.5.
version_code	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_id	ID del punto de enlace.
cognito_id	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) 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) 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.

Session (Sesión)

Incluye información sobre la sesión que generó el evento.

Atributo	Descripción
session_id	ID único que identifica la sesión.
start_timestamp	La fecha y la hora en que comenzó la sesión, que se muestra en formato de tiempo Unix en milisegundos.
stop_timestamp	La fecha y la hora en que finalizó la sesión, que se muestra en formato de tiempo Unix en milisegundos.