Inhalt der Ereignisdaten, die Amazon SES auf Firehose veröffentlicht - Amazon Simple Email Service
JSON-Objekt der obersten Ebenemail-ObjektBounce-ObjektComplaint-ObjektDelivery-ObjektSend-ObjektReject-ObjektOpen-ObjektClick-ObjektRendering Failure-ObjektDeliveryDelay ObjektAbonnementobjekt

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Inhalt der Ereignisdaten, die Amazon SES auf Firehose veröffentlicht

Amazon SES veröffentlicht Aufzeichnungen über E-Mail-Versandereignisse an Amazon Data Firehose im JSON-Format. Bei der Veröffentlichung von Ereignissen in Firehose folgt Amazon SES jedem JSON-Datensatz mit einem Zeilenumbruchzeichen.

Beispieldatensätze für all diese Benachrichtigungstypen finden Sie unter Beispiele für Ereignisdaten, die Amazon SES auf Firehose veröffentlicht.

JSON-Objekt der obersten Ebene

Das JSON-Objekt der obersten Ebene in einem E-Mail-Sendeereignisdatensatz enthält die folgenden Felder.

Feldname Beschreibung

eventType

Eine Zeichenfolge, die die Art des Ereignisses angibt. Mögliche Werte: Bounce, Complaint, Delivery, Send, Reject, Open, Click, Rendering Failure, DeliveryDelay oder Subscription.

Wenn Sie keine Ereignisveröffentlichung einrichten heißt dieses Feld notificationType.

mail

Ein JSON-Objekt, das Informationen über die E-Mail enthält, die das Ereignis hervorgerufen hat.

bounce

Dieses Feld ist nur vorhanden, wenn eventType auf Bounce eingestellt ist. Es enthält Informationen über die Unzustellbarkeit.

complaint

Dieses Feld ist nur vorhanden, wenn eventType auf Complaint eingestellt ist. Es enthält Informationen über die Beschwerde.

delivery

Dieses Feld ist nur vorhanden, wenn eventType auf Delivery eingestellt ist. Es enthält Informationen über die Zustellung.

send

Dieses Feld ist nur vorhanden, wenn eventType auf Send eingestellt ist.

reject

Dieses Feld ist nur vorhanden, wenn eventType auf Reject eingestellt ist. Es enthält Informationen über die Ablehnung.

open

Dieses Feld ist nur vorhanden, wenn eventType auf Open eingestellt ist. Es enthält Informationen über das offene Ereignis.

click

Dieses Feld ist nur vorhanden, wenn eventType auf Click eingestellt ist. Es enthält Informationen über das Klick-Ereignis.

failure

Dieses Feld ist nur vorhanden, wenn eventType auf Rendering Failure eingestellt ist. Es enthält Informationen über das Rendering-Fehlerereignis.

deliveryDelay

Dieses Feld ist nur vorhanden, wenn eventType auf DeliveryDelay eingestellt ist. Es enthält Informationen zur verzögerten Zustellung einer E-Mail.

subscription

Dieses Feld ist nur vorhanden, wenn eventType auf Subscription eingestellt ist. Es enthält Informationen zu den Abonnementeinstellungen.

Mail-Objekt

Jeder E-Mail-Sendeereignisprotokolleintrag enthält Informationen über die ursprüngliche E-Mail im mail-Objekt. Das JSON-Objekt enthält Informationen über ein mail-Objekt mit den folgenden Feldern.

Feldname Beschreibung

timestamp

Datum und Uhrzeit im Format ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), an dem die Nachricht gesendet wurde.

messageId

Eine eindeutige ID, die Amazon SES der Nachricht zugewiesen hat. Amazon SES gibt diesen Wert an Sie zurück, wenn Sie die Nachricht gesendet haben.

Anmerkung

Diese Nachrichten-ID wurde von Amazon SES zugewiesen. Sie finden diese Mitteilungs-ID in der ursprünglichen E-Mail in den Feldern headers und commonHeaders des Objekts mail.

source

Die E-Mail-Adresse, von der die Nachricht gesendet wurde (die Envelope-MAIL-FROM-Adresse).

