Monitoraggio dell'invio di e-mail utilizzando la pubblicazione di eventi di Amazon SES

Per consentirti di tracciare l'invio di e-mail a livello granulare, puoi configurare Amazon SES per pubblicare eventi di invio e-mail su Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint o Amazon Simple Notification Service in base a caratteristiche da te definite.

Puoi tenere traccia di diversi tipi di eventi di invio di e-mail, inclusi gli invii, le consegne, le aperture, i clic, i mancati recapiti, i reclami, i rifiuti, gli errori di rendering e i ritardi di consegna. Queste informazioni possono essere utili a fini operativi e analitici. Ad esempio, puoi pubblicare i dati di invio di e-mail CloudWatch e creare dashboard che tengono traccia delle prestazioni delle tue campagne e-mail oppure puoi utilizzare Amazon SNS per inviarti notifiche quando si verificano determinati eventi.

Come funziona la pubblicazione degli eventi con i set di configurazione e i tag dei messaggi

Per utilizzare la pubblicazione degli eventi, devi prima impostare uno o più set di configurazione. Un set di configurazione specifica dove pubblicare i tuoi eventi e quali pubblicare. Quindi, ogni volta che invii un'e-mail, devi fornire il nome del set di configurazione e uno o più tag di messaggio, sotto forma di coppie nome/valore, per classificare l'e-mail. Ad esempio, se pubblicizzi libri, puoi denominare un tag di messaggio genere e assegnare il valore fantascienza o western quando invii un'e-mail per la campagna associata.

A seconda dell'interfaccia di invio e-mail utilizzata, è possibile fornire il tag del messaggio come parametro al EmailTagscampo dell'operazione SendEmailAPI o aggiungere il tag del messaggio all'intestazione dell'e-mail specifica per SES. X-SES-MESSAGE-TAGS Per ulteriori informazioni sui set di configurazione, consulta Utilizzo dei set di configurazione in Amazon SES.

Oltre ai tag di messaggio specificati da te, Amazon SES aggiunge tag automatici ai messaggi inviati. Non è necessario eseguire operazioni aggiuntive per utilizzare i tag automatici.

La tabella seguente elenca i tag automatici che vengono automaticamente applicati ai messaggi inviati tramite Amazon SES.

Tag automatici Amazon SES
Nome tag automatico	Descrizione
ses:caller-identity	L'identità IAM dell'utente di Amazon SES che ha inviato l'e-mail.
ses:configuration-set	Il nome del set di configurazione associato all'email.
ses:from-domain	Il dominio dell'indirizzo del mittente.
ses:outgoing-ip	L'indirizzo IP che Amazon SES ha utilizzato per inviare l'e-mail.
ses:source-ip	L'indirizzo IP che l'intermediario ha utilizzato per inviare l'e-mail.
ses:source-tls-version	La versione del protocollo TLS utilizzata dal chiamante per inviare l'e-mail.

Feedback dettagliato per le campagne e-mail

Il ses:feedback-id-<a or b> tag è un tag di messaggio opzionale che puoi considerare un tag ibrido o semiautomatico: sebbene sia simile ai tag automatici discussi nella sezione precedente, la differenza è che devi aggiungerlo manualmente e utilizzare la chiave prefisso. ses: Puoi utilizzare fino a due di questi tag, definiti come e. ses:feedback-id-a ses:feedback-id-b

Quando si specificano questi tag, SES li aggiunge automaticamente all'Feedback-IDintestazione standard utilizzata per fornire statistiche sulla consegna, come le percentuali di reclami e spam, nell'ambito di un ciclo di feedback (FBL), vedi. Circuiti di feedback L'Feedback-IDintestazione comprende l'identificatore SESInternalID, utilizzato da SES per raccogliere informazioni sui reclami, e il tag statico, AmazonSES, che identifica SES come piattaforma di invio, ad esempio:

FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))

Questi tag ID di feedback opzionali consentono di generare feedback dettagliati, ad esempio per i messaggi inviati nell'ambito di una campagna e-mail. È possibile utilizzarlo ses:feedback-id-<a or b> specificandolo come tag del messaggio nel EmailTagscampo della richiesta di SendEmailoperazione, come mostrato nell'esempio seguente:

{
  "FromEmailAddress": "[e-mail]",
  "Destination": {
    "ToAddresses": [
      "[e-mail]"
    ]
  },
  "Content": {
    "Simple": {
      "Subject": {
        "Data": "Hello and welcome"
      },
      "Body": {
        "Text": {
          "Data": "Lorem ipsum dolor sit amet."
        },
        "Html": {
          "Data": "Lorem ipsum dolor sit amet."
        }
      }
    }
  },
  "EmailTags": [
    {
      "Name": "ses:feedback-id-a",
      "Value": "new-members-campaign"
    },
    {
      "Name": "ses:feedback-id-b",
      "Value": "football-campaign"
    }
  ],
  "ConfigurationSetName": "football-club"
}

Se si invia in formato raw, è necessario aggiungerlo ses:feedback-id-<a or b> come tag del messaggio all'intestazione specifica di SES. X-SES-MESSAGE-TAGS

Il tag del ses:feedback-id-<a or b> messaggio può anche essere monitorato in Amazon CloudWatch specificandolo come fonte di CloudWatch valore proprio come qualsiasi altro tag di messaggio, vedi Aggiunta di una destinazione degli eventi CloudWatch (Si applicano costi aggiuntivi, vedi Prezzo per metrica per). CloudWatch

Utilizzo della pubblicazione degli eventi

Le sezioni seguenti contengono le informazioni necessarie per configurare e utilizzare la pubblicazione degli eventi Amazon SES.

• Impostazione della pubblicazione di eventi

• Utilizzo dei dati degli eventi

Terminologia relativa alla pubblicazione degli eventi

L'elenco seguente definisce i termini correlati alla pubblicazione degli eventi Amazon SES.

Evento di invio di e-mail

Informazioni associate all'esito di un invio di un'e-mail ad Amazon SES. Gli eventi di invio includono quanto segue:

• Send (Invio): la richiesta di invio è stata completata e Amazon SES tenterà la consegna del messaggio al server di posta del destinatario. Se viene utilizzata l'eliminazione globale o a livello di account, SES la conteggia comunque come invio, ma la consegna viene eliminata.

• RenderingFailure— L'e-mail non è stata inviata a causa di un problema di visualizzazione del modello. Questo tipo di evento può verificarsi se i dati del modello mancano o se non vi è corrispondenza tra i parametri e i dati del modello. Questo tipo di evento si verifica solo quando invii un'e-mail basata su modello utilizzando le operazioni API SendTemplatedEmail o SendBulkTemplatedEmail.

• Reject (Rifiuta): Amazon SES ha accettato l'e-mail, ma ha stabilito che conteneva un virus e non ha tentato di consegnarla al server di posta del destinatario.

• Delivery (Consegna): Amazon SES ha consegnato correttamente l'e-mail al server di posta del destinatario.

• Mancato recapito: un mancato recapito permanente indica che il server di posta del destinatario ha rifiutato l'e-mail in modo permanente. (I soft bounce sono inclusi solo quando SES non tenta più di recapitare l'e-mail. Generalmente questi soft bounce indicano un errore di recapito, anche se in alcuni casi il soft bounce può essere restituito anche quando l'e-mail raggiunge correttamente la casella di posta del destinatario. Ciò si verifica in genere quando il destinatario invia una risposta automatica. out-of-office Scopri di più sui soft bounce in questo articolo di AWS Re:POST.)

• Complaint (Reclamo): l'e-mail è stata recapitata correttamente al server di posta del destinatario, ma il destinatario l'ha contrassegnata come spam.

• DeliveryDelay— Non è stato possibile recapitare l'e-mail al server di posta del destinatario a causa di un problema temporaneo. I ritardi di consegna possono verificarsi, ad esempio quando la casella di posta in arrivo del destinatario è piena o quando nel server di ricezione della posta elettronica si verifica un problema transitorio.

• Subscription (Sottoscrizione): l'e-mail è stata recapitata correttamente, ma il destinatario ha aggiornato le preferenze di sottoscrizione facendo clic su List-Unsubscribe nell'intestazione dell'email o sul collegamento Unsubscribe nel piè di pagina.

• Open (Apri): il destinatario ha ricevuto il messaggio e lo ha aperto nel proprio client e-mail.

• Click (Clic): il destinatario ha fatto clic su uno o più collegamenti contenuti nell'e-mail.

Set di configurazione

Un insieme di regole che definisce la destinazione in cui Amazon SES pubblica gli eventi di invio e-mail e i tipi di eventi di invio e-mail che desideri pubblicare. Quando invii un'e-mail che desideri utilizzare con la pubblicazione degli eventi, devi specificare il set di configurazione da associare all'e-mail.

Destinazione di evento

Un AWS servizio su cui pubblicare eventi di invio e-mail di Amazon SES. Ogni destinazione impostata appartiene a un solo set di configurazione.

Tag di messaggio

Una coppia nome/valore utilizzata per classificare un'e-mail a scopo di pubblicazione degli eventi. Alcuni esempi sono campagna/libro e campagna/abbigliamento. Quando invii un'e-mail, puoi specificare il tag di messaggio come parametro per la chiamata API o come intestazione e-mail specifica di Amazon SES.

Tag automatico

Tag di messaggio che vengono automaticamente inclusi nei report di pubblicazione degli eventi. È disponibile un tag automatico per il nome del set di configurazione, il dominio dell'indirizzo "Da", l'indirizzo IP in uscita del chiamante, l'indirizzo IP in uscita di Amazon SES, e l'identità IAM del chiamante.