Verwenden von Vorlagen zum Senden personalisierter E-Mails mit Amazon SES API - Amazon Simple Email Service
Teil 1: Einrichten von BenachrichtigungenTeil 2: Erstellen einer E-Mail-VorlageTeil 3: Senden der personalisierten E-Mail

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.

Verwenden von Vorlagen zum Senden personalisierter E-Mails mit Amazon SES API

Sie können den CreateTemplateAPIVorgang verwenden, um E-Mail-Vorlagen zu erstellen. Diese Vorlagen enthalten eine Betreffzeile sowie den Text und HTML Teile des E-Mail-Textkörpers. Die Betreff- und Textabschnitte können auch eindeutige Werte enthalten, die für jeden Empfänger persönlich angepasst sind.

Es gibt einige Beschränkungen und andere Überlegungen bei der Verwendung dieser Funktionen:

  • Sie können jeweils bis zu 20.000 E-Mail-Vorlagen erstellen AWS-Region.

  • Jede Vorlage kann bis zu 500 KB groß sein, einschließlich Text und HTML Teilen.

  • Sie können eine unbegrenzte Anzahl an Ersetzungsvariablen in jede Vorlage einschließen.

  • Sie können bei jedem Aufruf der SendBulkTemplatedEmail-Operation E-Mails an bis zu 50 Zieladressen senden. Ein Ziel umfasst eine Liste von Empfängern, einschließlich CC und BCC Empfängern. Die Anzahl der Ziele, die Sie mit einem einzigen Anruf erreichen können, ist API möglicherweise durch die maximale Senderate Ihres Kontos begrenzt. Weitere Informationen finden Sie unter Verwalten Ihrer Amazon SES Versandkontingente.

Dieser Abschnitt enthält Verfahren zum Erstellen von E-Mail-Vorlagen und zum Senden von personalisierten E-Mails.

Anmerkung

Bei diesen Verfahren wird vorausgesetzt, dass Sie die AWS CLI bereits installiert und konfiguriert haben. Weitere Informationen zur Installation und Konfiguration von finden Sie im AWS Command Line Interface Benutzerhandbuch. AWS CLI

Teil 1: Einrichten von Benachrichtigungen über Rendering-Fehlerereignisse

Wenn Sie eine E-Mail senden, die ungültige Personalisierungsinhalte enthält, akzeptiert Amazon die Nachricht SES möglicherweise, kann sie aber nicht zustellen. Wenn Sie personalisierte E-Mails versenden möchten, sollten Sie Amazon SES daher so konfigurieren, dass Rendering Failure-Ereignisbenachrichtigungen über Amazon gesendet SNS werden. Wenn Sie eine Benachrichtigung über ein Rendering-Fehlerereignis erhalten, können Sie feststellen, welche Nachricht den ungültigen Inhalt enthalten hat, die Probleme beheben und die Nachricht erneut senden.

Das Verfahren in diesem Abschnitt ist optional, wird aber dringend empfohlen.

So konfigurieren Sie Benachrichtigungen über Rendering-Fehlerereignisse

  1. Erstellen Sie ein SNS Amazon-Thema. Anweisungen finden Sie unter Erstellen eines Themas im Amazon-Simple-Notification-Service-Entwicklerhandbuch.

  2. Abonnieren Sie das SNS Amazon-Thema. Beispiel: Wenn Sie Rendering-Fehlerbenachrichtigungen per E-Mail empfangen möchten, abonnieren Sie einen E-Mail-Endpunkt für das Thema.

    Anweisungen finden Sie unter Abonnieren eines Themas im Amazon Simple-Notification-Service-Entwicklerhandbuch.

  3. Gehen Sie wie unter beschrieben vorEinrichten eines Amazon SNS-Ereignisziels für die Ereignisveröffentlichung, um Ihre Konfigurationssätze für die Veröffentlichung von Rendering Failure-Ereignissen in Ihrem SNS Amazon-Thema einzurichten.

Teil 2: Erstellen einer E-Mail-Vorlage

In diesem Abschnitt verwenden Sie den CreateTemplate API Vorgang, um eine neue E-Mail-Vorlage mit Personalisierungsattributen zu erstellen.

Bei diesem Verfahren wird vorausgesetzt, dass Sie die AWS CLI bereits installiert und konfiguriert haben. Weitere Informationen zur Installation und Konfiguration von finden Sie im AWS Command Line Interface Benutzerhandbuch. AWS CLI

