

**Avviso di fine del supporto:** il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta [Fine del supporto di Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: per quanto** APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da End User Messaging. AWS 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Trasmetti in streaming i dati degli eventi delle app tramite Kinesis e Firehose utilizzando Amazon Pinpoint
<a name="event-streams"></a>

In Amazon Pinpoint, un *evento* è un'azione che si verifica quando un utente interagisce con una delle tue applicazioni, quando invii un messaggio da una campagna o un percorso oppure quando invii un messaggio transazionale SMS o e-mail. Ad esempio, se invii un messaggio e-mail, si verificano diversi eventi:
+ Quando invii il messaggio, si verifica un evento di *invio* .
+ Quando il messaggio raggiunge la casella di posta in arrivo del destinatario, si verifica un evento *recapitato* .
+ Quando il destinatario apre il messaggio, si verifica un evento di *apertura* . 

È possibile configurare Amazon Pinpoint in modo che invii informazioni sugli eventi ad Amazon Kinesis. La piattaforma Kinesis offre servizi che puoi utilizzare per raccogliere, elaborare e analizzare i dati dei AWS servizi in tempo reale. Amazon Pinpoint può inviare dati sugli eventi a Firehose, che li trasmette ad archivi AWS dati come Amazon S3 o Amazon Redshift. Amazon Pinpoint può anche trasmettere dati al flusso di dati Kinesis, che acquisisce e archivia più flussi di dati per l'elaborazione da parte delle applicazioni di analisi.

Il flusso di eventi Amazon Pinpoint include informazioni sulle interazioni degli utenti con le applicazioni (app) connesse ad Amazon Pinpoint. Include anche informazioni su tutti i messaggi inviati dalle campagne, attraverso qualsiasi canale e dai viaggi. Ciò può includere anche tutti gli eventi personalizzati precedentemente definiti. Infine, include informazioni sulle tutte le e-mail transazionali e su tutti i messaggi SMS inviati.

**Nota**  
Amazon Pinpoint non esegue lo streaming di informazioni sulle notifiche push transazionali o sui messaggi vocali.

In questo capitolo vengono fornite informazioni sulla configurazione di Amazon Pinpoint per lo streaming dei dati degli eventi in Kinesis. Contiene anche esempi di dati di eventi trasmessi in streaming da Amazon Pinpoint.

**Topics**
+ [Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md)
+ [Flusso di dati sugli eventi delle app da Amazon Pinpoint](event-streams-data-app.md)
+ [Flusso di dati sugli eventi della campagna da Amazon Pinpoint](event-streams-data-campaign.md)
+ [Dati sugli eventi di viaggio da Amazon Pinpoint](event-streams-data-journey.md)
+ [Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint](event-streams-data-email.md)
+ [Flusso di dati di eventi SMS da Amazon Pinpoint](event-streams-data-sms.md)
+ [Eliminare un flusso di eventi da Amazon Pinpoint](event-streams-disable.md)

# Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose
<a name="event-streams-setup"></a>

Puoi configurare Amazon Pinpoint per inviare i dati degli eventi a uno stream Amazon Kinesis o a un flusso di distribuzione Amazon Data Firehose. Amazon Pinpoint può inviare dati sugli eventi per campagne, percorsi e messaggi e-mail e SMS transazionali.

Questa sezione include informazioni sulla configurazione dello streaming di eventi a livello di programmazione. Puoi anche utilizzare la console Amazon Pinpoint per configurare lo streaming di eventi. Per informazioni sulla configurazione dello streaming di eventi utilizzando la console Amazon Pinpoint, consulta [Impostazioni del flusso di eventi](https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-event-streams.html) nella *Guida per l'utente di Amazon Pinpoint*.

## Prerequisiti
<a name="event-streams-setup-prerequisites"></a>

Gli esempi in questa sezione richiedono il seguente input:
+ L'ID di un'applicazione integrata con Amazon Pinpoint e che segnala gli eventi. Per informazioni sull'integrazione, consulta [Integra Amazon Pinpoint con la tua applicazione](integrate.md).
+ L'Amazon Resource Name (ARN) di uno stream Kinesis o di un flusso di distribuzione Firehose nel tuo account. AWS *Per informazioni sulla creazione di queste risorse, consulta [Creating and Managing Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) nella *Amazon Kinesis Data Streams Developer* Guide o [Creazione di un flusso di distribuzione Amazon Data Firehose nella Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) Developer Guide.*
+ L'ARN di un ruolo AWS Identity and Access Management (IAM) che autorizza Amazon Pinpoint a inviare dati allo stream. Per informazioni su come creare un ruolo, consulta [Ruolo IAM per lo streaming di eventi su Kinesis](permissions-streams.md).

## AWS CLI
<a name="event-streams-setup-cli"></a>

L' AWS CLI esempio seguente utilizza il comando. [put-event-stream](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/put-event-stream.html) Questo comando configura Amazon Pinpoint per l'invio di eventi a un flusso Kinesis:

```
aws pinpoint put-event-stream \
--application-id projectId \
--write-event-stream DestinationStreamArn=streamArn,RoleArn=roleArn
```

## AWS SDK per Java
<a name="event-streams-setup-java"></a>

L'esempio Java seguente configura Amazon Pinpoint per l'invio di eventi a un flusso 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);
}
```

Questo esempio costruisce un `WriteEventStream` oggetto che memorizza il ARNs flusso Kinesis e il ruolo IAM. L'oggetto `WriteEventStream` viene passato a un oggetto `PutEventStreamRequest` per configurare Amazon Pinpoint per lo streaming degli eventi per un'applicazione specifica. L'oggetto `PutEventStreamRequest` viene passato al metodo `putEventStream` del client Amazon Pinpoint.

Puoi assegnare un flusso Kinesis a più applicazioni. In questo caso, Amazon Pinpoint invia i dati degli eventi con codifica Base64 da ogni applicazione al flusso e ciò consente di analizzare i dati come una raccolta. Il seguente metodo di esempio accetta un elenco di applicazioni (app) IDs e utilizza il metodo di esempio precedente per assegnare uno stream a ciascuna applicazione: `createEventStream`

```
public List<PutEventStreamResult> createEventStreamFromAppList(
        AmazonPinpoint pinClient, List<String> appIDs, 
        String streamArn, String roleArn) {

    return appIDs.stream()
            .map(appId -> createEventStream(pinClient, appId, streamArn, 
                    roleArn))
            .collect(Collectors.toList());
}
```

Sebbene sia possibile assegnare un flusso a più applicazioni, non è possibile assegnare più flussi a una sola applicazione.

# Flusso di dati sugli eventi delle app da Amazon Pinpoint
<a name="event-streams-data-app"></a>

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](event-streams-setup.md)

## Esempio di evento dell'app
<a name="event-streams-data-app-example"></a>

L'oggetto JSON per un evento 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
<a name="event-streams-data-app-attributes"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| event\$1type |  Tipo di evento. I valori possibili sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-app.html)  | 
| event\$1timestamp | L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi. | 
| arrival\$1timestamp | L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi. | 
| event\$1version |  La versione dello schema JSON dell'evento.  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](#event-streams-data-app-attributes-application). | 
| client | Informazioni sull'endpoint che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella [Client](#event-streams-data-app-attributes-client). | 
| device | Informazioni sul dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella [Dispositivo](#event-streams-data-app-attributes-device). | 
| session | Informazioni sulla sessione che ha generato l'evento. Per ulteriori informazioni, consulta la tabella [Sessione](#event-streams-data-app-attributes-session). | 
| 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
<a name="event-streams-data-app-attributes-application"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| app\$1id |  ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.  | 
| cognito\$1identity\$1pool\$1id |  ID del pool di identità Amazon Cognito a cui è associato l'endpoint.  | 
| package\$1name |  Il nome del pacchetto dell'app, ad esempio `com.example.my_app`.  | 
| sdk |  Informazioni sull'SDK utilizzato per segnalare l'evento. Per ulteriori informazioni, consulta la tabella [SDK](#event-streams-data-app-attributes-application-sdk).  | 
| title |  Il nome dell'app.  | 
| version\$1name |  Il nome della versione dell'app, ad esempio `V2.5`.  | 
| version\$1code |  Il numero di versione dell'app, ad esempio `3`.  | 

#### SDK
<a name="event-streams-data-app-attributes-application-sdk"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| name | Il nome dell'SDK utilizzato per segnalare l'evento. | 
| version | La versione dell’SDK. | 

### Client
<a name="event-streams-data-app-attributes-client"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| client\$1id | ID dell'endpoint. | 
| cognito\$1id | Token ID Amazon Cognito associato all'endpoint. | 

### Dispositivo
<a name="event-streams-data-app-attributes-device"></a>

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](#event-streams-data-app-attributes-device-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](#event-streams-data-app-attributes-device-platform).  | 

#### Locale
<a name="event-streams-data-app-attributes-device-locale"></a>

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
<a name="event-streams-data-app-attributes-device-platform"></a>

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
<a name="event-streams-data-app-attributes-session"></a>

Include informazioni sulla sessione che ha generato l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| session\$1id | Un ID univoco che identifica la sessione. | 
| start\$1timestamp | La data e l'ora in cui è iniziata la sessione, espresse in formato orario Unix in millisecondi. | 
| stop\$1timestamp | La data e l'ora in cui è terminata la sessione, espresse in formato orario Unix in millisecondi. | 

# Flusso di dati sugli eventi della campagna da Amazon Pinpoint
<a name="event-streams-data-campaign"></a>

Se utilizzi Amazon Pinpoint per inviare campagne tramite un canale, Amazon Pinpoint può trasmettere in streaming i dati sugli eventi relativi a tali campagne. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati degli eventi dell'app per e-mail o SMS che invii da una campagna dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni dettagliate sui dati trasmessi da Amazon Pinpoint per e-mail e SMS, consulta e. [Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint](event-streams-data-email.md) [Flusso di dati di eventi SMS da Amazon Pinpoint](event-streams-data-sms.md) Per informazioni su come configurare lo streaming di eventi, consulta. [Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md) 

## Esempio di evento della campagna
<a name="event-streams-data-campaign-example"></a>

L'oggetto JSON per un evento della campagna contiene i dati mostrati nell'esempio seguente.

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

## Attributi degli eventi di campagna
<a name="event-streams-data-campaign-attributes"></a>

Questa sezione definisce gli attributi inclusi nel flusso di eventi della campagna.


| Attributo | Description | 
| --- | --- | 
| event\$1type |  Tipo di evento. I valori possibili sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| event\$1timestamp | L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi. | 
| arrival\$1timestamp | L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi. | 
| event\$1version |  La versione dello schema JSON dell'evento.  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](#event-streams-data-campaign-attributes-application). | 
| client | Informazioni sull'endpoint a cui è associato l'evento. Per ulteriori informazioni, consulta la tabella [Client](#event-streams-data-campaign-attributes-client). | 
| device | Informazioni sul dispositivo che ha segnalato l'evento. Per i messaggi di campagna e transazionali, questo oggetto è vuoto. | 
| session | Informazioni sulla sessione che ha generato l'evento. Per le campagne, questo oggetto è vuoto. | 
| attributes |  Attributi associati all'evento. Per gli eventi segnalati da una delle app, questo oggetto può includere attributi personalizzati definiti dall'app. Per gli eventi che vengono creati quando si invia una campagna, questo oggetto contiene gli attributi associati alla campagna. Per gli eventi che vengono generati quando si inviano messaggi transazionali, questo oggetto contiene informazioni correlate al messaggio stesso. Per ulteriori informazioni, consulta la tabella [Attributi](#event-streams-data-campaign-attributes-attrs).  | 
| client\$1context | Contiene un oggetto custom, che contiene una proprietà endpoint. La proprietà endpoint contiene i contenuti del record di endpoint per l'endpoint a cui è stata inviata la campagna. | 
| awsAccountId |  L'ID dell' AWS account utilizzato per inviare il messaggio.  | 

### Applicazione
<a name="event-streams-data-campaign-attributes-application"></a>

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


| Attributo | Description | 
| --- | --- | 
| app\$1id |  ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.  | 
| sdk |  L'SDK utilizzato per segnalare l'evento.   | 

### Attributes
<a name="event-streams-data-campaign-attributes-attrs"></a>

Include informazioni sulla campagna che ha prodotto l'evento.


| Attributo | Description | 
| --- | --- | 
| treatment\$1id |  Se il messaggio è stato inviato utilizzando una campagna di A/B prova, questo valore rappresenta il numero di trattamento del messaggio. Per le campagne standard, questo valore è `0`.  | 
| campaign\$1activity\$1id | ID univoco generato da Amazon Pinpoint quando si verifica l'evento. | 
| delivery\$1type |  Metodo di recapito della campagna. Non confondere questo attributo con il campo `ChannelType` specificato sotto la proprietà `endpoint` di `client_context`. Il campo `ChannelType` è in genere basato sull'endpoint a cui viene inviato il messaggio. Per i canali che supportano un solo tipo di endpoint, i campi `delivery_type` e `ChannelType` hanno lo stesso valore. Ad esempio, per il canale e-mail, i campi `delivery_type` e `ChannelType` hanno lo stesso valore di EMAIL.  Tuttavia, questa condizione non è sempre vera per i canali che supportano diversi tipi di endpoint, come i canali personalizzati. Puoi utilizzare un canale personalizzato per diversi endpoint, come EMAIL, SMS, CUSTOM e così via. In questo caso, `delivery_type` identifica un evento di recapito personalizzato (CUSTOM) e `ChannelType` specifica il tipo di endpoint a cui è stata inviata la campagna, ad esempio EMAIL, SMS, CUSTOM e così via. Per ulteriori informazioni sulla creazione di canali personalizzati, consulta [Crea un canale personalizzato in Amazon Pinpoint utilizzando un webhook o una funzione Lambda](channels-custom.md). I valori possibili sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| campaign\$1id |  L'ID univoco della campagna da cui è stato inviato il messaggio.  | 
| campaign\$1send\$1status | Indica lo stato della campagna per l'endpoint di destinazione. I valori possibili includono:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

### Client
<a name="event-streams-data-campaign-attributes-client"></a>

Include informazioni sull'endpoint a cui era destinata la campagna.


| Attributo | Description | 
| --- | --- | 
| client\$1id | L'ID dell'endpoint a cui è stata inviata la campagna. | 

# Dati sugli eventi di viaggio da Amazon Pinpoint
<a name="event-streams-data-journey"></a>

Quando pubblichi un percorso, Amazon Pinpoint può trasmettere in streaming i dati degli eventi per e-mail, SMS, push e messaggi personalizzati che invii dal percorso. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni dettagliate sui dati trasmessi da Amazon Pinpoint per e-mail e SMS, consulta e. [Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint](event-streams-data-email.md) [Flusso di dati di eventi SMS da Amazon Pinpoint](event-streams-data-sms.md) Per informazioni su come configurare lo streaming di eventi, consulta. [Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md)

## Esempio di evento di viaggio
<a name="event-streams-data-journey-example"></a>

L'oggetto JSON per un evento di viaggio contiene i dati mostrati nell'esempio seguente.

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

## Attributi di eventi di viaggio
<a name="event-streams-data-journey-attributes"></a>

Questa sezione definisce gli attributi inclusi nei dati del flusso di eventi generati da Amazon Pinpoint per un percorso.


| Attributo | Descrizione | 
| --- | --- | 
| event\$1type |  Tipo di evento. Per gli eventi dei percorsi, il valore per questo attributo è sempre `_journey.send`, che indica che Amazon Pinpoint ha eseguito il percorso.  | 
| event\$1timestamp | L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi. | 
| arrival\$1timestamp | L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi. | 
| event\$1version |  La versione dello schema JSON dell'evento.  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](#event-streams-data-journey-attributes-application). | 
| client | Informazioni sull'endpoint associato all'evento. Per ulteriori informazioni, consulta la tabella [Client](#event-streams-data-journey-attributes-client). | 
| device | Informazioni sul dispositivo che ha segnalato l'evento. Per i viaggi, questo oggetto è vuoto. | 
| session | Informazioni sulla sessione che ha generato l'evento. Per i viaggi, questo oggetto è vuoto. | 
| attributes |  Attributi associati al viaggio e all'attività di viaggio che ha generato l'evento. Per ulteriori informazioni, consulta la tabella [Attributi](#event-streams-data-journey-attributes-attrs).  | 
| client\$1context | Contiene un oggetto custom, che contiene una proprietà endpoint. La proprietà endpoint contiene i contenuti del record di endpoint per l'endpoint associato all'evento. | 
| awsAccountId |  L'ID dell' AWS account utilizzato per eseguire il viaggio.  | 

### Applicazione
<a name="event-streams-data-journey-attributes-application"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| app\$1id |  ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.  | 
| sdk |  L'SDK utilizzato per segnalare l'evento.   | 

### Client
<a name="event-streams-data-journey-attributes-client"></a>

Include informazioni sull'endpoint associato all'evento.


| Attributo | Descrizione | 
| --- | --- | 
| client\$1id | ID dell'endpoint. | 

### Attributes
<a name="event-streams-data-journey-attributes-attrs"></a>

Include informazioni sul viaggio che ha generato l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| journey\$1run\$1id |  ID univoco del percorso che ha generato l'evento. Amazon Pinpoint genera e assegna automaticamente questo ID a ogni nuova esecuzione di un percorso.  | 
| journey\$1send\$1status |  Indica lo stato di consegna del messaggio associato all'evento. I valori possibili includono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-journey.html)  | 
| journey\$1id |  L'ID univoco del viaggio che ha generato l'evento.  | 
| journey\$1activity\$1id |  L'ID univoco dell'attività di viaggio che ha generato l'evento.  | 
| journey\$1activity\$1type |  Il tipo di attività di percorso dell'evento. Può essere **EMAIL**, **SMS**, **PUSH**, **CONTACT\$1CENTER** o **CUSTOM**.   **VOICE** non è un tipo di attività di percorso supportato. **Il `journey_activity_type` campo non è presente quando è impostato su QUIET\$1TIME\$1WAIT\$1FINISHED. `journey_send_status`**   | 
|  `journey_send_status_message`  | La descrizione dello stato dell'evento di invio. | 
| journey\$1send\$1status\$1code | Il codice di stato HTTP della richiesta. | 

# Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint
<a name="event-streams-data-email"></a>

Se utilizzi Amazon Pinpoint per inviare e-mail, Amazon Pinpoint può trasmettere in streaming i dati sugli eventi relativi a tali e-mail. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati degli eventi dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni su come configurare lo streaming degli eventi, consulta. [Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md) Amazon Pinpoint trasmette dati sui seguenti tipi di eventi per i messaggi e-mail:
+ Invii
+ Consegne
+ Mancati recapiti
+ Reclami
+ Aperture
+ Clic
+ Rifiuti
+ Annullamenti di sottoscrizioni
+ Errori di rendering

Questi tipi di eventi sono spiegati in dettaglio in. [Attributi di eventi e-mail](#event-streams-data-email-attributes)

A seconda dell'API e delle impostazioni utilizzate per inviare messaggi e-mail, è possibile che vengano visualizzati altri tipi di eventi o dati diversi. Ad esempio, se invii messaggi utilizzando set di configurazione che pubblicano i dati degli eventi in Amazon Kinesis, ad esempio quelli forniti da Amazon Simple Email Service (Amazon SES), i dati possono includere anche eventi per errori di rendering dei modelli. Per informazioni su questi dati, consulta [Monitoraggio tramite la pubblicazione degli eventi Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) nella *Guida per gli sviluppatori di Amazon Simple Email Service*. Prima di poter visualizzare i tuoi eventi devi configurare lo streaming degli eventi, vedi[Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md). Quando configuri lo streaming degli eventi, specifichi una destinazione in cui salvare i dati dell'evento, quindi puoi utilizzare la destinazione per recuperare i dati dell'evento per la visualizzazione.

## Esempi di eventi via e-mail
<a name="event-streams-data-email-example"></a>

**Invio di e-mail**  
L'oggetto JSON per un evento di *invio e-mail* contiene i dati mostrati nell'esempio seguente.

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

**Consegna di e-mail**  
L'oggetto JSON per un evento di *consegna e-mail* contiene i dati mostrati nell'esempio seguente.

```
{
  "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 su e-mail**  
L'oggetto JSON per un evento di *clic su e-mail* contiene i dati mostrati nell'esempio seguente.

```
{
  "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 di e-mail**  
L'oggetto JSON per un evento di *apertura e-mail* contiene i dati mostrati nell'esempio seguente.

```
{
  "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)"
        }
      }
    }
  }
}
```

## Attributi di eventi e-mail
<a name="event-streams-data-email-attributes"></a>

Questa sezione definisce gli attributi inclusi nell'esempio precedente dei dati del flusso di eventi che Amazon Pinpoint genera quando invii messaggi e-mail.


| Attributo | Descrizione | 
| --- | --- | 
| event\$1type |  Tipo di evento. I valori possibili sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| event\$1timestamp |  L'ora in cui il messaggio è stato inviato, espressa nel formato orario Unix in millisecondi. Questo valore è in genere lo stesso per tutti gli eventi generati per un messaggio.  | 
| arrival\$1timestamp |  L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi.  | 
| event\$1version |  La versione dello schema JSON dell'evento.  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 sul client dell'app installato nel dispositivo 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*. Per gli eventi e-mail, questo oggetto è vuoto.  | 
| session | Per gli eventi e-mail, questo oggetto è vuoto. | 
| attributes |  Attributi associati all'evento. Per ulteriori informazioni, consulta la tabella *Attributi*. Per gli eventi segnalati da una delle app, questo oggetto può includere attributi personalizzati definiti dall'app. Per gli eventi creati quando si invia un messaggio da una campagna o da un viaggio, questo oggetto contiene gli attributi associati alla campagna o al viaggio. Per gli eventi che vengono generati quando si inviano messaggi transazionali, questo oggetto contiene informazioni correlate al messaggio stesso.  | 
| client\$1context | Per gli eventi e-mail, questo oggetto contiene un oggetto denominato custom, che contiene un attributo legacy\$1identifier. Il valore dell'attributo legacy\$1identifier è l'ID del progetto da cui è stato inviato il messaggio. | 
| facets |  Ulteriori informazioni sul messaggio, ad esempio le intestazioni e-mail. Per ulteriori informazioni, consulta la tabella *Facet*.  | 
| awsAccountId |  L'ID dell' AWS account utilizzato per inviare il messaggio.  | 

### Applicazione
<a name="event-streams-data-email-attributes-application"></a>

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


| Attributo | Descrizione | 
| --- | --- | 
| app\$1id |  ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.  | 
| sdk |  L'SDK utilizzato per segnalare l'evento. Se invii un messaggio e-mail transazionale chiamando direttamente l'API Amazon Pinpoint o utilizzando la console Amazon Pinpoint, questo oggetto è vuoto.  | 

### Attributes
<a name="event-streams-data-email-attributes-attrs"></a>

Include informazioni sulla campagna o viaggio che ha prodotto l'evento.

#### Campagna
<a name="event-streams-data-email-attributes-attrs-campaigns"></a>

Include informazioni sulla campagna che ha prodotto l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| feedback |  Per gli eventi `_email.click`, il valore di questo attributo è l'URL del collegamento su cui il destinatario ha fatto clic per generare l'evento. Per gli altri eventi, questo valore rappresenta il tipo di evento, ad esempio `received`, `opened` o `clicked`.  | 
| treatment\$1id |  Se il messaggio è stato inviato utilizzando una campagna di test A/B, questo valore rappresenta il numero della descrizione (treatment) del messaggio. Per le campagne standard e i messaggi e-mail transazionali, questo valore è `0`.  | 
| campaign\$1activity\$1id | ID univoco generato da Amazon Pinpoint quando si verifica l'evento. | 
| campaign\$1id |  L'ID univoco della campagna che ha inviato il messaggio.  | 

#### Viaggio
<a name="event-streams-data-email-attributes-attrs-journey"></a>

Include informazioni sul viaggio che ha prodotto l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| journey\$1run\$1id | ID univoco del percorso che ha inviato il messaggio. Amazon Pinpoint genera e assegna automaticamente questo ID a ogni nuova esecuzione di un percorso. | 
| feedback |  Per gli eventi `_email.click`, il valore di questo attributo è l'URL del collegamento su cui il destinatario ha fatto clic per generare l'evento. Per gli altri eventi, questo valore rappresenta il tipo di evento, ad esempio `received`, `delivered` o `opened`.  | 
| journey\$1id | L'ID univoco del viaggio che ha inviato il messaggio. | 
| journey\$1activity\$1id | L'ID univoco dell'attività di viaggio che ha inviato il messaggio. | 

### Client
<a name="event-streams-data-email-attributes-client"></a>

Identificatore univoco del client che è stato scelto come target dalla campagna o dal percorso.


| Attributo | Descrizione | 
| --- | --- | 
| client\$1id | ID del client. Il valore è l'ID dell'endpoint per campagne e percorsi e, per l'invio transazionale, è un UUID. | 

### Facet
<a name="event-streams-data-email-attributes-facets"></a>

Include informazioni sul messaggio e sul tipo di evento.


| Attributo | Descrizione | 
| --- | --- | 
| email\$1channel |  Contiene un oggetto `mail_event`, che contiene due oggetti: `mail` e un oggetto corrispondente al tipo di evento.  | 

### Mail
<a name="event-streams-data-email-attributes-mail"></a>

Include informazioni sul contenuto del messaggio e-mail, nonché i metadati relativi al messaggio.


| Attributo | Descrizione | 
| --- | --- | 
| message\$1id |  ID univoco del messaggio. Amazon Pinpoint genera automaticamente questo ID quando accetta il messaggio.  | 
| message\$1send\$1timestamp |  La data e l'ora in cui il messaggio è stato inviato, nel formato specificato in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822).  | 
| from\$1address |  L'indirizzo e-mail da cui è stato inviato il messaggio.  | 
| destination |  Un array che contiene gli indirizzi e-mail a cui è stato inviato il messaggio.  | 
| headers\$1truncated |  Un valore booleano che indica se le intestazioni e-mail sono state troncate.  | 
| headers |  Un oggetto che contiene diverse coppie nome-valore che corrispondono alle intestazioni nel messaggio. Questo oggetto in genere contiene informazioni sulle seguenti intestazioni: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| common\$1headers |  Contiene informazioni su varie intestazioni comuni per i messaggi e-mail. Le informazioni possono includere la data di invio del messaggio e le righe del destinatario, del mittente e dell'oggetto del messaggio.  | 

# Flusso di dati di eventi SMS da Amazon Pinpoint
<a name="event-streams-data-sms"></a>

Se in un progetto è abilitato il canale SMS, Amazon Pinpoint può eseguire lo streaming dei dati di eventi relativi ai recapiti dei messaggi SMS per il progetto. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati degli eventi dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni su come configurare lo streaming degli eventi, consulta. [Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose](event-streams-setup.md) 

**Nota**  
Gli eventi SMS generati dai corrieri possono richiedere fino a 72 ore per essere ricevuti e non devono essere utilizzati per determinare se c'è un ritardo nella consegna dei messaggi in uscita. Dopo 72 ore, se Amazon Pinpoint non ha ricevuto un evento finale da un corriere, il servizio restituisce automaticamente un record\$1status UNKNOWN, poiché Amazon Pinpoint non sa cosa è successo a quel messaggio.

## Esempio di evento SMS
<a name="event-streams-data-sms-example"></a>

L'oggetto JSON per un evento SMS contiene i dati mostrati nell'esempio seguente.

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

## Attributi di eventi SMS
<a name="event-streams-data-sms-attributes"></a>

Questa sezione definisce gli attributi inclusi nell'esempio precedente dei dati del flusso di eventi che Amazon Pinpoint genera quando invii messaggi SMS.


**Evento**  

| Attributo | Descrizione | 
| --- | --- | 
| event\$1type |  Tipo di evento. I valori possibili sono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| event\$1timestamp | L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi. | 
| arrival\$1timestamp | L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi. | 
| event\$1version |  La versione dello schema JSON dell'evento.  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](#event-streams-data-sms-attributes-application). | 
| client | Informazioni sul client dell'app installato nel dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella [Client](#event-streams-data-sms-attributes-client). | 
| device | Informazioni sul dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella [Dispositivo](#event-streams-data-sms-attributes-device). Per gli eventi SMS, questo oggetto è vuoto. | 
| session | Per gli eventi SMS, questo oggetto è vuoto. | 
| attributes |  Attributi associati all'evento. Per gli eventi segnalati da una delle app, questo oggetto può includere attributi personalizzati definiti dall'app. Per gli eventi che vengono creati quando si invia una campagna, questo oggetto contiene gli attributi associati alla campagna. Per gli eventi che vengono generati quando si inviano messaggi transazionali, questo oggetto contiene informazioni correlate al messaggio stesso. Per ulteriori informazioni, consulta la tabella [Attributi](#event-streams-data-sms-attributes-attrs).  | 
| metrics |  Parametri aggiuntivi associati all'evento. Per ulteriori informazioni, consulta la tabella [Parametri](#event-streams-data-sms-attributes-metrics).  | 
| awsAccountId |  L'ID dell' AWS account utilizzato per inviare il messaggio.  | 

### Applicazione
<a name="event-streams-data-sms-attributes-application"></a>

Include informazioni sul progetto Amazon Pinpoint a cui è associato l'evento e, se applicabile, sull'SDK utilizzato per segnalare l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| app\$1id |  ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.  | 
| sdk |  L'SDK utilizzato per segnalare l'evento. Se invii un messaggio SMS transazionale chiamando direttamente l'API Amazon Pinpoint o utilizzando la console Amazon Pinpoint, questo oggetto è vuoto.  | 

### Attributes
<a name="event-streams-data-sms-attributes-attrs"></a>

Include informazioni sugli attributi associati all'evento.


| Attributo | Descrizione | 
| --- | --- | 
| sender\$1request\$1id | Un ID univoco associato alla richiesta di invio del messaggio SMS. | 
| campaign\$1activity\$1id | L'ID univoco dell'attività all'interno della campagna. | 
| origination\$1phone\$1number |  Il numero di telefono da cui è stato inviato il messaggio.  | 
| destination\$1phone\$1number |  Il numero di telefono a cui hai tentato di inviare il messaggio.  | 
| record\$1status |  Ulteriori informazioni sullo stato del messaggio. I valori possibili includono: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| iso\$1country\$1code |  Il paese associati al numero di telefono del destinatario, mostrati nel formato ISO 3166-1 alpha-2.  | 
| treatment\$1id |  L'ID della descrizione (treatment) del messaggio, se il messaggio è stato inviato in una campagna A/B.  | 
| treatment\$1id |  Se il messaggio è stato inviato utilizzando una campagna di test A/B, questo valore rappresenta il numero della descrizione (treatment) del messaggio. Per i messaggi SMS transazionali, questo valore è 0.  | 
| number\$1of\$1message\$1parts |  Numero di parti di messaggio che Amazon Pinpoint ha creato per inviare il messaggio. In genere, i messaggi SMS possono contenere solo 160 caratteri GSM-7 o 67 caratteri non GSM, anche se questi limiti possono variare in base al paese . Se invii un messaggio che supera questi limiti, Amazon Pinpoint lo suddivide automaticamente in parti più piccole. I costi vengono fatturati in base al numero di parti del messaggio inviate.  | 
| message\$1id |  ID univoco che Amazon Pinpoint genera quando accetta il messaggio.  | 
| message\$1type |  Il tipo di messaggio. I valori possibili sono **Promotional (Promozionale)** e **Transactional (Transazionale)**. Specifichi questo valore quando crei una campagna o quando invii messaggi transazionali utilizzando l'[SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)operazione nell'API Amazon Pinpoint.  | 
| campaign\$1id |  ID univoco della campagna Amazon Pinpoint che ha inviato il messaggio.  | 
| customer\$1context | Una stringa JSON del contenuto della `Context` mappa inviata in un'operazione Amazon [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)Pinpoint. | 

### Client
<a name="event-streams-data-sms-attributes-client"></a>

Include informazioni sul client dell'app installato nel dispositivo che ha segnalato l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| client\$1id |  Per gli eventi generati dalle app, questo valore è l'ID univoco del client dell'app installato sul dispositivo. Questo ID viene generato automaticamente da AWS Mobile SDK for iOS e da. AWS Mobile SDK per Android Per gli eventi generati quando invii campagne e messaggi transazionali, questo valore è uguale all'ID dell'endpoint a cui hai inviato il messaggio.  | 
| cognito\$1id | ID univoco assegnato al client dell'app nel pool di identità Amazon Cognito utilizzato dall'app. | 

### Dispositivo
<a name="event-streams-data-sms-attributes-device"></a>

Include informazioni sul dispositivo che ha segnalato l'evento.


| Attributo | Descrizione | 
| --- | --- | 
| locale | Le impostazioni locali del dispositivo. | 
| make | La marca del dispositivo, ad esempio Apple o Samsung. | 
| model | Il modello del dispositivo, ad esempio iPhone. | 
| platform | La piattaforma del dispositivo, ad esempio ios o android. | 

### Metriche
<a name="event-streams-data-sms-attributes-metrics"></a>

Include informazioni sui parametri associati all'evento.


| Attributo | Descrizione | 
| --- | --- | 
| price\$1in\$1millicents\$1usd | L'importo addebitato per l'invio del messaggio. Questo prezzo è indicato in millesimi di un centesimo degli Stati Uniti. Ad esempio, se il valore di questo attributo è `645`, vengono addebitati 0,645 ¢ per l'invio del messaggio (645/1000=0,645¢=\$10,00645).  Questa proprietà non viene visualizzata per i messaggi con un `event_type` di **\$1SMS.BUFFERED**.   | 

# Eliminare un flusso di eventi da Amazon Pinpoint
<a name="event-streams-disable"></a>

Se assegni un flusso Kinesis a un'applicazione, puoi disabilitare lo streaming di eventi per quell'applicazione. Amazon Pinpoint interrompe lo streaming degli eventi su Kinesis, ma puoi visualizzare l'analisi degli eventi utilizzando la console Amazon Pinpoint.

## AWS CLI
<a name="event-streams-disable-cli"></a>

Utilizza il 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 per Java
<a name="event-streams-disable-java"></a>

Utilizza il [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)metodo del client Amazon Pinpoint:

```
pinClient.deleteEventStream(new DeleteEventStreamRequest().withApplicationId(appId));
```