Inhalt der Veranstaltungsdaten, die Amazon auf Amazon SES veröffentlicht SNS - Amazon Simple Email Service
Objekt der obersten Ebene JSONMail-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 Veranstaltungsdaten, die Amazon auf Amazon SES veröffentlicht SNS

Amazon SES veröffentlicht Aufzeichnungen über E-Mail-Versandereignisse an Amazon Simple Notification Service im JSON Format.

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

Objekt der obersten Ebene JSON

Das JSON Objekt der obersten Ebene in einem E-Mail-Versandereignisdatensatz enthält die folgenden Felder. Der Ereignistyp bestimmt, welche anderen Objekte vorhanden sind.

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 ausgelöst 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, das Informationen über ein mail Objekt enthält, hat die folgenden Felder.

Feldname Beschreibung

timestamp

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

messageId

Eine eindeutige ID, die Amazon SES der Nachricht zugewiesen hat. Amazon SES hat Ihnen diesen Wert zurückgegeben, als Sie die Nachricht gesendet haben.

Anmerkung

Diese Nachrichten-ID wurde von Amazon zugewiesenSES. 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 MAIL FROM Umschlagadresse).

sourceArn

Der Amazon-Ressourcenname (ARN) der Identität, die zum Senden der E-Mail verwendet wurde. Im Fall einer Sendeautorisierung sourceArn ist dies die Identität, die ARN der Identitätsinhaber dem delegierten Absender zum Senden der E-Mail autorisiert hat. 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 in dem headers Feld stammt aus der ursprünglichen Nachricht, die Sie an Amazon weitergegeben habenSES. Die Nachrichten-ID, die Amazon der Nachricht SES anschließend zugewiesen hat, befindet sich im messageId Feld des mail Objekts.

commonHeaders

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

Anmerkung

Jede Nachrichten-ID innerhalb des commonHeaders Felds ist die Nachrichten-ID, die Amazon SES anschließend der Nachricht im messageId Feld des mail Objekts zugewiesen hat.

tags

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

Bounce-Objekt

Das JSON Objekt, das Informationen zu einem Bounce Ereignis enthält, hat die folgenden Felder.

Feldname Beschreibung

bounceType

Die Art des Bounces, wie von Amazon SES festgelegt.

bounceSubType

Der von Amazon festgelegte Untertyp des Bounces. SES

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 DDThh -:mm:ss.sz), an dem die Bounce-Benachrichtigung gesendet wurde. ISP

feedbackId

Eine eindeutige ID für die Unzustellbarkeit.

reportingMTA

Der DSN Wert des Feldes aus dem. Reporting-MTA Dies ist der Wert der Message Transfer Authority (MTA), die versucht hat, den in der beschriebenen Zustellungs-, Relay- oder Gateway-Vorgang auszuführenDSN.

Anmerkung

Dieses Feld wird nur angezeigt, wenn dem Bounce eine Benachrichtigung über den Zustellungsstatus (DSN) beigefügt 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, dessen E-Mail-Adresse ein Unzustellbarkeitsereignis hervorgerufen hat – und weist zusätzlich das folgende Feld auf.

Feldname Beschreibung

emailAddress

Die E-Mail-Adresse des Empfängers. Wenn a verfügbar DSN ist, ist dies der Wert des Final-Recipient Feldes DSN aus.

Wenn dem Bounce ein angehängt DSN ist, können optional auch die folgenden Felder vorhanden sein.

Feldname Beschreibung

action

Der Wert des Action Feldes aus demDSN. Dies gibt die Aktion an, die der Melder MTA als Ergebnis seines Versuchs, die Nachricht an diesen Empfänger zuzustellen, ausgeführt hat.

status

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

diagnosticCode

Der von der Berichterstattung ausgegebene StatuscodeMTA. Dies ist der Wert des Diagnostic-Code Feldes aus demDSN. Dieses Feld fehlt möglicherweise in der DSN (und daher auch in derJSON).

Unzustellbarkeitstypen

