Beispiele für E-Mail-Ereignisse E-Mail-Ereignisattribute

E-Mail-Ereignisdatenstream von Amazon Pinpoint

Wenn Sie Amazon Pinpoint zum Senden von E-Mails verwenden, kann Amazon Pinpoint Ereignisdaten zu diesen E-Mails streamen. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint Ihre Veranstaltungsdaten von dem Ziel ab, das Sie bei der Einrichtung angegeben haben, damit Sie sie sich ansehen können. Informationen zum Einrichten des Event-Streamings finden Sie unter. Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen Amazon Pinpoint streamt Daten über die folgenden Ereignistypen für E-Mail-Nachrichten:

Sends (Sendevorgänge)
Deliveries (Zustellungen)
Unzustellbarkeit
Complaints (Beschwerden)
Opens (Öffnungsvorgänge)
Clicks (Klickvorgänge)
Ablehnungen
Abbestellungen
Rendering failures (Rendern von Fehlern)

Diese Ereignistypen werden unter ausführlich E-Mail-Ereignisattribute erklärt.

Abhängig von den API Einstellungen, die Sie zum Senden von E-Mail-Nachrichten verwenden, werden möglicherweise zusätzliche Ereignistypen oder andere Daten angezeigt. Wenn Sie beispielsweise Nachrichten mithilfe von Konfigurationssätzen senden, die Ereignisdaten in Amazon Kinesis veröffentlichen, wie sie beispielsweise von Amazon Simple Email Service (AmazonSES) bereitgestellt werden, können die Daten auch Ereignisse für Fehler beim Rendern von Vorlagen enthalten. Informationen zu diesen Daten finden Sie unter Monitoring using Amazon SES Event Publishing im Amazon Simple Email Service Developer Guide. Bevor Sie Ihre Ereignisse ansehen können, müssen Sie das Event-Streaming einrichten, siehe Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen . Beim Einrichten des Event-Streamings geben Sie ein Ziel an, an dem Ihre Veranstaltungsdaten gespeichert werden sollen. Anschließend können Sie das Ziel verwenden, um Ihre Veranstaltungsdaten zur Ansicht abzurufen.

Beispiele für E-Mail-Ereignisse

E-Mail-Sendevorgang

Das JSON Objekt für ein E-Mail-Sendeereignis enthält die im folgenden Beispiel gezeigten Daten.


{
  "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": {}
      }
    }
  }
}

E-Mail zugestellt

Das JSON Objekt für ein Ereignis, das per E-Mail zugestellt wurde, enthält die im folgenden Beispiel gezeigten Daten.


{
  "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
        }
      }
    }
  }
}

E-Mail-Klick

Das JSON Objekt für ein E-Mail-Klickereignis enthält die im folgenden Beispiel gezeigten Daten.


{
  "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/"
        }
      }
    }
  }
}

E-Mail-Öffnungsvorgang

Das JSON Objekt für ein E-Mail-Öffnungsereignis enthält die im folgenden Beispiel gezeigten Daten.


{
  "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)"
        }
      }
    }
  }
}

E-Mail-Ereignisattribute

In diesem Abschnitt werden die Attribute definiert, die im vorherigen Beispiel für die Event-Stream-Daten enthalten sind, die Amazon Pinpoint generiert, wenn Sie E-Mail-Nachrichten senden.

