Überwachen Sie den E-Mail-Versand mithilfe von Amazon SES Event Publishing

Damit Sie Ihren E-Mail-Versand detailliert verfolgen können, können Sie Amazon SES so einrichten, dass E-Mail-Versandereignisse auf EventBridge Grundlage von von Ihnen definierten Merkmalen an Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service oder Amazon veröffentlicht werden.

Sie können mehrere Arten von E-Mail-Sendeereignissen nachverfolgen, einschließlich gesendete, zugestellte, geöffnete, angeklickte, unzustellbare und abgelehnte E-Mails sowie Beschwerden, Rendering-Fehler und Zustellverzögerungen. Diese Informationen helfen Ihnen bei betrieblichen und analytischen Zwecken. Sie können beispielsweise Ihre E-Mail-Versanddaten veröffentlichen CloudWatch und Dashboards erstellen, die die Leistung Ihrer E-Mail-Kampagnen verfolgen, oder Sie können Amazon verwenden, um Ihnen Benachrichtigungen SNS zu senden, wenn bestimmte Ereignisse eintreten.

So funktioniert die Veröffentlichung von Ereignissen mit Konfigurationssätzen und Nachrichten-Tags

Zur Verwendung der Ereignisveröffentlichung müssen Sie zunächst ein oder mehrere Konfigurationssätze einrichten. Ein Konfigurationssatz gibt an, wo Ihre Ereignisse veröffentlicht werden und welche Ereignisse veröffentlicht werden. Jedes Mal, wenn Sie dann eine E-Mail senden, geben Sie den Namen des Konfigurationssatzes und einen oder mehrere Nachrichten-Tags in Form von Name/Wert-Paaren an, um die E-Mail zu kategorisieren. Wenn Sie beispielsweise Bücher bewerben, könnten Sie einen Nachrichten-Tag Genre nennen und den Wert Sci-Fi oder Western zuweisen, wenn Sie eine E-Mail für die entsprechende Kampagne senden.

Je nachdem, welche E-Mail-Versandschnittstelle Sie verwenden, geben Sie entweder das Nachrichten-Tag als Parameter in das EmailTagsFeld des SendEmailAPIVorgangs ein oder fügen das Nachrichten-Tag dem SES -spezifischen E-Mail-Header X-SES-MESSAGE-TAGShinzu. Weitere Informationen zu Konfigurationssätzen finden Sie unter Verwenden von Konfigurationssätzen in Amazon SES.

Zusätzlich zu den von Ihnen angegebenen Nachrichten-Tags werden den von Ihnen gesendeten Nachrichten SES auch Auto-Tags hinzugefügt. Sie müssen keine weiteren Schritte zum Verwenden der automatischen Tags durchführen.

In der folgenden Tabelle sind die Auto-Tags aufgeführt, die automatisch auf Nachrichten angewendet werden, die Sie verwendenSES.

Automatische Tags in SES

Automatische Tag-Namen	Beschreibung
ses:caller-identity	Die IAM Identität des SES Benutzers, der die E-Mail gesendet hat.
ses:configuration-set	Der Name des Konfigurationssatzes, der der E-Mail zugeordnet ist.
ses:from-domain	Die Domäne der "From"-Adresse.
ses:outgoing-ip	Die IP-Adresse, über SES die die E-Mail gesendet wurde.
ses:source-ip	Die IP-Adresse, die der Aufrufer zum Senden der E-Mail verwendet hat.
ses:source-tls-version	Die TLS Protokollversion, mit der der Anrufer die E-Mail gesendet hat.
ses:outgoing-tls-version	Die TLS Protokollversion, mit SES der die E-Mail gesendet wurde.

Detailliertes Feedback für E-Mail-Kampagnen

Das ses:feedback-id-<a or b> Tag ist ein optionales Nachrichten-Tag, das Sie sich als hybrides oder halbautomatisches Tag vorstellen können. Es ähnelt zwar den im vorherigen Abschnitt besprochenen Auto-Tags, der Unterschied besteht jedoch darin, dass Sie es manuell hinzufügen und den Präfixschlüssel verwenden müssen. ses: Sie können bis zu zwei dieser Tags verwenden, die als und definiert sind. ses:feedback-id-a ses:feedback-id-b

Wenn Sie diese Tags angeben, SES werden sie automatisch an den Feedback-ID Standard-Header angehängt, der für die Bereitstellung von Zustellungsstatistiken wie Beschwerden und Spamraten als Teil einer Feedback-Schleife (FBL) verwendet wird, sieheFeedback-Schleifen. Der Feedback-ID Header besteht aus der Kennung SESInternalID, die SES zum Sammeln von Beschwerdeinformationen verwendet wird, und dem statischen Tag Amazon SES, das SES als sendende Plattform identifiziert wird, z. B.:

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

Diese optionalen Feedback-ID-Tags bieten Ihnen die Möglichkeit, detailliertes Feedback zu generieren, z. B. für Nachrichten, die Sie im Rahmen einer E-Mail-Kampagne versenden. Sie können es verwenden, ses:feedback-id-<a or b> indem Sie es als Nachrichten-Tag im EmailTagsFeld der SendEmailOperationsanfrage angeben, wie im folgenden Beispiel gezeigt:

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

Wenn Sie im Rohformat senden, würden Sie dem SES -spezifischen Header X-SES-MESSAGE-TAGSein Nachrichten-Tag hinzufügenses:feedback-id-<a or b>.