So erstellen Sie die Vorlage

  1. Erstellen Sie in einem Texteditor eine neue Datei. Fügen Sie folgenden Code in die Datei ein.

    {
  "Template": {
    "TemplateName": "MyTemplate",
    "SubjectPart": "Greetings, {{name}}!",
    "HtmlPart": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>",
    "TextPart": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}."
  }
}

    Dieser Code enthält die folgenden Eigenschaften:

    • TemplateName— Der Name der Vorlage. Beim Senden der E-Mail-Adresse beziehen Sie sich auf diesen Namen.

    • SubjectPart— Die Betreffzeile der E-Mail. Diese Eigenschaft kann Ersatz-Tags enthalten. Diese Tags verwenden das folgende Format: {{tagname}}. Wenn Sie die E-Mail senden, können Sie einen Wert für tagname für jede Zieladresse angeben.

      Das vorherige Beispiel umfasst zwei Tags: {{name}} und {{favoriteanimal}}.

    • HtmlPart— Der HTML Text der E-Mail. Diese Eigenschaft kann Ersatz-Tags enthalten.

    • TextPart— Der Textkörper der E-Mail. Empfänger, deren E-Mail-Clients keine HTML E-Mails anzeigen, sehen diese Version der E-Mail. Diese Eigenschaft kann Ersatz-Tags enthalten.

  2. Passen Sie das vorherige Beispiel an Ihre Bedürfnisse an und speichern Sie dann die Datei als mytemplate.json.

  3. Geben Sie in der Befehlszeile den folgenden Befehl ein, um mithilfe der CreateTemplate API Operation eine neue Vorlage zu erstellen:

    aws ses create-template --cli-input-json file://mytemplate.json

Teil 3: Senden der personalisierten E-Mail

Nach dem Erstellen einer E-Mail-Vorlage können Sie mit ihr eine E-Mail senden. Es gibt zwei API Operationen, mit denen Sie E-Mails mithilfe von Vorlagen versenden können:SendTemplatedEmail, undSendBulkTemplatedEmail. Dieser SendTemplatedEmail Vorgang ist nützlich, um eine benutzerdefinierte E-Mail an ein einzelnes Ziel zu senden (eine Sammlung von Empfängern mit den Begriffen „An“, „CC“ und BCC "", die dieselbe E-Mail erhalten). Der SendBulkTemplatedEmail Vorgang ist nützlich, um in einem einzigen Anruf beim Amazon eindeutige E-Mails an mehrere Ziele zu senden SESAPI. Dieser Abschnitt enthält Beispiele für die Verwendung von AWS CLI zum Senden von E-Mails mit diesen beiden Vorgängen.

Senden von E-Mail-Vorlagen an eine einzelne Zieladresse

Verwenden Sie die SendTemplatedEmail-Operation, um eine E-Mail an eine einzelne Zieladresse zu senden. Alle Empfänger im Destination-Objekt erhalten dieselbe E-Mail.

So senden Sie eine E-Mail-Vorlage an eine einzelne Zieladresse

  1. Erstellen Sie in einem Texteditor eine neue Datei. Fügen Sie folgenden Code in die Datei ein.

    {
  "Source":"Mary Major <mary.major@example.com>",
  "Template": "MyTemplate",
  "ConfigurationSetName": "ConfigSet",
  "Destination": {
    "ToAddresses": [ "alejandro.rosalez@example.com"
    ]
  },
  "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }"
}

    Dieser Code enthält die folgenden Eigenschaften:

    • Source – Die E-Mail-Adresse des Absenders.

    • Template – Der Name der Vorlage, die auf die E-Mail angewendet werden soll.

    • ConfigurationSetName— Der Name des Konfigurationssatzes, der beim Senden der E-Mail verwendet werden soll.

      Anmerkung

      Wir empfehlen Ihnen, einen Konfigurationssatz zu verwenden, der so konfiguriert ist, dass Rendering Failure-Ereignisse auf Amazon veröffentlicht SNS werden. Weitere Informationen finden Sie unter Teil 1: Einrichten von Benachrichtigungen über Rendering-Fehlerereignisse.

    • Destination – Die Empfängeradressen. Sie können mehrere „An“ -, „CC“ - und "BCC" Adressen angeben. Wenn Sie die SendTemplatedEmail-Operation verwenden, erhalten alle Empfänger die gleiche E-Mail.

    • TemplateData— Eine JSON Escape-Zeichenfolge, die Schlüssel-Wert-Paare enthält. Die Schlüssel entsprechen den Variablen in der Vorlage (zum Beispiel {{name}}). Die Werte stellen den Inhalt dar, der die Variablen in der E-Mail ersetzt.

  2. Ändern Sie die Werte im obigen Code Ihren Bedürfnissen entsprechend ab, und speichern Sie die Datei anschließend unter myemail.json.

  3. Geben Sie den folgenden Befehl in der Befehlszeile ein, um die E-Mail zu senden:

    aws ses send-templated-email --cli-input-json file://myemail.json