sourceArn

Der Amazon-Ressourcenname (ARN) der Identität, die zum Senden der E-Mail verwendet wurde. Im Fall einer Sendeautorisierung gibt sourceArn den ARN der ID an, die – gemäß Autorisierung durch den Identitätsbesitzer – vom stellvertretenden Sender zum Senden der E-Mail verwendet werden soll. Weitere Informationen zur Sendeautorisierung finden Sie unter E-Mail-Authentifizierungsmethoden.

sendingAccountId

Die AWS Konto-ID des Kontos, das zum Senden der E-Mail verwendet wurde. Im Fall einer Sendeautorisierung gibt sendingAccountId die Konto-ID des stellvertretenden Senders an.

destination

Eine Liste der E-Mail-Adressen, an die die ursprüngliche E-Mail gesendet wurde.

headersTruncated

Eine Zeichenfolge, die angibt, ob die Header in der Benachrichtigung abgeschnitten sind. Dies passiert, wenn die Header größer als 10 KB sind. Mögliche Werte sind true und false.

headers

Eine Liste der ursprünglichen Header der E-Mail. Jeder Header in der Liste verfügt über die Felder name und value.

Anmerkung

Jede Nachrichten-ID im Feld headers stammt von der ursprünglichen Nachricht, die Sie an Amazon SES übergeben haben. Die Nachrichten-ID, die Amazon SES der Nachricht später zugewiesen hat, befindet sich im Feld messageId des Objekts mail.

commonHeaders

Eine Zuordnung der ursprünglichen, häufig verwendeten Header der E-Mail.

Anmerkung

Die Nachrichten-ID im Feld commonHeaders ist die Nachrichten-ID, die Amazon SES der Nachricht später im Feld messageId des Objekts mail zugewiesen hat.

tags

Eine Liste von Tags, die der E-Mail-Adresse zugeordnet sind.

Bounce-Objekt

Das JSON-Objekt, das die Informationen zu einem Bounce-Ereignis enthält, weist immer die folgenden Felder auf.

Feldname Beschreibung

bounceType

Der Unzustellbarkeitstyp, wie er von Amazon SES festgelegt wurde.

bounceSubType

Der untergeordnete Typ der Unzustellbarkeit, wie er von Amazon SES festgelegt wurde.

bouncedRecipients

Eine Liste mit Informationen über die Empfänger der ursprünglichen E-Mail, an die diese nicht zugestellt werden konnte.

timestamp

Datum und Uhrzeit im Format ISO86 01 (YYYY-MM-:mm:ss.sz DDThh), an dem der ISP die Bounce-Benachrichtigung gesendet hat.

feedbackId

Eine eindeutige ID für die Unzustellbarkeit.

reportingMTA

Der Wert des Reporting-MTA-Felds der DSN. Dies ist der Wert der Message Transfer Authority (MTA), die versucht hat, die Zustellungs-, Weiterleitungs- oder Gateway-Operation durchzuführen, die in der DSN beschrieben ist.

Anmerkung

Dieses Feld wird nur dann angezeigt, wenn eine Zustellungsstatusbenachrichtigung (Delivery Status Notification, DNS) an die Unzustellbarkeitsbenachrichtigung angehängt wurde.

Empfänger, an die nicht zugestellt werden konnte

Ein Unzustellbarkeitsereignis kann für einen einzelnen Empfänger oder für mehrere Empfänger gelten. Das bouncedRecipients-Feld enthält eine Liste von Objekten – eines pro Empfänger, für den das Bounce-Ereignis auftritt – und weist zusätzlich immer das folgende Feld auf.

Feldname Beschreibung

emailAddress

Die E-Mail-Adresse des Empfängers. Ist eine DSN verfügbar, ist dies der Wert des Final-Recipient-Felds der DSN.

Wurde eine DSN an eine Unzustellbarkeitsbenachrichtigung angehängt, sind möglicherweise folgende Felder ebenfalls vorhanden.

Feldname Beschreibung

action

