Flusso di dati sugli eventi delle app da Amazon Pinpoint

Dopo aver integrato la tua applicazione (app) con Amazon Pinpoint e configurato lo streaming degli eventi, Amazon Pinpoint recupera l'attività utente dell'app, gli eventi personalizzati e i dati di recapito dei messaggi dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni su come configurare lo streaming degli eventi in modo da poter visualizzare i dati degli eventi, consulta. Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose

Esempio di evento dell'app

L'JSONoggetto per un evento dell'app contiene i dati mostrati nell'esempio seguente.

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

Attributi di eventi dell’app

Questa sezione definisce gli attributi inclusi nell'esempio precedente del flusso di eventi dell'app.

Attributo	Descrizione
event_type	Tipo di evento. I valori possibili sono: _session.start: l'endpoint ha iniziato una nuova sessione. _session.stop: l'endpoint ha terminato una sessione. _userauth.sign_in: l'endpoint ha stabilito la connessione all'app. _userauth.sign_up: un nuovo endpoint ha completato la procedura di registrazione nell'app. _userauth.auth_fail: l'endpoint ha tentato di accedere all'app, ma non è stato in grado di completare il processo. _monetization.purchase: l'endpoint ha effettuato un acquisto nell'app. _session.pause: la sessione dell'endpoint è stata sospesa. Le sessioni in pausa possono essere riavviate in modo da poter continuare a raccogliere i parametri senza avviare una sessione completamente nuova. _session.resume: la sessione dell'endpoint è stata ripresa.
event_timestamp	L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi.
arrival_timestamp	L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi.
event_version	La versione dello JSON schema degli eventi. Suggerimento Seleziona questa versione nell'applicazione di elaborazione eventi in modo da sapere quando aggiornare l'applicazione in risposta a un aggiornamento dello schema.
application	Informazioni sul progetto Amazon Pinpoint associato all'evento. Per ulteriori informazioni, consulta la tabella Applicazione.
client	Informazioni sull'endpoint che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella Client.
device	Informazioni sul dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella Dispositivo.
session	Informazioni sulla sessione che ha generato l'evento. Per ulteriori informazioni, consulta la tabella Sessione.
attributes	Attributi associati all'evento. Per gli eventi segnalati dalle app, questo oggetto include gli attributi personalizzati definiti dall'utente.
metrics	Parametri correlati all'evento. Facoltativamente, puoi configurare le app per l'invio di metriche personalizzate ad Amazon Pinpoint.

Applicazione

Include informazioni sul progetto Amazon Pinpoint a cui è associato l'evento.

Attributo	Descrizione
app_id	ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.
cognito_identity_pool_id	ID del pool di identità Amazon Cognito a cui è associato l'endpoint.
package_name	Il nome del pacchetto dell'app, ad esempio com.example.my_app.
sdk	Informazioni sul SDK that utilizzato per segnalare l'evento. Per ulteriori informazioni, consulta la SDKtabella.
title	Il nome dell'app.
version_name	Il nome della versione dell'app, ad esempio V2.5.
version_code	Il numero di versione dell'app, ad esempio 3.

SDK

Include informazioni sull'SDKoggetto utilizzato per segnalare l'evento.

Attributo	Descrizione
name	Il nome del SDK che è stato usato per segnalare l'evento.
version	La versione diSDK.

Client

Include informazioni sull'endpoint che ha generato l'evento.

Attributo	Descrizione
client_id	ID dell'endpoint.
cognito_id	Token ID Amazon Cognito associato all'endpoint.

Dispositivo

Include informazioni sul dispositivo dell'endpoint che ha generato l'evento.

Attributo	Descrizione
locale	Informazioni sulle impostazioni di lingua e regione per il dispositivo dell'endpoint. Per ulteriori informazioni, consulta la tabella Locale.
make	Il produttore del dispositivo dell'endpoint.
model	L'identificatore del modello del dispositivo dell'endpoint.
platform	Informazioni sul sistema operativo del dispositivo dell'endpoint. Per ulteriori informazioni, consulta la tabella Piattaforma.

Locale

Include informazioni sulle impostazioni di lingua e regione per il dispositivo dell'endpoint.

Attributo	Descrizione
code	L'identificatore locale associato al dispositivo.
country	Il paese o la regione associata alle impostazioni locali del dispositivo.
language	La lingua associata alle impostazioni locali del dispositivo.

Piattaforma

Include informazioni sul sistema operativo del dispositivo dell'endpoint.

Attributo	Descrizione
name	Il nome del sistema operativo sul dispositivo.
version	La versione del sistema operativo sul dispositivo.

Sessione

Include informazioni sulla sessione che ha generato l'evento.

Attributo	Descrizione
session_id	Un ID univoco che identifica la sessione.
start_timestamp	La data e l'ora in cui è iniziata la sessione, espresse in formato orario Unix in millisecondi.
stop_timestamp	La data e l'ora in cui è terminata la sessione, espresse in formato orario Unix in millisecondi.