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à.
Eventi e-mail
Prima di poter visualizzare i tuoi eventi devi configurare lo streaming degli eventi, vediConfigurazione dello streaming degli eventi. 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. Quando invii messaggi e-mail, Amazon Pinpoint può eseguire lo streaming dei dati che forniscono informazioni aggiuntive sui seguenti tipi di eventi relativi ai messaggi:
-
Invii
-
Consegne
-
Mancati recapiti
-
Reclami
-
Aperture
-
Clic
-
Rifiuti
-
Annullamenti di sottoscrizioni
-
Errori di rendering
I tipi di evento nell'elenco precedente sono illustrati in dettaglio in Attributi di eventi e-mail.
A seconda delle impostazioni API e delle impostazioni utilizzate per inviare messaggi e-mail, è possibile visualizzare tipi di eventi aggiuntivi o dati diversi. Ad esempio, se invii messaggi utilizzando set di configurazione che pubblicano dati di eventi su Amazon Kinesis, come quelli forniti da Amazon Simple Email Service SES (Amazon), i dati possono includere anche eventi per errori di rendering dei modelli. Per informazioni su questi dati, consulta Monitoring using Amazon SES Event Publishing nella Amazon Simple Email Service Developer Guide. Prima di poter visualizzare i tuoi eventi devi configurare lo streaming degli eventi, vediConfigurazione dello streaming degli eventi. 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.
Eventi di esempio
Invio di e-mail
L'JSONoggetto 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'JSONoggetto per un evento di invio di posta elettronica 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'JSONoggetto per un evento email click 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'JSONoggetto per un evento email open 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 nei dati del flusso di eventi generati da Amazon Pinpoint quando invii messaggi e-mail.
Attributo | Descrizione |
---|---|
event_type |
Tipo di evento. I valori possibili sono:
|
event_timestamp |
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_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. SuggerimentoSeleziona 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_context |
Per gli eventi e-mail, questo oggetto contiene un oggetto denominato custom , che contiene un attributo legacy_identifier . Il valore dell'attributo legacy_identifier è 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_id |
ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento. |
sdk |
Il SDK che è stato usato per segnalare l'evento. Se invii un messaggio e-mail transazionale chiamando direttamente Amazon API 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 |
treatment_id |
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 è |
campaign_activity_id |
ID univoco generato da Amazon Pinpoint quando si verifica l'evento. |
campaign_id |
L'ID univoco della campagna che ha inviato il messaggio. |
Viaggio
Include informazioni sul viaggio che ha prodotto l'evento.
Attributo | Descrizione |
---|---|
journey_run_id |
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 |
journey_id |
L'ID univoco del viaggio che ha inviato il messaggio. |
journey_activity_id |
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_id |
ID del client. Il valore è l'Endpoint ID per campagne e viaggi, mentre per l'invio transazionale è un. UUID |
Facet
Include informazioni sul messaggio e sul tipo di evento.
Attributo | Descrizione |
---|---|
email_channel |
Contiene un oggetto |
Include informazioni sul contenuto del messaggio e-mail, nonché i metadati relativi al messaggio.
Attributo | Descrizione |
---|---|
message_id |
ID univoco del messaggio. Amazon Pinpoint genera automaticamente questo ID quando accetta il messaggio. |
message_send_timestamp |
La data e l'ora di invio del messaggio, nel formato specificato in 822. RFC |
from_address |
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_truncated |
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:
|
common_headers |
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. |