Événements d'application

Une fois que vous avez intégré votre application (application) à Amazon Pinpoint, Amazon Pinpoint peut diffuser des données d'événements concernant l'activité des utilisateurs, les événements personnalisés et les envois de messages pour l'application. Avant de pouvoir visionner vos événements, vous devez configurer le streaming des événements, voirConfiguration de la diffusion en continu des événements. Lorsque vous configurez le streaming d'événements, vous spécifiez une destination pour l'enregistrement des données de votre événement, puis vous pouvez utiliser cette destination pour récupérer les données de vos événements afin de les consulter.

Exemple

L'objet JSON d'un événement d'application contient les données illustrées dans l'exemple suivant.

{
  "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": {}
}

Attributs d'événement d'application

Cette section définit les attributs qui sont inclus dans le flux d'événements de l'application.

Attribut	Description
event_type	Type d'événement. Les valeurs possibles sont : _session.start : le point de terminaison a commencé une nouvelle session. _session.stop : le point de terminaison a mis fin à une session. _userauth.sign_in : point de terminaison connecté à votre application. _userauth.sign_up : le nouveau point de terminaison a terminé le processus d'inscription dans votre application. _userauth.auth_fail : le point de terminaison a tenté de se connecter à votre application, mais n'a pas pu terminer le processus. _monetization.purchase : le point de terminaison a effectué un achat dans votre application. _session.pause : la session du point de terminaison a été suspendue. Les sessions suspendues peuvent être reprises afin que vous puissiez continuer à collecter les métriques sans démarrer une toute nouvelle session. _session.resume : la session du point de terminaison a repris.
event_timestamp	Heure à laquelle l'événement a été signalé, affichée sous la forme Heure Unix en millisecondes.
arrival_timestamp	Heure à laquelle l'événement a été reçu par Amazon Pinpoint, affichée sous la forme Heure Unix en millisecondes.
event_version	Version du schéma JSON de l'événement. Astuce Vérifiez la version dans votre application de traitement des événements afin de savoir à quel moment mettre à jour l'application suite à une mise à jour du schéma.
application	Informations sur le projet Amazon Pinpoint associé à l'événement. Pour plus d'informations, consultez le tableau Application.
client	Informations sur le point de terminaison qui a signalé l'événement. Pour plus d'informations, consultez le tableau Client.
device	Informations sur l'appareil qui a signalé l'événement. Pour plus d'informations, consultez le tableau Appareil.
session	Informations sur la session qui a généré l'événement. Pour plus d'informations, consultez le tableau Session.
attributes	Attributs associés à l'événement. Pour les événements rapportés par vos applications, cet objet inclut les attributs personnalisés que vous définissez.
metrics	Métriques liées à l'événement. Si vous le souhaitez, vous pouvez configurer vos applications pour envoyer des métriques personnalisées à Amazon Pinpoint.

Application

Inclut les informations sur le projet Amazon Pinpoint auquel l'événement est associé.

Attribut	Description
app_id	ID unique du projet Amazon Pinpoint qui a signalé l'événement.
cognito_identity_pool_id	ID de la réserve d'identités Amazon Cognito auquel le point de terminaison est associé.
package_name	Nom du package d'application, par exemple com.example.my_app.
sdk	Informations sur le kit SDK qui a été utilisé pour signaler l'événement. Pour plus d'informations, consultez le tableau kit SDK.
title	Nom de l'application.
version_name	Nom de la version de l'application (par exemple, V2.5).
version_code	Numéro de version de l'application, tel que 3.

SDK

Informations sur le kit SDK qui a été utilisé pour signaler l'événement.

Attribut	Description
name	Nom du kit SDK qui a été utilisé pour signaler l'événement.
version	Version du kit SDK.

Client

Inclut des informations sur le point de terminaison qui a généré l'événement.

Attribut	Description
client_id	ID du point de terminaison.
cognito_id	Jeton d'ID Amazon Cognito associé au point de terminaison.

Appareil

Inclut des informations sur l'appareil du point de terminaison qui a généré l'événement.

Attribut	Description
locale	Informations sur les paramètres de langue et de région de l'appareil du point de terminaison. Pour plus d'informations, consultez le tableau Locale.
make	Fabricant de l'appareil du point de terminaison.
model	Identifiant du modèle de l'appareil du point de terminaison.
platform	Informations sur le système d'exploitation sur le périphérique du point de terminaison. Pour plus d'informations, consultez le tableau Plateforme.

Paramètre régional

Informations sur les paramètres de langue et de région de l'appareil du point de terminaison.

Attribut	Description
code	Identifiant local associé à l'appareil.
country	Pays ou région associé aux paramètres régionaux de l'appareil.
language	Langue associée aux paramètres régionaux de l'appareil.

Plateforme

Informations sur le système d'exploitation de l'appareil du point de terminaison.

Attribut	Description
name	Nom du système d'exploitation sur l'appareil.
version	Version du système d'exploitation de l'appareil.

Session

Inclut des informations sur la session qui a généré l'événement.

Attribut	Description
session_id	ID unique qui identifie la session.
start_timestamp	Date et heure de début de la session, affichées sous la forme Heure Unix en millisecondes.
stop_timestamp	Date et heure auxquelles la session s'est terminée, affichées sous la forme Heure Unix en millisecondes.