Contenuto dei dati sugli eventi che Amazon SES pubblica su Firehose

Amazon SES pubblica i record degli eventi di invio di e-mail ad Amazon Data JSON Firehose in formato. Quando pubblica eventi su Firehose, Amazon SES segue ogni JSON record con un carattere di nuova riga.

È possibile trovare record di esempio per tutti questi tipi di notifica in Esempi di dati sugli eventi che Amazon SES pubblica su Firehose.

Oggetto di primo livello JSON

L'JSONoggetto di primo livello in un record di evento di invio di posta elettronica contiene i seguenti campi.

Nome campo	Descrizione
eventType	Una stringa che descrive il tipo di evento. Valori possibili: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay o Subscription. Se non hai configurato la pubblicazione di eventi, questo campo è denominato notificationType.
mail	Un JSON oggetto che contiene informazioni sull'e-mail che ha prodotto l'evento.
bounce	Questo campo è presente solo se eventType è Bounce. Contiene informazioni sul mancato recapito.
complaint	Questo campo è presente solo se eventType è Complaint. Contiene informazioni sul reclamo.
delivery	Questo campo è presente solo se eventType è Delivery. Contiene informazioni sulla consegna.
send	Questo campo è presente solo se eventType è Send.
reject	Questo campo è presente solo se eventType è Reject. Contiene informazioni sul rifiuto.
open	Questo campo è presente solo se eventType è Open. Contiene informazioni sull'evento di apertura.
click	Questo campo è presente solo se eventType è Click. Contiene informazioni sull'evento clic.
failure	Questo campo è presente solo se eventType è Rendering Failure. Contiene informazioni sull'evento di errore di rendering.
deliveryDelay	Questo campo è presente solo se eventType è DeliveryDelay. Contiene informazioni sulla consegna ritardata di un'e-mail.
subscription	Questo campo è presente solo se eventType è Subscription. Contiene informazioni sulle preferenze relative alle sottoscrizioni.

Oggetto mail

Ogni record di eventi di invio di e-mail contiene informazioni sull'e-mail originale nell'oggetto mail. L'JSONoggetto che contiene informazioni su un mail oggetto ha i seguenti campi.

Nome campo	Descrizione
timestamp	La data e l'ora, in formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz), in cui è stato inviato il messaggio.
messageId	Un ID univoco SES assegnato da Amazon al messaggio. Amazon ti SES ha restituito questo valore quando hai inviato il messaggio. Nota Questo ID messaggio è stato assegnato da AmazonSES. Puoi trovare l'ID messaggio dell'e-mail originale nei campi headers e commonHeaders dell'oggetto mail.
source	L'indirizzo e-mail da cui è stato inviato il messaggio (l'MAILFROMindirizzo della busta).
sourceArn	L'Amazon Resource Name (ARN) dell'identità utilizzata per inviare l'e-mail. In caso di autorizzazione all'invio, sourceArn si tratta ARN dell'identità che il proprietario dell'identità ha autorizzato il mittente delegato a utilizzare per inviare l'e-mail. Per ulteriori informazioni sull'autorizzazione all'invio, consulta Metodi di autenticazione delle e-mail.
sendingAccountId	L' AWS ID dell'account utilizzato per inviare l'e-mail. Nel caso di autorizzazione all'invio, sendingAccountId è l'ID account del mittente delegato.
destination	Un elenco degli indirizzi e-mail destinatari della posta originale.
headersTruncated	Una stringa che specifica se le intestazioni vengono troncate nella notifica. Ciò si verifica se le intestazioni hanno dimensione superiore a 10 KB. I valori possibili sono true e false.
headers	Un elenco delle intestazioni originali dell'e-mail. Ogni intestazione nell'elenco include un campo name e un campo value. Nota Qualsiasi ID messaggio all'interno del headers campo proviene dal messaggio originale che hai passato ad AmazonSES. L'ID del messaggio che Amazon SES ha successivamente assegnato al messaggio si trova nel messageId campo dell'mailoggetto.
commonHeaders	Una mappatura delle intestazioni originali, di uso frequente, dell'e-mail. Nota Qualsiasi ID messaggio all'interno del commonHeaders campo è l'ID del messaggio che Amazon SES ha successivamente assegnato al messaggio nel messageId campo dell'mailoggetto.
tags	Un elenco di tag associati all'e-mail.