Jedes Unzustellbarkeitsereignis lässt sich einem der Typen zuordnen, die in der folgenden Tabelle aufgeführt sind.

Das Event-Publishing-System veröffentlicht nur Hard Bounces und Soft Bounces, die von Amazon nicht mehr wiederholt werden. SES Wenn Sie markierte Bounces erhaltenPermanent, sollten Sie die entsprechenden E-Mail-Adressen aus Ihrer Mailingliste entfernen. Sie können in future keine E-Mails mehr an sie senden. TransientBounces werden an Sie gesendet, wenn eine Nachricht mehrmals per Soft Bounce gesendet wurde und Amazon den Versuch, sie erneut zuzustellen, eingestellt SES hat. 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 den Abbruch ermitteln.

Permanent

General

Amazon SES verzeichnete einen allgemeinen harten Aufschwung. 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 einen permanenten Hard-Bounce erhalten, 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 den Versand an diese Adresse unterdrückt, da das Unternehmen in der Vergangenheit in der Vergangenheit als ungültige Adresse zurückgeschickt wurde. Informationen zum Überschreiben der globalen Unterdrückungsliste finden Sie unterVerwenden der SES Amazon-Unterdrückungsliste auf Kontoebene.

Permanent OnAccountSuppressionList Amazon SES hat den Versand an diese Adresse unterdrückt, da sie auf der Sperrliste auf Kontoebene steht. Dies zählt nicht für Ihre Unzustellbarkeitsraten-Metrik.

Transient

General

Amazon SES verzeichnete einen allgemeinen Aufschwung. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger zukünftig möglich.

Transient

MailboxFull

Amazon SES hat ein Postfach mit voller Bounce erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger zukünftig möglich.

Transient

MessageTooLarge

Amazon SES hat die Nachricht „Zu großer Bounce“ erhalten. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger möglich, wenn Sie die Größe der Nachricht reduzieren.

Transient

CustomTimeoutExceeeded

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 festgelegten Frist angegebenTTL.)

Transient

ContentRejected

Amazon SES hat einen Bounce mit abgelehnten Inhalten 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 einen Anhang erhalten, der zurückgewiesen wurde. Möglicherweise ist eine erfolgreiche Zustellung an diesen Empfänger möglich, wenn Sie den Anhang entfernen oder ändern.

Complaint-Objekt

Das JSON Objekt, das Informationen zu einem Complaint Ereignis enthält, hat die folgenden Felder.

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-:mm:ss.szDDThh), an dem die Beschwerdebenachrichtigung gesendet wurde. ISP

feedbackId

Eine eindeutige ID für die Beschwerde.

complaintSubType

Der von Amazon SES festgelegte Untertyp der Beschwerde.

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 von. ISP Enthält die Art des Feedbacks.

arrivalDate

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

Empfänger, die sich beschwert haben

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

Wichtig

In den ISPs meisten Fällen werden die E-Mail-Adressen der Empfänger, die Beschwerden einreichen, geschwärzt. Aus diesem Grund enthält das Feld complainedRecipients eine Liste aller Personen, denen eine E-Mail zugesendet wurde, deren Adresse zu der Domäne gehört, die die Beschwerdebenachrichtigung ausgegeben hat.

JSONObjekte in dieser Liste enthalten das folgende Feld.

Feldname Beschreibung

emailAddress

Die E-Mail-Adresse des Empfängers.

Beschwerdetypen

Laut der Website der Internet Assigned Numbers Authority werden in dem complaintFeedbackType Feld möglicherweise die folgenden Beschwerdearten angezeigtISP, die in den Berichten 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.

Beschwerde-Untertypen

Der Wert des Feldes complaintSubType kann entweder null oder OnAccountSuppressionList sein. Wenn der Wert istOnAccountSuppressionList, hat Amazon die Nachricht SES akzeptiert, aber nicht versucht, sie zu senden, da sie auf der Sperrliste auf Kontoebene stand.

Delivery-Objekt

