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

# Contenuto dei dati degli eventi pubblicati da Amazon SES su Amazon SNS
<a name="event-publishing-retrieving-sns-contents"></a>

Amazon SES pubblica i record degli eventi di invio di e-mail in Amazon Simple Notification Service in formato JSON.

È possibile trovare record di esempio per tutti questi tipi di notifica in [Esempi di dati degli eventi pubblicati da Amazon SES su Amazon SNS](event-publishing-retrieving-sns-examples.md).

**Topics**
+ [Top-level oggetto JSON](#event-publishing-retrieving-sns-contents-top-level-json-object)
+ [Oggetto mail](#event-publishing-retrieving-sns-contents-mail-object)
+ [Oggetto del mancato recapito](#event-publishing-retrieving-sns-contents-bounce-object)
+ [Oggetto del reclamo](#event-publishing-retrieving-sns-contents-complaint-object)
+ [Oggetto di consegna](#event-publishing-retrieving-sns-contents-delivery-object)
+ [Oggetto send](#event-publishing-retrieving-sns-contents-send-object)
+ [Oggetto reject](#event-publishing-retrieving-sns-contents-reject-object)
+ [Oggetto open](#event-publishing-retrieving-sns-contents-open-object)
+ [Oggetto click](#event-publishing-retrieving-sns-contents-click-object)
+ [Oggetto errore di rendering](#event-publishing-retrieving-sns-contents-failure-object)
+ [DeliveryDelay oggetto](#event-publishing-retrieving-sns-contents-delivery-delay-object)
+ [Oggetto sottoscrizione](#event-publishing-retrieving-sns-contents-subscription-object)

## Top-level oggetto JSON
<a name="event-publishing-retrieving-sns-contents-top-level-json-object"></a>

L'oggetto JSON di primo livello in un record degli eventi di invio di e-mail contiene i campi riportati di seguito. Il tipo di evento determina quali altri oggetti sono presenti.


| Nome campo | Description | 
| --- | --- | 
| `eventType` | Una stringa che descrive il tipo di evento. Valori possibili: `Bounce`, `Complaint`, `Delivery`, `Send`, `Reject`, `Open`, `Click`, `Rendering Failure`, `DeliveryDelay` o `Subscription`.<br />Se non hai [configurato la pubblicazione di eventi](monitor-sending-using-event-publishing-setup.md), questo campo è denominato `notificationType`. | 
| `mail` | Un oggetto JSON che contiene informazioni sull'e-mail che ha generato 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
<a name="event-publishing-retrieving-sns-contents-mail-object"></a>

Ogni record di eventi di invio di e-mail contiene informazioni sull'e-mail originale nell'oggetto `mail`. L'oggetto JSON che contiene informazioni su un oggetto `mail` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `timestamp` | La data e l'ora, in formato ISO8601 (*YYYY-MM-DDThh:mm:ss.sZ*), di invio del messaggio. | 
| `messageId` | Un ID univoco che Amazon SES ha assegnato al messaggio. Amazon SES ti ha restituito questo valore quando hai inviato il messaggio. Questo è l'ID messaggio assegnato da Amazon SES. Puoi trovare l'ID messaggio dell'e-mail originale nei campi `headers` e `commonHeaders` dell'oggetto `mail`.  | 
| `source` | L'indirizzo e-mail da cui il messaggio è stato inviato (indirizzo MAIL FROM della busta). | 
| `sourceArn` | L'Amazon Resource Name (ARN) dell'identità utilizzata per inviare l'e-mail. Nel caso di autorizzazione all'invio, `sourceArn` è l'ARN dell'identità che il mittente delegato è stato autorizzato a utilizzare dal proprietario dell'identità per inviare l'e-mail. Per ulteriori informazioni sull'autorizzazione all'invio, consulta [Metodi di autenticazione delle e-mailUso dell'autorizzazione di invio](sending-authorization.md). | 
| `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`. L'ID messaggio nel campo `headers` deriva dal messaggio originale passato ad Amazon SES. L'ID messaggio che Amazon SES ha successivamente assegnato al messaggio si trova nel campo `messageId` dell'oggetto `mail`.  | 
| `commonHeaders` | Una mappatura delle intestazioni originali, di uso frequente, dell'e-mail. Qualsiasi ID messaggio all’interno del campo `commonHeaders` è quello che Amazon SES ha successivamente assegnato al messaggio nel campo `messageId` dell'oggetto `mail`.  | 
| `tags` | Un elenco di tag associati all'e-mail. | 

## Oggetto del mancato recapito
<a name="event-publishing-retrieving-sns-contents-bounce-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Bounce` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `bounceType` | Il tipo di mancato recapito secondo Amazon SES. | 
| `bounceSubType` | Il sottotipo di mancato recapito secondo Amazon SES. | 
| `bouncedRecipients` | Elenco che contiene informazioni sui destinatari della posta originale che non è stata recapitata. | 
| `timestamp` | La data e l'ora, in formato ISO8601 (*YYYY-MM-DDThh:mm:ss.sZ*), in cui l'ISP ha inviato la notifica di rimbalzo. | 
| `feedbackId` | Un ID univoco per il mancato recapito. | 
| `reportingMTA` | Il valore del campo `Reporting-MTA` nella notifica sullo stato del recapito. Questo è il valore dell'autorità MTA (Message Transfer Authority) che ha tentato di eseguire l'operazione di consegna, inoltro o gateway descritta nella notifica. Il campo è visualizzato solo se alla mancata consegna è allegata una notifica sullo stato del recapito (DSN).  | 

### Destinatari del mancato recapito
<a name="event-publishing-retrieving-sns-contents-bounced-recipients"></a>

Un evento di mancato recapito può riguardare uno o più destinatari. Il campo `bouncedRecipients` include il campo seguente e un elenco di oggetti, uno per ogni destinatario il cui indirizzo e-mail ha prodotto un mancato recapito.


| Nome campo | Description | 
| --- | --- | 
| `emailAddress` | L'indirizzo e-mail del destinatario. Se è disponibile una notifica sullo stato di consegna, questo è il valore del campo `Final-Recipient` della notifica. | 

Opzionalmente, se una notifica sullo stato di consegna è allegata al mancato recapito, possono essere presenti anche i campi seguenti.


| Nome campo | Description | 
| --- | --- | 
| `action` | Il valore del campo `Action` nella notifica sullo stato del recapito. Indica l'operazione eseguita dall'autorità MTA interessata come risultato del tentativo di recapitare il messaggio a questo destinatario. | 
| `status` | Il valore del campo `Status` nella notifica sullo stato del recapito. 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 dall'autorità MTA interessata. Si tratta del valore del campo `Diagnostic-Code` nella notifica sullo stato di consegna. Il campo potrebbe non essere incluso in questa notifica, quindi nemmeno nell'oggetto JSON. | 

### Tipi di mancato recapito
<a name="event-publishing-retrieving-sns-contents-bounce-types"></a>

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

Il sistema di pubblicazione degli eventi pubblica solo gli hard bounce e i soft bounce che non verranno più ritentati da Amazon SES. Quando ricevi dei mancati recapiti contrassegnati come `Permanent`, devi rimuovere i corrispondenti indirizzi e-mail dalla tua mailing list; non sarai in grado di inviare loro dei messaggi in futuro. I mancati recapiti di tipo `Transient` vengono inviati quando si verificano più soft bounce per il messaggio e Amazon SES ha smesso di tentare di consegnarli nuovamente. In futuro, potresti riuscire nuovamente a inviare messaggi a un indirizzo che inizialmente ha generato un mancato recapito `Transient`.


| bounceType | rimbalzo SubType | Description | 
| --- | --- | --- | 
| `Undetermined` | `Undetermined` | Amazon SES non è stato in grado di determinare un motivo specifico per il mancato recapito. | 
| `Permanent` | `General` | Amazon SES ha ricevuto un mancato recapito permanente 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 mancato recapito 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 non invia più a questo indirizzo perché ha una storia recente di mancati recapiti come indirizzo non valido. Per sovrascrivere l'elenco di eliminazione globale, consulta [Utilizzo dell'elenco di eliminazione a livello di account di Amazon SES](sending-email-suppression-list.md).  | 
| Permanent | OnAccountSuppressionList | Amazon SES ha soppresso l'invio a questo indirizzo perché si trova [nell'elenco di eliminazione a livello di account](sending-email-suppression-list.md). Ciò non influisce sulla metrica relativa alla frequenza dei mancati recapiti. | 
| Permanent | EmailValidationSuppressed | Amazon SES ha sospeso l'invio a questo indirizzo perché l'indirizzo non soddisfaceva la soglia per le impostazioni di [convalida delle e-mail](email-validation-auto.md). | 
| `Transient` | `General` | Amazon SES ha ricevuto un mancato recapito generale. È possibile che riesca a inviare messaggi a questo destinatario in futuro. | 
| `Transient` | `MailboxFull` | Amazon SES ha ricevuto un mancato recapito per casella di posta piena. È possibile che riesca a inviare messaggi a questo destinatario in futuro. | 
| `Transient` | `MessageTooLarge` | Amazon SES ha ricevuto un mancato recapito per messaggio troppo grande. Potresti riuscire a inviare il messaggio al destinatario riducendo le dimensioni. | 
| `Transient` | `CustomTimeoutExceeded` | Amazon SES non è riuscito a recapitare correttamente l'e-mail entro il tempo specificato dal mittente dell'e-mail. *(Il messaggio di rimbalzo specificherà il motivo di eventuali tentativi di consegna falliti all'interno del TTL definito.)*  | 
| `Transient` | `ContentRejected` | Amazon SES ha ricevuto un mancato recapito per contenuti rifiutati. Potresti riuscire a inviare il messaggio al destinatario modificandone il contenuto. | 
| `Transient` | `AttachmentRejected` | Amazon SES ha ricevuto un mancato recapito per allegato rifiutato. Potresti riuscire a inviare il messaggio al destinatario rimuovendo o modificando l'allegato. | 

## Oggetto del reclamo
<a name="event-publishing-retrieving-sns-contents-complaint-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Complaint` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `complainedRecipients` | Un elenco che contiene informazioni sui destinatari che potrebbero avere inviato il reclamo. | 
| `timestamp` | La data e l'ora, in formato ISO8601 (*YYYY-MM-DDThh:mm:ss.sZ*), in cui l'ISP ha inviato la notifica del reclamo. | 
| `feedbackId` | Un ID univoco per il reclamo. | 
| `complaintSubType` | Il sottotipo del reclamo, come determinato da Amazon SES. | 

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


| Nome campo | Description | 
| --- | --- | 
| `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 campo `Feedback-Type` nel report di feedback ricevuto dall'ISP. Contiene il tipo di feedback. | 
| `arrivalDate` | Il valore del `Received-Date` campo `Arrival-Date` o del rapporto di feedback in formato ISO8601 (). *YYYY-MM-DDThh:mm:ss.sZ* Il campo potrebbe non essere incluso nel report, quindi nemmeno nell'oggetto JSON. | 

### Destinatari che hanno inviato il reclamo
<a name="event-publishing-retrieving-sns-contents-complained-recipients"></a>

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

**Importante**  
La maggior parte degli ISP omette gli indirizzi e-mail dei destinatari che hanno inviato reclami. Per questo motivo, il campo `complainedRecipients` include un elenco di tutti gli utenti a cui è stata inviata l'e-mail e il cui indirizzo è nel dominio che ha emesso la notifica di reclamo.

Gli oggetti JSON in questo elenco contengono il campo seguente.


| Nome campo | Description | 
| --- | --- | 
| `emailAddress` | L'indirizzo e-mail del destinatario. | 

### Tipi di reclamo
<a name="event-publishing-retrieving-sns-contents-complaint-types"></a>

Puoi visualizzare i tipi di reclamo seguenti nel campo `complaintFeedbackType`, assegnati dall'ISP che effettua la segnalazione, secondo il [sito Web IANA (Internet Assigned Numbers Authority)](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2):


| Nome campo | Description | 
| --- | --- | 
| `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. | 

### Sottotipi di reclami
<a name="event-publishing-retrieving-sns-contents-complaint-subtypes"></a>

Il valore del campo `complaintSubType` può essere null o `OnAccountSuppressionList`. Se il valore è `OnAccountSuppressionList`, Amazon SES ha accettato il messaggio, ma non ha tentato di inviarlo perché presente [nell'elenco di eliminazione a livello di account](sending-email-suppression-list.md).

## Oggetto di consegna
<a name="event-publishing-retrieving-sns-contents-delivery-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Delivery` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `timestamp` | La data e l'ora in cui Amazon SES ha inviato l'e-mail al server di posta del destinatario, in formato ISO8601 () *YYYY-MM-DDThh:mm:ss.sZ*. | 
| `processingTimeMillis` | Il tempo in millisecondi tra quando Amazon SES ha accettato la richiesta del mittente e quando Amazon SES ha trasferito 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 risposta SMTP dell'ISP remoto che ha accettato l'e-mail da Amazon SES. Questo messaggio può variare in base all'e-mail, al server di posta ricevente e all'ISP ricevente. | 
| `reportingMTA` | Il nome host del server di posta Amazon SES che ha inviato l'e-mail. | 
| `remoteMtaIp` | L'indirizzo IP dell'autorità MTA a cui Amazon SES ha consegnato l'e-mail. | 

## Oggetto send
<a name="event-publishing-retrieving-sns-contents-send-object"></a>

L'oggetto JSON che contiene informazioni su un evento `send` è sempre vuoto.

## Oggetto reject
<a name="event-publishing-retrieving-sns-contents-reject-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Reject` include i campi riportati di seguito.


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

## Oggetto open
<a name="event-publishing-retrieving-sns-contents-open-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Open` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `ipAddress` | L'indirizzo IP del destinatario. | 
| `timestamp` | La data e l'ora in cui si è verificato l'evento di apertura nel formato ISO8601 (). *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
<a name="event-publishing-retrieving-sns-contents-click-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Click` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `ipAddress` | L'indirizzo IP del destinatario. | 
| `timestamp` | La data e l'ora in cui si è verificato l'evento click nel formato ISO8601 (). *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` | L'URL del collegamento su cui il destinatario ha fatto clic. | 
| `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?](faqs-metrics.md#sending-metric-faqs-clicks-q5) in [Parametri di invio e-mail di Amazon SES FAQs](faqs-metrics.md). | 

## Oggetto errore di rendering
<a name="event-publishing-retrieving-sns-contents-failure-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Rendering Failure` include i campi riportati di seguito.


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

## DeliveryDelay oggetto
<a name="event-publishing-retrieving-sns-contents-delivery-delay-object"></a>

L'oggetto JSON che contiene informazioni su un evento `DeliveryDelay` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `delayType` | Il tipo di ritardo. I valori possibili sono:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/ses/latest/dg/event-publishing-retrieving-sns-contents.html) | 
| `delayedRecipients` | Oggetto che contiene informazioni sul destinatario del messaggio di posta elettronica. | 
| `expirationTime` | La data e l'ora in cui Amazon SES interrompe il tentativo di recapitare il messaggio. Questo valore è mostrato in formato ISO 8601. | 
| `reportingMTA` | Indirizzo IP dell'agente di trasferimento messaggi (MTA) che ha segnalato il ritardo. | 
| `timestamp` | La data e l'ora in cui si è verificato il ritardo, mostrate in formato ISO 8601. | 

### Destinatari del ritardo di consegna
<a name="event-publishing-retrieving-sns-contents-delivery-delay-object-recipients"></a>

L'oggetto `delayedRecipients` include i seguenti valori.


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

## Oggetto sottoscrizione
<a name="event-publishing-retrieving-sns-contents-subscription-object"></a>

L'oggetto JSON che contiene informazioni su un evento `Subscription` include i campi riportati di seguito.


| Nome campo | Description | 
| --- | --- | 
| `contactList` | Il nome dell’elenco in cui si trova il contatto. | 
| `timestamp` | La data e l'ora, in formato ISO8601 *(YYYY-MM-DDThh:mm:ss.sZ)*, in cui l'ISP ha inviato la notifica di sottoscrizione. | 
| `source` | L'indirizzo e-mail da cui il messaggio è stato inviato (indirizzo MAIL FROM della busta). | 
| `newTopicPreferences` | Una struttura dati JSON (mappa) che specifica lo stato della sottoscrizione di tutti gli argomenti dell'elenco dei contatti che indicano lo stato dopo una modifica (contatto sottoscritto o annullato). | 
| `oldTopicPreferences` | Una struttura dati JSON (mappa) che specifica lo stato della sottoscrizione di tutti gli argomenti dell'elenco dei contatti che indicano lo stato prima della modifica (contatto sottoscritto o annullato). | 

### New/old preferenze relative agli argomenti
<a name="event-publishing-retrieving-sns-contents-subscription-object-topic-preferences"></a>

Gli oggetti `newTopicPreferences` e `oldTopicPreferences` includono i seguenti valori.


| Nome campo | Description | 
| --- | --- | 
| `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 che indica se è attualmente abbonato alla ricezione di notifiche da SES per il tipo di evento specificato. 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` |