Oggetto del mancato recapito

L'JSONoggetto che contiene informazioni su un Bounce evento avrà sempre i seguenti campi.

Nome campo	Descrizione
bounceType	Il tipo di rimbalzo, come determinato da Amazon. SES
bounceSubType	Il sottotipo di rimbalzo, come determinato da Amazon. SES
bouncedRecipients	Elenco che contiene informazioni sui destinatari della posta originale che non è stata recapitata.
timestamp	La data e l'ora, in formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz), in cui ha inviato la notifica di rimbalzo. ISP
feedbackId	Un ID univoco per il mancato recapito.
reportingMTA	Il DSN valore del campo proveniente da. Reporting-MTA Questo è il valore della Message Transfer Authority (MTA) che ha tentato di eseguire l'operazione di consegna, inoltro o gateway descritta in. DSN Nota Questo campo viene visualizzato solo se al rimbalzo è stata allegata una notifica sullo stato della consegna (DSN).

Destinatari del mancato recapito

Un evento di mancato recapito può riguardare uno o più destinatari. Il campo bouncedRecipients include un elenco di oggetti, uno per ogni destinatario interessato dall'evento di mancato recapito, e conterrà sempre il campo seguente.

Nome campo	Descrizione
emailAddress	L'indirizzo e-mail del destinatario. Se a DSN è disponibile, questo è il valore del Final-Recipient campo tratto da. DSN

Facoltativamente, se al rimbalzo DSN è associato un, possono essere presenti anche i seguenti campi.

Nome campo	Descrizione
action	Il valore del Action campo tratto da. DSN Indica l'azione eseguita dal segnalatore a MTA seguito del tentativo di recapitare il messaggio a questo destinatario.
status	Il valore del Status campo proveniente daDSN. Questo è il codice di stato indipendente dal trasporto che indica lo stato di consegna del messaggio per ogni destinatario.
diagnosticCode	Il codice di stato emesso dal segnalatoreMTA. Questo è il valore del Diagnostic-Code campo diDSN. Questo campo può essere assente in DSN (e quindi anche assente in). JSON

Tipi di mancato recapito

Ogni evento di mancato recapito rientra in uno dei tipi illustrati nella seguente tabella.

Il sistema di pubblicazione degli eventi pubblica solo hard bounce e soft bounce che non verranno più riprovati da Amazon. SES Quando ricevi messaggi di rimbalzo contrassegnatiPermanent, devi rimuovere gli indirizzi e-mail corrispondenti dalla tua mailing list; non potrai più inviarli in futuro. Transienti messaggi di rimbalzo vengono inviati quando un messaggio viene respinto più volte e Amazon SES ha smesso di provare a recapitarlo. In futuro, potresti riuscire nuovamente a inviare messaggi a un indirizzo che inizialmente ha generato un mancato recapito Transient.