Der Wert des Action-Felds der DSN. Es zeigt die Aktion an, die von der berichtenden MTA als Reaktion auf die gescheiterte Zustellung der Benachrichtigung an diesen Empfänger ausgeführt wurde.

status

Der Wert des Status-Felds der DSN. Dies ist der vom Transport unabhängige Statuscode pro Empfänger, der den Zustellstatus der Nachricht anzeigt.

diagnosticCode

Der vom berichtenden MTA gemeldete Statuscode. Dies ist der Wert des Diagnostic-Code-Felds der DSN. Dieses Feld ist möglicherweise nicht im DSN und daher auch nicht in JSON enthalten.

Unzustellbarkeitstypen

Jedes Unzustellbarkeitsereignis ist von einem der Typen, die in der folgenden Tabelle gezeigt werden.

Das System zur Ereignisveröffentlichung veröffentlicht nur permanente Unzustellbarkeiten und temporäre Unzustellbarkeiten, die nicht mehr von Amazon SES abgerufen werden. Wenn Sie Unzustellbarkeitsnachrichten erhalten, die mit Permanent gekennzeichnet sind, sollten Sie die entsprechenden E-Mail-Adressen aus Ihrer Mailingliste entfernen; Sie werden in Zukunft nicht mehr an sie senden können. Transient-Unzustellbarkeitsnachrichten werden an Sie gesendet, wenn eine Nachricht mehrmals temporär unzustellbar war und Amazon SES nicht mehr versucht, sie erneut zu senden. Es ist möglich, dass das erneute Senden einer E-Mail an eine Adresse später erfolgreich ist, die ursprünglich zu einem Transient-Bounce führte.

bounceType bounceSubType Beschreibung

Undetermined

Undetermined

Amazon SES konnte keinen bestimmten Grund für das Scheitern der Zustellung finden.

Permanent

General

Amazon SES hat eine allgemeine permanente Unzustellbarkeit erhalten. Wenn Sie diese Art von Unzustellbarkeit erhalten, sollten Sie die E-Mail-Adresse des Empfängers aus Ihrer Mailing-Liste entfernen.

Permanent

NoEmail

Amazon SES hat eine Benachrichtigung über eine permanente Unzustellbarkeit enthalten, da die Ziel-E-Mail-Adresse nicht existiert. Wenn Sie diese Art von Unzustellbarkeit erhalten, sollten Sie die E-Mail-Adresse des Empfängers aus Ihrer Mailing-Liste entfernen.

Permanent

Suppressed

Amazon SES hat das Senden an diese Adresse unterdrückt, da bereits mehrere Zustellversuche aufgrund einer ungültigen Adresse fehlgeschlagen sind. Informationen zum Überschreiben der globalen Unterdrückungsliste finden Sie unterVerwenden der Unterdrückungsliste auf Kontoebene der Amazon-SES-Konsole.

Permanent OnAccountSuppressionList Amazon SES hat das Senden an diese Adresse unterdrückt, da sie sich auf der Unterdrückungsliste auf Kontoebene befindet. Dies zählt nicht für Ihre Unzustellbarkeitsraten-Metrik.

Transient

General

Amazon SES hat eine allgemeine Unzustellbarkeitsbenachrichtigung erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger zukünftig möglich.

Transient

MailboxFull

Amazon SES hat eine Unzustellbarkeitsbenachrichtigung erhalten, weil das Postfach voll ist. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger zukünftig möglich.

Transient

MessageTooLarge

Amazon SES hat eine Unzustellbarkeitsbenachrichtigung aufgrund einer zu großen E-Mail erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger möglich, wenn Sie die Größe der Nachricht reduzieren.

Transient

CustomTimeoutExceeded

Amazon SES war nicht in der Lage, die E-Mail innerhalb der vom E-Mail-Absender angegebenen Zeit erfolgreich zuzustellen. (In der Bounce-Nachricht wird der Grund für mögliche fehlgeschlagene Zustellungsversuche innerhalb der definierten TTL angegeben.)

Transient

ContentRejected