Senden von E-Mail-Vorlagen an mehrere Zieladressen

Sie können den SendBulkTemplatedEmail Vorgang verwenden, um in einem einzigen Anruf an die eine E-Mail an mehrere Ziele zu senden. API Amazon SES sendet in jedem Destination Objekt eine eindeutige E-Mail an den oder die Empfänger.

So senden Sie eine E-Mail-Vorlage an mehrere Zieladressen

  1. Erstellen Sie in einem Texteditor eine neue Datei. Fügen Sie folgenden Code in die Datei ein.

    {
  "Source":"Mary Major <mary.major@example.com>",
  "Template":"MyTemplate",
  "ConfigurationSetName": "ConfigSet",
  "Destinations":[
    {
      "Destination":{
        "ToAddresses":[
          "anaya.iyengar@example.com"
        ]
      },
      "ReplacementTemplateData":"{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }"
    },
    {
      "Destination":{ 
        "ToAddresses":[
          "liu.jie@example.com"
        ]
      },
      "ReplacementTemplateData":"{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }"
    },
    {
      "Destination":{
        "ToAddresses":[
          "shirley.rodriguez@example.com"
        ]
      },
      "ReplacementTemplateData":"{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }"
    },
    {
      "Destination":{
        "ToAddresses":[
          "richard.roe@example.com"
        ]
      },
      "ReplacementTemplateData":"{}"
    }
  ],
  "DefaultTemplateData":"{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }"
}

    Dieser Code enthält die folgenden Eigenschaften:

    • Source – Die E-Mail-Adresse des Absenders.

    • Template – Der Name der Vorlage, die auf die E-Mail angewendet werden soll.

    • ConfigurationSetName— Der Name des Konfigurationssatzes, der beim Senden der E-Mail verwendet werden soll.

      Anmerkung

      Wir empfehlen Ihnen, einen Konfigurationssatz zu verwenden, der so konfiguriert ist, dass Rendering Failure-Ereignisse auf Amazon veröffentlicht SNS werden. Weitere Informationen finden Sie unter Teil 1: Einrichten von Benachrichtigungen über Rendering-Fehlerereignisse.

    • Destinations – Ein Array mit einer oder mehreren Zieladressen.

      • Destination – Die Empfängeradressen. Sie können mehrere „An“ -, „CC“ - und "BCC" Adressen angeben. Wenn Sie die SendBulkTemplatedEmail-Operation verwenden, erhalten alle Empfänger innerhalb desselben Destination-Objekts die gleiche E-Mail.

      • ReplacementTemplateData— Ein JSON Objekt, das Schlüssel-Wert-Paare enthält. Die Schlüssel entsprechen den Variablen in der Vorlage (zum Beispiel {{name}}). Die Werte stellen den Inhalt dar, der die Variablen in der E-Mail ersetzt.

    • DefaultTemplateData— Ein JSON Objekt, das Schlüssel-Wert-Paare enthält. Die Schlüssel entsprechen den Variablen in der Vorlage (zum Beispiel {{name}}). Die Werte stellen den Inhalt dar, der die Variablen in der E-Mail ersetzt. Das Objekt enthält Fallback-Daten. Wenn ein Destination Objekt ein leeres JSON Objekt in der ReplacementTemplateData Eigenschaft enthält, werden die Werte in der DefaultTemplateData Eigenschaft verwendet.

  2. Ändern Sie die Werte im obigen Code Ihren Bedürfnissen entsprechend ab, und speichern Sie die Datei anschließend unter mybulkemail.json.

  3. Geben Sie den folgenden Befehl in der Befehlszeile ein, um die Massen-E-Mail zu senden:

    aws ses send-bulk-templated-email --cli-input-json file://mybulkemail.json