bounceType	bounceSubType	Descrizione
Undetermined	Undetermined	Amazon non SES è stato in grado di determinare un motivo specifico di rimbalzo.
Permanent	General	Amazon SES ha ricevuto un duro rimbalzo generale. Se ricevi questo tipo di mancato recapito, devi eliminare l'indirizzo e-mail del destinatario dalla lista di distribuzione.
Permanent	NoEmail	Amazon SES ha ricevuto un hard bounce permanente perché l'indirizzo e-mail di destinazione non esiste. Se ricevi questo tipo di mancato recapito, devi eliminare l'indirizzo e-mail del destinatario dalla lista di distribuzione.
Permanent	Suppressed	Amazon SES ha sospeso l'invio a questo indirizzo perché, di recente, l'indirizzo non era valido. Per sovrascrivere l'elenco di eliminazione globale, consulta Utilizzo dell'elenco di soppressione a SES livello di account Amazon.
Permanent	OnAccountSuppressionList	Amazon SES ha eliminato l'invio a questo indirizzo perché è presente nell'elenco di soppressione a livello di account. Ciò non influisce sulla metrica relativa alla frequenza dei mancati recapiti.
Transient	General	Amazon SES ha ricevuto un rimbalzo generale. È possibile che riesca a inviare messaggi a questo destinatario in futuro.
Transient	MailboxFull	Amazon SES ha ricevuto una casella di posta elettronica completamente respinta. È possibile che riesca a inviare messaggi a questo destinatario in futuro.
Transient	MessageTooLarge	Amazon SES ha ricevuto un messaggio di rimbalzo troppo grande. Potresti riuscire a inviare il messaggio al destinatario riducendo le dimensioni.
Transient	ContentRejected	Amazon SES ha ricevuto un messaggio di rimbalzo relativo ai contenuti rifiutati. Potresti riuscire a inviare il messaggio al destinatario modificandone il contenuto.
Transient	AttachmentRejected	Amazon SES ha ricevuto un allegato respinto. Potresti riuscire a inviare il messaggio al destinatario rimuovendo o modificando l'allegato.

Oggetto del reclamo

L'JSONoggetto che contiene informazioni su un Complaint evento ha i seguenti campi.

Nome campo	Descrizione
complainedRecipients	Un elenco che contiene informazioni sui destinatari che potrebbero avere inviato il reclamo.
timestamp	La data e l'ora, in formato ISO86 01 (YYYY-MM-:MM:ss.sz DDThh), in cui ha inviato la notifica di reclamo. ISP
feedbackId	Un ID univoco per il reclamo.
complaintSubType	Il sottotipo del reclamo, come determinato da AmazonSES.

Inoltre, se un report di feedback è associato al reclamo, potrebbero essere presenti i campi seguenti.

Nome campo	Descrizione
userAgent	Il valore del campo User-Agent nel report di feedback. Indica il nome e la versione del sistema che ha generato il report.
complaintFeedbackType	Il valore del Feedback-Type campo del rapporto di feedback ricevuto da. ISP Contiene il tipo di feedback.
arrivalDate	Il valore del Received-Date campo Arrival-Date o del rapporto di feedback in formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz). Questo campo può essere assente nel rapporto (e quindi anche assente nel). JSON

Destinatari che hanno inviato il reclamo

Il campo complainedRecipients contiene un elenco di destinatari che potrebbero aver inviato il reclamo.

Importante

Poiché la maggior ISPs parte oscura l'indirizzo e-mail del destinatario che ha inviato il reclamo nella notifica di reclamo, questo elenco contiene informazioni sui destinatari che potrebbero aver inviato il reclamo, in base ai destinatari del messaggio originale e al destinatario ISP da cui abbiamo ricevuto il reclamo. Amazon SES esegue una ricerca rispetto al messaggio originale per determinare questo elenco di destinatari.

JSONgli oggetti in questo elenco contengono il seguente campo.

Nome campo	Descrizione
emailAddress	L'indirizzo e-mail del destinatario.

Tipi di reclamo

Secondo il sito Web dell'Internet Assigned Numbers AuthorityISP, nel complaintFeedbackType campo sono presenti i seguenti tipi di reclami assegnati dalla segnalazione:

Nome campo	Descrizione
abuse	Indica un messaggio e-mail indesiderato o un altro tipo di uso illecito dell'e-mail.
auth-failure	Report di errore di autenticazione dell'e-mail.
fraud	Indica un tipo di frode o attività di phishing.
not-spam	Indica che l'entità che fornisce il report non considera il messaggio come spam. Può essere utilizzato per correggere un messaggio che è stato erroneamente contrassegnato o classificato come spam.
other	Indica qualsiasi altro feedback che non rientra in altri tipi registrati.
virus	Segnala la presenza di un virus nel messaggio di origine.

Oggetto di consegna

L'JSONoggetto che contiene informazioni su un Delivery evento avrà sempre i seguenti campi.

Nome campo	Descrizione
timestamp	La data e l'ora in cui Amazon SES ha inviato l'e-mail al server di posta del destinatario, in formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).
processingTimeMillis	Il tempo in millisecondi tra il momento in cui Amazon SES ha accettato la richiesta dal mittente e il momento in cui Amazon SES ha passato il messaggio al server di posta del destinatario.
recipients	Un elenco dei destinatari mirati a cui si applica l'evento di consegna.
smtpResponse	Il messaggio di SMTP risposta del telecomando ISP che ha accettato l'e-mail da AmazonSES. Questo messaggio varierà in base all'e-mail, al server di posta ricevente e alla ricezioneISP.
reportingMTA	Il nome host del server di SES posta Amazon che ha inviato la posta.

Oggetto send

L'JSONoggetto che contiene informazioni su un send evento è sempre vuoto.

Oggetto reject

L'JSONoggetto che contiene informazioni su un Reject evento avrà sempre i seguenti campi.

Nome campo	Descrizione
reason	Il motivo per cui l'e-mail è stata rifiutata. L'unico valore possibile èBad content, il che significa che Amazon ha SES rilevato che l'e-mail conteneva un virus. Quando un messaggio viene rifiutato, Amazon SES interrompe l'elaborazione e non tenta di recapitarlo al server di posta del destinatario.

Oggetto open

L'JSONoggetto che contiene informazioni su un Open evento conterrà sempre i seguenti campi.

Nome campo	Descrizione
ipAddress	L'indirizzo IP del destinatario.
timestamp	La data e l'ora in cui si è verificato l'evento aperto nel formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).
userAgent	L'agente utente del dispositivo o del client di posta elettronica che il destinatario ha utilizzato per aprire l'e-mail.

Oggetto click

L'JSONoggetto che contiene informazioni su un evento conterrà sempre i seguenti campi. Click

Nome campo	Descrizione
ipAddress	L'indirizzo IP del destinatario.
timestamp	La data e l'ora in cui si è verificato l'evento click nel formato ISO86 01 (YYYY-MM DDThh -:MM:SS.sz).
userAgent	L'agente utente del client che il destinatario ha utilizzato per fare clic su un collegamento nell'e-mail.
link	Il link su cui il destinatario ha fatto clic. URL
linkTags	Un elenco dei tag che sono stati aggiunti al collegamento utilizzando l'attributo ses:tags. Per ulteriori informazioni sull'aggiunta di tag ai collegamenti nelle e-mail, consulta D5. Posso aggiungere tag ai collegamenti con identificatori univoci? in Domande frequenti sui parametri per l'invio di e-mail con Amazon SES.

Oggetto errore di rendering

L'JSONoggetto che contiene informazioni su un Rendering Failure evento ha i seguenti campi.

Nome campo	Descrizione
templateName	Nome del modello usato per inviare l'e-mail.
errorMessage	Messaggio che fornisce altre informazioni sull'errore di rendering.

DeliveryDelay oggetto

L'JSONoggetto che contiene informazioni su un DeliveryDelay evento ha i seguenti campi.