Amazon SES hat eine Unzustellbarkeitsbenachrichtigung aufgrund eines abgelehnten Inhalts erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger möglich, wenn Sie den Inhalt der Nachricht ändern.

Transient

AttachmentRejected

Amazon SES hat eine Unzustellbarkeitsbenachrichtigung aufgrund eines abgelehnten Anhangs erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger möglich, wenn Sie den Anhang entfernen oder ändern.

Complaint-Objekt

Das JSON-Objekt enthält Informationen über ein Complaint-Ereignis mit den folgenden Feldern.

Feldname Beschreibung

complainedRecipients

Eine Liste mit Informationen zu Empfängern, die sich möglicherweise beschwert haben.

timestamp

Datum und Uhrzeit im Format ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), an dem der ISP die Beschwerdebenachrichtigung gesendet hat.

feedbackId

Eine eindeutige ID für die Beschwerde.

complaintSubType

Der Untertyp der Beschwerde, wie von Amazon SES festgelegt.

Ist zudem ein Feedback-Bericht an die Beschwerde angehängt, sind möglicherweise die folgenden Felder vorhanden.

Feldname Beschreibung

userAgent

Der Wert des User-Agent-Felds aus dem Feedback-Bericht. Gibt den Namen und die Version des Systems an, das den Bericht generiert hat.

complaintFeedbackType

Der Wert des Feedback-Type-Felds aus dem Feedback-Bericht, der vom ISP empfangen wurde. Enthält die Art des Feedbacks.

arrivalDate

Der Wert des Received-Date Felds Arrival-Date oder aus dem Feedback-Bericht im Format 01 (YYYY-MM-:mm:ss.sz). ISO86 DDThh Dieses Feld ist möglicherweise nicht im Bericht und daher auch nicht in JSON enthalten.

Empfänger, die sich beschwert haben

Das complainedRecipients-Feld enthält eine Liste von Empfängern, die sich möglicherweise beschwert haben.

Wichtig

Da die meisten ISPs die E-Mail-Adresse des Empfängers, der die Beschwerde eingereicht hat, aus der Beschwerdebenachrichtigung herauslesen, enthält diese Liste Informationen über Empfänger, die die Beschwerde möglicherweise gesendet haben, basierend auf den Empfängern der ursprünglichen Nachricht und dem ISP, von dem wir die Beschwerde erhalten haben. Amazon SES führt einen Abgleich mit der ursprünglichen Nachricht durch, um diese Empfängerliste festzulegen.

JSON-Objekte in dieser Liste enthalten das folgende Feld.

Feldname Beschreibung

emailAddress

Die E-Mail-Adresse des Empfängers.

Beschwerdetypen

Sie sehen möglicherweise die folgenden Beschwerdetypen im complaintFeedbackType-Feld, so wie sie vom meldenden ISP entsprechend der Website zu Internet Assigned Numbers Authority zugewiesen wurden:

Feldname Beschreibung

abuse

Weist auf unerwünschte E-Mails oder eine andere Art von E-Mail-Missbrauch hin.

auth-failure

Bericht über einen E-Mail-Authentifizierungsfehler.

fraud

Weist auf einen Betrug oder Phishing hin.

not-spam

Weist darauf hin, dass die Entität, die den Bericht bereitstellt, die Nachricht nicht als Spam betrachtet. Dies kann verwendet werden, um eine Nachricht zu korrigieren, die fälschlicherweise als Spam gekennzeichnet oder kategorisiert wurde.

other

Gibt eine andere Art von Feedback an, das nicht zu den registrierten Typen passt.

virus

Meldet, dass in der ursprünglichen Nachricht ein Virus entdeckt wurde.

Delivery-Objekt

Das JSON-Objekt, das die Informationen zu einem Delivery-Ereignis enthält, weist immer die folgenden Felder auf.

Feldname Beschreibung

timestamp

Das Datum und die Uhrzeit, zu der Amazon SES die E-Mail an den E-Mail-Server des Empfängers zugestellt hat, im Format ISO86 01 (YYYY-MM-:mm:ss.sz). DDThh