Das JSON Objekt, das Informationen zu einem Delivery Ereignis enthält, hat die folgenden Felder.

Feldname Beschreibung

timestamp

Das Datum und die Uhrzeit, zu der Amazon die E-Mail SES 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 der SES Annahme der Anfrage des Absenders durch Amazon und der Weiterleitung der Nachricht durch SES Amazon an den E-Mail-Server des Empfängers.

recipients

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

smtpResponse

Die SMTP Antwortnachricht der FernbedienungISP, die die E-Mail von Amazon akzeptiert hatSES. Diese Nachricht variiert je nach E-Mail, empfangendem Mailserver und EmpfangISP.

reportingMTA

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

Send-Objekt

Das JSON Objekt, das Informationen zu einem send Ereignis enthält, ist immer leer.

Reject-Objekt

Das JSON Objekt, das Informationen zu einem Reject Ereignis enthält, hat die folgenden Felder.

Feldname Beschreibung

reason

Der Grund für die Ablehnung der E-Mail. Der einzig mögliche Wert istBad content, was bedeutet, dass Amazon SES erkannt hat, dass die E-Mail einen Virus enthält. Wenn eine Nachricht abgelehnt wird, SES stoppt Amazon die Verarbeitung und versucht nicht, sie an den E-Mail-Server des Empfängers zuzustellen.

Open-Objekt

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

Feldname Beschreibung

ipAddress

Die IP-Adresse des Empfängers.

timestamp

Datum und Uhrzeit des Auftretens des Öffnungsereignisses im Format ISO86 01 (YYYY-MM-:mm:ss.sz 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 Informationen zu einem Ereignis enthält, hat die folgenden Felder. Click

Feldname Beschreibung

ipAddress

Die IP-Adresse des Empfängers.

timestamp

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

userAgent

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

link

Der URL Link, 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 Häufig gestellte Fragen zu Amazon-SES-E-Mail-Sendemetriken.

Rendering-Failure-Objekt

Das JSON Objekt, das Informationen zu einem Rendering Failure Ereignis enthält, hat die folgenden Felder.

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, das Informationen zu einem DeliveryDelay Ereignis enthält, hat die folgenden Felder.

Feldname Beschreibung

delayType

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

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

  • Allgemein — Während der SMTP Konversation ist ein generischer Fehler 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 nachschlagen. Diese Art von Verzögerung tritt nur auf, wenn Sie Bring Your Own IP verwenden.

  • Unbestimmt — Amazon konnte den Grund für die Lieferverzögerung SES 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

Datum und Uhrzeit, an dem Amazon SES nicht mehr versucht, die Nachricht zuzustellen. Dieser Wert wird im Format ISO 8601 angezeigt.

reportingMTA

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

timestamp

Datum und Uhrzeit des Auftretens der Verzögerung, angezeigt 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 mit der Lieferverzögerung verknüpfte SMTP Statuscode.

diagnosticCode

Der vom empfangenden Message Transfer Agent (MTA) bereitgestellte Diagnosecode.

Abonnementobjekt

Das JSON Objekt, das Informationen zu einem Subscription Ereignis enthält, hat die folgenden Felder.

Feldname Beschreibung

contactList

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

timestamp

Datum und Uhrzeit im Format ISO86 01 (YYYY-MM-:mm:ss.szDDThh), an dem die Abonnementbenachrichtigung gesendet wurde. ISP

source

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

newTopicPreferences

Eine JSON Datenstruktur (Map), die den Abonnementstatus aller Themen in der Kontaktliste angibt und den Status nach einer Änderung angibt (Kontakt abonniert oder abgemeldet).

oldTopicPreferences

Eine JSON Datenstruktur (Map), die den Abonnementstatus aller Themen in der Kontaktliste angibt und den Status vor der Änderung angibt (Kontakt abonniert oder abgemeldet).

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 Benachrichtigungen SES für den angegebenen Ereignistyp abonniert hat. 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) im Feld. subscriptionStatus