Attribut	Beschreibung
`event_type`	Der Ereignistyp. Die möglichen Werte sind: _email.send: Amazon Pinpoint hat die Nachricht akzeptiert und versucht, sie dem Empfänger zuzustellen. _email.delivered: Die Nachricht wurde an den Empfänger zugestellt. _email.rejected: Amazon Pinpoint hat festgestellt, dass die Nachricht Malware enthält, und versucht nicht, sie zu versenden. _email.hardbounce: Ein permanentes Problem hinderte Amazon Pinpoint daran, die Nachricht zuzustellen. Amazon Pinpoint wird nicht erneut versuchen, die Nachricht zuzustellen. _email.softbounce: Ein temporäres Problem hinderte Amazon Pinpoint daran, die Nachricht zuzustellen. Amazon Pinpoint wird eine Zeit lang versuchen, die Nachricht erneut zuzustellen. Wenn die Nachricht immer noch nicht zugestellt werden kann, werden keine weiteren Versuche unternommen. Der endgültige Status der E-Mail wird dann sein. SOFTBOUNCE _email.complaint: Der Empfänger hat die Nachricht erhalten und sie anschließend bei seinem E-Mail-Anbieter als Spam gemeldet (z. B. mithilfe des Features „Spam melden“ des E-Mail-Clients) _email.open: Der Empfänger hat die Nachricht erhalten und sie in einem E-Mail-Client geöffnet. _email.click: Der Empfänger hat die Nachricht erhalten und auf einen darin enthaltenen Link geklickt. _email.unsubscribe: Der Empfänger hat die Nachricht erhalten und auf einen darin Link zum Beenden des Abonnements geklickt. _email.rendering_failure: Die E-Mail wurde aufgrund eines Rendering-Fehlers nicht gesendet. Dies kann auftreten, wenn Vorlagendaten fehlen oder die Vorlagenparameter nicht mit den Daten übereinstimmen.
`event_timestamp`	Die Uhrzeit, zu der die Nachricht gesendet wurde, wird als Unix-Zeit in Millisekunden angezeigt. Dieser Wert ist in der Regel für alle Ereignisse identisch, die für eine Nachricht generiert werden.
`arrival_timestamp`	De Zeitpunkt, zu dem das Ereignis von Amazon Pinpoint empfangen wurde, angezeigt als Unix-Zeit in Millisekunden.
`event_version`	Die Version des JSON Ereignisschemas. Tipp Prüfen Sie diese Version in der Anwendung, mit der Ihr Ereignis verarbeitet wird, damit Sie wissen, wann die Anwendung infolge eines Schema-Updates aktualisiert werden soll.
`application`	Informationen über das Amazon-Pinpoint-Projekt, das dem Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle Application (Anwendung) .
`client`	Informationen zum App-Client, der auf dem Gerät installiert ist, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle Client.
`device`	Informationen über das Gerät, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle Device (Gerät). Bei E-Mail-Ereignissen ist dieses Objekt leer.
`session`	Bei E-Mail-Ereignissen ist dieses Objekt leer.
`attributes`	Attribute, die dem Ereignis zugeordnet sind. Weitere Informationen finden Sie in der Tabelle Attributes (Attribute). Bei Ereignissen, die von einer Ihrer Apps gemeldet werden, kann dieses Objekt benutzerdefinierte Attribute enthalten, die von der App definiert werden. Bei Ereignissen, die beim Senden einer Nachricht aus einer Kampagne oder Journey erstellt werden, enthält dieses Objekt Attribute, die der Kampagne oder Journey zugeordnet sind. Bei Ereignissen, die generiert werden, wenn Sie Transaktionsnachrichten senden, enthält dieses Objekt Informationen, die sich auf die Nachricht selbst beziehen.
`client_context`	Bei E-Mail-Ereignissen enthält dieses Objekt ein `custom`-Objekt, das ein `legacy_identifier` Attribut enthält. Der Wert für das `legacy_identifier`-Attribut ist die ID des Projekts, von dem die Nachricht gesendet wurde.
`facets`	Zusätzliche Informationen über die Nachricht, z. B. die E-Mail-Header. Weitere Informationen finden Sie in der Tabelle Facets.
`awsAccountId`	Die ID des AWS Kontos, das zum Senden der Nachricht verwendet wurde.

Anwendung

Enthält Informationen über das Amazon Pinpoint-Projekt, dem das Ereignis zugeordnet ist.

Attribut	Beschreibung
`app_id`	Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat.
`sdk`	DieSDK, die verwendet wurde, um das Ereignis zu melden. Wenn Sie eine Transaktions-E-Mail-Nachricht senden, indem Sie Amazon Pinpoint API direkt anrufen oder die Amazon Pinpoint Pinpoint-Konsole verwenden, ist dieses Objekt leer.

Attribute

Enthält Informationen über die Kampagne oder Journey, die das Ereignis generiert hat.

Kampagne

Enthält Informationen über die Kampagne, die das Ereignis generiert hat.