processingTimeMillis

Die Zeit in Millisekunden zwischen dem Zeitpunkt, als Amazon SES die Anforderung des Senders angenommen hat, und dem Zeitpunkt, als die Nachricht an den Mail-Server des Empfängers übergeben hat.

recipients

Eine Liste der beabsichtigten Empfänger, für die das Übermittlungsereignis gilt.

smtpResponse

Die SMTP-Antwort des Remote-ISPs, der die E-Mail von Amazon SES zugelassen hat. Diese Nachricht variiert je nach E-Mail, empfangendem Mail-Server und empfangendem ISP.

reportingMTA

Der Hostname des Amazon SES-Mail-Servers, der die E-Mail gesendet hat.

Send-Objekt

Das JSON-Objekt mit Informationen über das send-Ereignis ist immer leer.

Reject-Objekt

Das JSON-Objekt, das die Informationen zu einem Reject-Ereignis enthält, weist immer die folgenden Felder auf.

Feldname Beschreibung

reason

Der Grund für die Ablehnung der E-Mail. Der einzige mögliche Wert ist Bad content. Er bedeutet, dass Amazon SES erkannt hat, dass die E-Mail einen Virus enthält. Wenn eine Nachricht abgelehnt wird, hält Amazon SES ihre Verarbeitung an und versucht nicht, sie dem E-Mail-Server des Empfängers zuzustellen.

Open-Objekt

Das JSON-Objekt, das die Informationen zu einem Open-Ereignis enthält, enthält immer die folgenden Felder.

Feldname Beschreibung

ipAddress

Die IP-Adresse des Empfängers.

timestamp

Datum und Uhrzeit des Auftretens des Öffnungsereignisses im Format 01 (YYYY-MM-:mm:ss.sz). ISO86 DDThh

userAgent

Der Benutzeragent des Geräts oder E-Mail-Client, mit dem der Empfänger die E-Mail geöffnet hat.

Click-Objekt

Das JSON-Objekt, das die Informationen zu einem Click-Ereignis enthält, enthält immer die folgenden Felder.

Feldname Beschreibung

ipAddress

Die IP-Adresse des Empfängers.

timestamp

Datum und Uhrzeit des Auftretens des Klickereignisses im Format 01 (YYYY-MM-:mm:ss.sz). ISO86 DDThh

userAgent

Der Benutzeragent des Clients, den der Empfänger zum Klicken auf einen Link in der E-Mail verwendet hat.

link

Die URL des Links, auf den der Empfänger geklickt hat.

linkTags

Eine Liste der Tags, die dem Link mithilfe des ses:tags-Attributs hinzugefügt wurden. Weitere Informationen zum Hinzufügen von Tags zu Links in Ihren E-Mails finden Sie unter F5. Kann ich Links mit eindeutigen Bezeichnern markieren? in den Amazon SES SES-Metriken zum Senden von E-Mails FAQs.

Rendering-Failure-Objekt

Das JSON-Objekt enthält Informationen über ein Rendering Failure-Ereignis mit den folgenden Feldern.

Feldname Beschreibung

templateName

Der Name der Vorlage, die zum Senden der E-Mail verwendet wurde.

errorMessage

Eine Nachricht, die weitere Informationen über den Rendering-Fehler enthält.

DeliveryDelay Objekt

Das JSON-Objekt enthält Informationen über ein DeliveryDelay-Ereignis mit den folgenden Feldern.

Feldname Beschreibung

delayType

