Esempio di evento di viaggio Attributi di eventi di viaggio

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 la pagina relativa alla fine del supporto di Amazon Pinpoint. 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 AWS End User Messaging.

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à.

Dati sugli eventi di viaggio da Amazon Pinpoint

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 Flusso di dati di eventi SMS da Amazon Pinpoint 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

Esempio di evento di viaggio

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

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

Attributo	Descrizione
`event_type`	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_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 schema JSON dell'evento. 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 associato all'evento. Per ulteriori informazioni, consulta la tabella 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.
`client_context`	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

Include le 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.
`sdk`	L'SDK utilizzato per segnalare l'evento.

Client

Include informazioni sull'endpoint associato all'evento.

Attributo	Descrizione
`client_id`	ID dell'endpoint.

Attributes

Include informazioni sul viaggio che ha generato l'evento.

Attributo	Descrizione
`journey_run_id`	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_send_status`	Indica lo stato di consegna del messaggio associato all'evento. I valori possibili includono: SUCCESS: la campagna è stata inviata correttamente all'endpoint. FAILURE: il messaggio non è stato inviato all'endpoint a causa di un errore. CUSTOM_DELIVERY_FAILURE: recapito personalizzato non riuscito. FAILURE_PERMANENT: si è verificato un errore permanente durante l'invio all'endpoint. Suggerimento È possibile filtrare gli eventi con stato FAILURE_PERMANENT e `journey_send_status_code` impostarli su 403 per determinare se vi è una violazione della politica di accesso e del ruolo. Per le campagne vocali in uscita, queste eccezioni sono tipiche dei casi in cui il ruolo di esecuzione della campagna Connect che collega i viaggi di Amazon Pinpoint alle campagne Amazon Connect viene inavvertitamente eliminato per le esecuzioni di viaggio in corso. THROTTLED: l'invio è stato limitato a livello di larghezza di banda della rete. UNSUPPORTED_CHANNEL: canale non supportato. DAILY_CAP: il messaggio non è stato inviato all'endpoint in quanto l'invio del messaggio supera il numero massimo di messaggi che il percorso o il progetto può inviare a un singolo endpoint in un intervallo di 24 ore. QUIET_TIME: il messaggio non è stato inviato a causa delle limitazioni per l'intervallo di silenzio per il percorso o progetto. QUIET_TIME_MISSING_TIMEZONE: il messaggio non è stato inviato perché la stima del fuso orario non è in grado di stimare un fuso orario per l'endpoint e il periodo di silenzio è abilitato.
`journey_id`	L'ID univoco del viaggio che ha generato l'evento.
`journey_activity_id`	L'ID univoco dell'attività di viaggio che ha generato l'evento.
`journey_activity_type`	Il tipo di attività di percorso dell'evento. Può essere EMAIL, SMS, PUSH, CONTACT_CENTER o CUSTOM. Nota VOICE non è un tipo di attività di percorso supportato. Il `journey_activity_type` campo non è presente quando è impostato su QUIET_TIME_WAIT_FINISHED. `journey_send_status`
`journey_send_status_message`	La descrizione dello stato dell'evento di invio.
`journey_send_status_code`	Il codice di stato HTTP della richiesta.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Flusso di dati sugli eventi della campagna da Amazon Pinpoint

Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint