Eventi e-mail - Amazon Pinpoint
Eventi di esempioAttributi di eventi e-mail

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:

  • _email.send: Amazon Pinpoint ha accettato il messaggio e ha tentato di recapitarlo al destinatario.

  • _email.delivered: il messaggio è stato recapitato al destinatario.

  • _email.rejected: Amazon Pinpoint ha stabilito che il messaggio contiene malware e non ha tentato di inviarlo.

  • _email.hardbounce: un problema permanente ha impedito ad Amazon Pinpoint di recapitare il messaggio. Amazon Pinpoint non tenterà più di recapitare il messaggio.

  • _email.softbounce: un problema temporaneo ha impedito ad Amazon Pinpoint di recapitare il messaggio. Amazon Pinpoint tenterà di recapitare nuovamente il messaggio per un certo periodo di tempo. Se il messaggio continua a non essere recapitato, non verrà effettuato alcun altro tentativo. Lo stato finale dell'e-mail sarà quindiSOFTBOUNCE.

  • _email.complaint: il destinatario ha ricevuto il messaggio e lo ha segnalato al proprio provider e-mail come spam (ad esempio, utilizzando la funzionalità "Segnala come spam" del client e-mail).

  • _email.open: il destinatario ha ricevuto il messaggio e lo ha aperto.

  • _email.click: il destinatario ha ricevuto il messaggio e ha fatto clic su un collegamento al suo interno.

  • _email.unsubscribe: il destinatario ha ricevuto il messaggio e ha fatto clic su un collegamento per l'annullamento della sottoscrizione al suo interno.

  • _email.rendering_failure: l'e-mail non è stata inviata a causa di un errore di rendering. Ciò può verificarsi se i dati del modello mancano o se non vi è corrispondenza tra i parametri e i dati del modello.
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.

Suggerimento

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_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 _email.click gli eventi, il valore URL di questo attributo è il link su cui il destinatario ha fatto clic nel messaggio per generare l'evento. Per gli altri eventi, questo valore rappresenta il tipo di evento, ad esempio received, opened o clicked.
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 è 0.
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 _email.click gli eventi, il valore URL di questo attributo è il link su cui il destinatario ha fatto clic nel messaggio per generare l'evento. Per gli altri eventi, questo valore rappresenta il tipo di evento, ad esempio received, delivered o opened.
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 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_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:

  • From: indirizzo e-mail del mittente.

  • To: indirizzo e-mail del destinatario.

  • Subject: riga dell’oggetto dell’e-mail.

    Suggerimento

    L'intestazione dell'oggetto non è inclusa per gli eventi _email.send della campagna.

  • MIME-Version— Indica che il messaggio è in MIME formato. Se questa intestazione è presente, il valore è sempre 1.0.

  • Content-Type— Il tipo di MIME supporto del contenuto del messaggio.
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.