Die Art der Verzögerung. Die möglichen Werte sind:

  • InternalFailure— Ein internes Amazon SES SES-Problem führte zu einer Verzögerung der Nachricht.

  • General – ein generischer Fehler ist während der SMTP-Konversation aufgetreten.

  • MailboxFull— Das Postfach des Empfängers ist voll und kann keine weiteren Nachrichten empfangen.

  • SpamDetected— Der E-Mail-Server des Empfängers hat eine große Menge unerwünschter E-Mails von Ihrem Konto erkannt.

  • RecipientServerError— Ein vorübergehendes Problem mit dem E-Mail-Server des Empfängers verhindert die Zustellung der Nachricht.

  • IPFailure— Die IP-Adresse, über die die Nachricht gesendet wird, wird vom E-Mail-Anbieter des Empfängers blockiert oder gedrosselt.

  • TransientCommunicationFailure— Während der SMTP-Konversation mit dem E-Mail-Anbieter des Empfängers ist ein vorübergehender Kommunikationsfehler aufgetreten.

  • BYOIPHostNameLookupUnavailable— Amazon SES konnte den DNS-Hostnamen für Ihre IP-Adressen nicht ermitteln. Diese Art von Verzögerung tritt nur auf, wenn Sie Bring Your Own IP verwenden.

  • Unbestimmt – Amazon SES konnte den Grund für die Lieferverzögerung nicht ermitteln.

  • SendingDeferral— Amazon SES hat es für angemessen erachtet, die Nachricht intern zu verschieben.

delayedRecipients

Ein Objekt, das Informationen zum E-Mail-Empfänger enthält

expirationTime

Das Datum und die Uhrzeit, wann Amazon SES die Zustellung der Nachricht nicht mehr versucht. Dieser Wert wird im ISO 8601-Format angezeigt.

reportingMTA

Die IP-Adresse des Message Transfer Agent (MTA), der die Verzögerung gemeldet hat

timestamp

Datum und Uhrzeit, wann die Verzögerung aufgetreten ist (im ISO 8601-Format)

Empfänger, an die verzögert zugestellt wurde

Das delayedRecipients-Objekt enthält die folgenden Werte:

Feldname Beschreibung

emailAddress

Die E-Mail-Adresse, die zu einer verzögerten Zustellung der Nachricht führte

status

Der SMTP-Statuscode, der der Zustellverzögerung zugeordnet ist

diagnosticCode

Der Diagnosecode, der vom empfangenden Message Transfer Agent (MTA) bereitgestellt wird

Abonnementobjekt

Das JSON-Objekt enthält Informationen über ein Subscription-Ereignis mit den folgenden Feldern.

Feldname Beschreibung

contactList

Der Name der Liste, auf der sich der Kontakt befindet.

timestamp

Datum und Uhrzeit im Format ISO86 01 (YYYY-MM DDThh -:mm:ss.sz), an dem der ISP die Abonnementbenachrichtigung gesendet hat.

source

Die E-Mail-Adresse, von der die Nachricht gesendet wurde (die Envelope-MAIL-FROM-Adresse).

newTopicPreferences

Eine JSON-Datenstruktur (Zuweisung), die den Abonnementstatus aller Themen in der Kontaktliste angibt, die den Status nach einer Änderung (Kontakt abonniert oder Abonnement abbestellt) anzeigt.

oldTopicPreferences

Eine JSON-Datenstruktur (Zuweisung), die den Abonnementstatus aller Themen in der Kontaktliste angibt, die den Status vor der Änderung (Kontakt abonniert oder Abonnement abbestellt) anzeigt.

Einstellungen für neue/alte Themen

Die Objekte newTopicPreferences und oldTopicPreferences enthalten die folgenden Werte.

Feldname Beschreibung

unsubscribeAll

Gibt an, ob der Kontakt das Abonnement von allen Themen in der Kontaktliste abbestellt hat.

topicSubscriptionStatus

Gibt den Abonnementstatus des Themas in dem topicName Feld an, das angibt, ob es derzeit für den Empfang von Benachrichtigungen von SES für den angegebenen Ereignistyp angemeldet ist. Mögliche Werte sind OptIn(abonniert) oder OptOut(abgemeldet) in dem Feld. subscriptionStatus

topicDefaultSubscriptionStatus

Gibt den Standard-Abonnementstatus des Themas im topicName Feld an, der bestimmt, ob neue Themen, die dem Veranstaltungsziel hinzugefügt werden, standardmäßig abonniert oder abgemeldet werden. Mögliche Werte sind OptIn(standardmäßig abonniert) oder OptOut(standardmäßig abgemeldet) in dem Feld. subscriptionStatus