Überwachen des E-Mail-Versands mithilfe der Amazon SES-Ereignisveröffentlichung

Damit Sie Ihren E-Mail-Versand detailliert verfolgen können, können Sie Amazon SES so einrichten, dass E-Mail-Versandereignisse auf Grundlage von von Ihnen definierten Merkmalen an Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint oder Amazon Simple Notification Service 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 SNS verwenden, um Ihnen Benachrichtigungen 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 SendEmailAPI-Vorgangs ein oder fügen das Nachrichten-Tag dem SES-spezifischen E-Mail-Header hinzu. X-SES-MESSAGE-TAGS Weitere Informationen zu Konfigurationssätzen finden Sie unter Verwenden von Konfigurationssätzen in Amazon SES.

Zusätzlich zu den Nachrichten-Tags, die Sie angeben, fügt Amazon SES auch automatische Tags zu den von Ihnen gesendeten Nachrichten hinzu. Sie müssen keine weiteren Schritte zum Verwenden der automatischen Tags durchführen.

In der folgenden Tabelle werden die automatischen Tags aufgelistet, die automatisch auf von Ihnen gesendete Nachrichten mit Amazon SES angewandt werden.

Automatische Tags von Amazon SES
Automatische Tag-Namen	Beschreibung
ses:caller-identity	Die IAM-Identität des Amazon 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, die Amazon SES zum Senden der E-Mail verwendet hat.
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.

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, hängt SES sie automatisch an den Feedback-ID Standard-Header an, der für die Bereitstellung von Zustellungsstatistiken wie Beschwerden und Spamraten als Teil einer Feedback-Schleife (FBL) verwendet wird, siehe. Feedback-Schleifen Der Feedback-ID Header besteht aus der Kennung sesInternalID, die von SES für die Erfassung von Beschwerdeinformationen verwendet wird, und dem statischen Tag AmazonSES, das SES als Versandplattform identifiziert, 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 ein Nachrichten-Tag hinzufügenses:feedback-id-<a or b>. X-SES-MESSAGE-TAGS

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 Verwendung der Amazon SES-Ereignisveröffentlichung benötigen.

• Einrichten der Ereignisveröffentlichung

• Arbeiten mit Ereignisdaten

Terminologie zu Ereignisveröffentlichung

In der folgenden Liste werden Begriffe im Zusammenhang mit der Amazon SES-Ereignisveröffentlichung definiert.

E-Mail-Sendeereignis

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

• Send (Senden) – die Sendeanfrage war erfolgreich und Amazon SES versucht, dem E-Mail-Server des Empfängers die Nachricht zuzustellen. (Wenn eine Unterdrückung auf Kontoebene oder eine globale Unterdrückung verwendet wird, zählt SES sie weiterhin als Senden, 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 eine E-Mail-Vorlage mithilfe der SendTemplatedEmail- oder SendBulkTemplatedEmail-API-Operationen senden.

• Rejects (Ablehnungen) – Amazon SES hat die E-Mail akzeptiert, aber festgestellt, dass sie einen Virus enthielt und nicht versucht hat, ihn an den Mail-Server des Empfängers zu übermitteln.

• Delivery (Zustellung) – Amazon SES hat die E-Mail erfolgreich an den Mail-Server des Empfängers übermittelt.

• Bounce – eine permanente Unzustellbarkeit, sodass die E-Mail vom E-Mail-Server des Empfängers dauerhaft abgelehnt wurde. (Soft Bounces sind nur enthalten, wenn SES nicht mehr versucht, die E-Mail zuzustellen. Im Allgemeinen deuten diese Soft Bounces auf einen Zustellungsfehler hin, obwohl in einigen Fällen ein Soft Bounce auch dann zurückgegeben werden kann, 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 Gruppe von Regeln, die das Ziel definiert, an dem Amazon SES E-Mail-Sendeereignisse veröffentlicht, und die Typen 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 Service, an den Sie Amazon SES 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, können Sie den Nachrichten-Tag entweder als Parameter für den API-Aufruf oder als Amazon SES-spezifischen E-Mail-Header angeben.

Automatisches Tag

Nachrichten-Tags, die automatisch in Berichten zur Ereignisveröffentlichung enthalten sind. Es gibt einen automatischen Tag für den Namen des Konfigurationssatzes, die Domäne der "From" (Von)-Adresse, die ausgehende IP-Adresse des Aufrufers, die ausgehende Amazon SES-IP-Adresse und die IAM-Identität des Aufrufers.