**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à. # Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint 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 **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 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 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 Include informazioni sulla campagna o viaggio che ha prodotto l'evento. #### Campagna 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 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 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 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 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. |