Attribut	Beschreibung
`feedback`	Bei `_email.click` Ereignissen entspricht der Wert für dieses Attribut dem Link, auf den URL der Empfänger in der Nachricht geklickt hat, um das Ereignis zu generieren. Bei anderen Ereignissen stellt dieser Wert den Ereignistyp dar (z. B. `received`, `opened` oder `clicked`).
`treatment_id`	Wenn die Nachricht mit einer A/B-Testkampagne gesendet wurde, stellt dieser Wert die Behandlungsnummer der Nachricht dar. Für Standardkampagnen und Transaktions-E-Mail-Nachrichten ist dieser Wert `0`.
`campaign_activity_id`	Die eindeutige ID, die Amazon Pinpoint generiert, wenn das Ereignis eintritt.
`campaign_id`	Die eindeutige ID der Kampagne, die die Nachricht gesendet hat.

Journey

Enthält Informationen über die Journey, die das Ereignis generiert hat.

Attribut	Beschreibung
`journey_run_id`	Die eindeutige ID des Journeylaufs, der die Nachricht gesendet hat. Amazon Pinpoint generiert diese ID automatisch und weist sie jedem neuen Lauf einer Journey zu.
`feedback`	Bei `_email.click` Ereignissen entspricht der Wert für dieses Attribut dem Link, auf den URL der Empfänger in der Nachricht geklickt hat, um das Ereignis zu generieren. Bei anderen Ereignissen stellt dieser Wert den Ereignistyp dar (z. B. `received`, `delivered` oder `opened`).
`journey_id`	Die eindeutige ID der Journey, die die Nachricht gesendet hat.
`journey_activity_id`	Die eindeutige ID der Journey-Aktivität, die die Nachricht gesendet hat.

Client

Die eindeutige Kennung des Kunden, auf den die Kampagne oder Journey abzielte.

Attribut	Beschreibung
`client_id`	Die Client-ID Der Wert ist die Endpunkt-ID für Kampagnen und Journeys, und für transaktionales Senden ist es a. UUID

Enthält Informationen zur Nachricht und zum Ereignistyp.

Attribut	Beschreibung
`email_channel`	Enthält ein Objekt `mail_event`, das zwei Objekte enthält: `mail` und ein Objekt, das dem Ereignistyp entspricht.

Mail

Enthält Informationen über den Inhalt der E-Mail-Nachricht sowie Metadaten zu der Nachricht.

Attribut	Beschreibung
`message_id`	Die eindeutige ID der Nachricht. Amazon Pinpoint generiert diese ID automatisch, wenn es die Nachricht akzeptiert.
`message_send_timestamp`	Datum und Uhrzeit des Versands der Nachricht in dem in 822 angegebenen Format. RFC
`from_address`	Die E-Mail-Adresse, von der die Nachricht gesendet wurde.
`destination`	Ein Array mit den E-Mail-Adressen, an die die Nachricht gesendet wurde.
`headers_truncated`	Ein boolescher Wert, der angibt, ob die E-Mail-Header abgeschnitten wurden.
`headers`	Ein Objekt, das mehrere Name-Wert-Paare enthält, die den Headern in der Nachricht entsprechen. Dieses Objekt enthält in der Regel Informationen zu den folgenden Headern: `From`: Die E-Mail-Adresse des Absenders. `To`: Die E-Mail-Adresse des Empfängers. `Subject`: Die Betreffzeile der E-Mail. Tipp Der Betreff-Header ist bei campaign _email.send-Ereignissen nicht enthalten. `MIME-Version`— Zeigt an, dass die Nachricht im MIME Format vorliegt. Wenn dieser Header vorhanden ist, lautet der Wert immer `1.0`. `Content-Type`— Der MIME Medientyp des Nachrichteninhalts.
`common_headers`	Enthält Informationen zu verschiedenen allgemeinen Kopfzeilen für E-Mail-Nachrichten. Die Informationen können das Datum, an dem die Nachricht gesendet wurde, sowie die Zeilen „An“, „Von“ und „Betreff“ der Nachricht enthalten.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Reiseereignisdaten von Amazon Pinpoint

SMSEreignisdatenstrom von Amazon Pinpoint