Nome campo	Descrizione
delayType	Il tipo di ritardo. I valori possibili sono: InternalFailure— Un SES problema interno di Amazon ha causato il ritardo del messaggio. Generale: durante la SMTP conversazione si è verificato un errore generico. MailboxFull— La casella di posta del destinatario è piena e non è in grado di ricevere messaggi aggiuntivi. SpamDetected— Il server di posta del destinatario ha rilevato una grande quantità di e-mail indesiderate dal tuo account. RecipientServerError— Un problema temporaneo con il server di posta elettronica del destinatario impedisce la consegna del messaggio. IPFailure— L'indirizzo IP che invia il messaggio viene bloccato o limitato dal provider di posta elettronica del destinatario. TransientCommunicationFailure— Si è verificato un errore temporaneo di comunicazione durante la SMTP conversazione con il provider di posta elettronica del destinatario. BYOIPHostNameLookupUnavailable— Amazon non SES è riuscito a cercare il DNS nome host per i tuoi indirizzi IP. Questo tipo di ritardo si verifica solo quando si utilizza Bring Your Own IP. Indeterminato: Amazon SES non è stato in grado di determinare il motivo del ritardo nella consegna. SendingDeferral— Amazon SES ha ritenuto opportuno rinviare internamente il messaggio.
delayedRecipients	Oggetto che contiene informazioni sul destinatario del messaggio di posta elettronica.
expirationTime	La data e l'ora in cui Amazon SES smetterà di tentare di recapitare il messaggio. Questo valore viene visualizzato nel formato ISO 8601.
reportingMTA	L'indirizzo IP del Message Transfer Agent (MTA) che ha segnalato il ritardo.
timestamp	La data e l'ora in cui si è verificato il ritardo, mostrate nel formato ISO 8601.

Destinatari del ritardo di consegna

L'oggetto delayedRecipients include i seguenti valori.

Nome campo	Descrizione
emailAddress	Indirizzo di posta elettronica che ha provocato un ritardo nel recapito del messaggio.
status	Il codice di SMTP stato associato al ritardo di consegna.
diagnosticCode	Il codice diagnostico fornito dal Message Transfer Agent ricevente (MTA).

Oggetto sottoscrizione

L'JSONoggetto che contiene informazioni su un Subscription evento ha i seguenti campi.

Nome campo	Descrizione
contactList	Il nome dell’elenco in cui si trova il contatto.
timestamp	La data e l'ora, in formato ISO86 01 (YYYY-MM-:MM:SS.sz DDThh), in cui è stata inviata la notifica di sottoscrizione. ISP
source	L'indirizzo e-mail da cui è stato inviato il messaggio (l'indirizzo della busta). MAIL FROM
newTopicPreferences	Una JSON struttura di dati (mappa) che specifica lo stato dell'iscrizione di tutti gli argomenti nell'elenco dei contatti, indicando lo stato dopo una modifica (contatto iscritto o annullato).
oldTopicPreferences	Una JSON struttura di dati (mappa) che specifica lo stato dell'iscrizione di tutti gli argomenti nell'elenco dei contatti indicando lo stato prima della modifica (contatto sottoscritto o annullato).

Preferenze per argomento nuovo/vecchio

Gli oggetti newTopicPreferences e oldTopicPreferences includono i seguenti valori.

Nome campo	Descrizione
unsubscribeAll	Specifica se il contatto ha annullato la sottoscrizione a tutti gli argomenti dell'elenco dei contatti.
topicSubscriptionStatus	Specifica lo stato di sottoscrizione dell'argomento nel topicName campo indicando se è attualmente sottoscritto per ricevere notifiche per il tipo di evento specificato. SES I valori possibili sono OptIn(sottoscritto) o OptOut(annullato) nel campo. subscriptionStatus
topicDefaultSubscriptionStatus	Specifica lo stato di sottoscrizione predefinito dell'argomento nel topicName campo, determinando se i nuovi argomenti aggiunti alla destinazione dell'evento verranno sottoscritti o annullati per impostazione predefinita. I valori possibili sono OptIn(sottoscritto per impostazione predefinita) o OptOut(annullata l'iscrizione per impostazione predefinita) nel campo. subscriptionStatus