Das ses:feedback-id-<a or b> Nachrichten-Tag kann auch in Amazon nachverfolgt werden, CloudWatch indem es wie jedes andere Nachrichten-Tag als CloudWatch Wertquelle angegeben wird, siehe Hinzufügen eines CloudWatch-Ereignisziels (Es fallen zusätzliche Gebühren an, siehe Preis pro Metrik für CloudWatch.)

Verwenden der Ereignisveröffentlichung

Die folgenden Abschnitte enthalten die Informationen, die Sie für die Einrichtung und Nutzung von SES Event-Publishing benötigen.

• Einrichten der Ereignisveröffentlichung

• Arbeiten mit Ereignisdaten

Terminologie zu Ereignisveröffentlichung

In der folgenden Liste werden Begriffe im Zusammenhang mit der Veröffentlichung von SES Veranstaltungen definiert.

E-Mail-Sendeereignis

Informationen im Zusammenhang mit dem Ergebnis einer E-Mail, an die Sie eine E-Mail sendenSES. Das Senden von Ereignissen umfasst Folgendes:

• Senden — Die Sendeanfrage war erfolgreich und Amazon SES versucht, die Nachricht an den E-Mail-Server des Empfängers zu senden. (Wenn die Unterdrückung auf Kontoebene oder weltweit verwendet SES wird, wird die Nachricht trotzdem als Versand gewertet, aber die Zustellung wird unterdrückt.)

• RenderingFailure— Die E-Mail wurde aufgrund eines Problems beim Rendern der Vorlage nicht gesendet. Dieser Ereignistyp kann auftreten, wenn Vorlagendaten fehlen oder die Vorlagenparameter nicht mit den Daten übereinstimmen. (Dieser Ereignistyp tritt nur auf, wenn Sie E-Mails mit den SendBulkTemplatedEmailAPIOperationen SendTemplatedEmailoder senden.)

• Ablehnen — Amazon SES akzeptierte die E-Mail, stellte jedoch fest, dass sie einen Virus enthielt, und versuchte nicht, sie an den E-Mail-Server des Empfängers zuzustellen.

• Lieferung — Amazon SES hat die E-Mail erfolgreich an den E-Mail-Server des Empfängers zugestellt.

• Bounce – eine permanente Unzustellbarkeit, sodass die E-Mail vom E-Mail-Server des Empfängers dauerhaft abgelehnt wurde. (Soft Bounces sind nur enthalten, wenn nicht mehr versucht SES wird, die E-Mail zuzustellen. Im Allgemeinen deuten diese Soft Bounces auf einen Zustellungsfehler hin. In einigen Fällen kann ein Soft Bounce auch dann zurückgegeben werden, wenn die E-Mail den Posteingang des Empfängers erfolgreich erreicht hat. Dies tritt normalerweise auf, wenn der Empfänger eine out-of-office automatische Antwort sendet. In diesem AWS re:POST-Artikel erfährst du mehr über Soft Bounces.)

• Complaint (Beschwerde) – die E-Mail wurde erfolgreich an den E-Mail-Server des Empfängers gesendet, der Empfänger hat sie jedoch als Spam markiert.

• DeliveryDelay— Die E-Mail konnte nicht an den Mailserver des Empfängers zugestellt werden, da ein vorübergehendes Problem aufgetreten ist. Verzögerungen bei der Zustellung können, z. B. auftreten, wenn der Posteingang des Empfängers voll ist oder der empfangende E-Mail-Server ein vorübergehendes Problem aufweist.

• Subscription (Abonnement) – die E-Mail wurde erfolgreich zugestellt, aber der Empfänger hat die Abonnementeinstellungen aktualisiert, indem er auf List-Unsubscribe in der E-Mail-Kopfzeile oder auf den Unsubscribe-Link in der Fußzeile geklickt hat.

• Open (Geöffnet) – der Empfänger hat die Nachricht erhalten und sie in einem E-Mail-Client geöffnet.

• Click (Klick) – der Empfänger hat auf mindestens einen Link in der E-Mail geklickt.

Konfigurationssatz

Eine Reihe von Regeln, die das Ziel definieren, an das SES E-Mail-Sendeereignisse veröffentlicht werden, und die Arten von E-Mail-Sendeereignissen, die Sie veröffentlichen möchten. Wenn Sie eine E-Mail senden, die Sie mit der Ereignisveröffentlichung verwenden möchten, geben Sie den Konfigurationssatz an, der der E-Mail zugeordnet werden soll.

Ereignisziel

Ein AWS Dienst, für den Sie SES E-Mail-Versandereignisse veröffentlichen. Jedes eingerichtete Ereignisziel gehört zu einem einzigen Konfigurationssatz.

Nachrichten-Tag

Ein Name/Wert-Paar, mit dem Sie eine E-Mail zum Zweck der Ereignisveröffentlichung kategorisieren. Beispiele sind Kampagne/Buch und Kampagne/Bekleidung. Wenn Sie eine E-Mail senden, geben Sie das Nachrichten-Tag entweder als Parameter für den API Anruf oder als SES spezifischen E-Mail-Header an.

Automatisches Tag

Nachrichten-Tags, die automatisch in Berichten zur Ereignisveröffentlichung enthalten sind. Es gibt ein Auto-Tag für den Namen des Konfigurationssatzes, die Domäne der Absenderadresse, die ausgehende IP-Adresse des Anrufers, die SES ausgehende IP-Adresse und die IAM Identität des Anrufers.