Verwenden von Listenverwaltung

Um eine Kontaktliste mit dem zu erstellen AWS CLI

• Geben Sie in der Befehlszeile folgenden Befehl ein:

  aws sesv2 create-contact-list --cli-input-json file://CONTACT-LIST-JSON

  Ersetzen Sie es im vorherigen Befehl CONTACT-LIST-JSON durch den Pfad zu Ihrer JSON-Datei für Ihre CreateContactListAnfrage.

  Eine Beispielhafte CreateContactList-Eingabe-JSON-Datei für die Anforderung ist wie folgt:

  {
      "ContactListName": "ExampleContactListName",
      "Description": "Creating a contact list example",
      "Topics": [
       {
           "TopicName": "Sports",
           "DisplayName": "Sports Newsletter",
           "Description": "Sign up for our free newsletter to receive updates on all sports.",
           "DefaultSubscriptionStatus": "OPT_OUT"
       },
       {
           "TopicName": "Cycling",
           "DisplayName": "Cycling newsletter",
           "Description": "Never miss a cycling update by subscribing to our newsletter.",
           "DefaultSubscriptionStatus": "OPT_IN"
       },
       {
           "TopicName": "NewProducts",
           "DisplayName": "New products",
           "Description": "Hear about new products by subscribing to this mailing list.",
           "DefaultSubscriptionStatus": "OPT_IN"
       },
       {
           "TopicName": "DailyUpdates",
           "DisplayName": "Daily updates",
           "Description": "Start your day with sport updates, Monday through Friday.",
           "DefaultSubscriptionStatus": "OPT_OUT"
       }
      ]
  }

Um einen Kontakt mit dem zu erstellen AWS CLI

• Geben Sie in der Befehlszeile folgenden Befehl ein:

  aws sesv2 create-contact --cli-input-json file://CONTACT-JSON

  Ersetzen Sie es im vorherigen Befehl CONTACT-JSON durch den Pfad zu Ihrer JSON-Datei für Ihre CreateContactAnfrage.

  Eine Beispielhafte CreateContact-Eingabe-JSON-Datei für die Anforderung ist wie folgt:

  {
      "ContactListName": "ExampleContactListName",
      "EmailAddress": "example@amazon.com",
      "UnsubscribeAll": false,
      "TopicPreferences": [
          {
              "TopicName": "Sports",
              "SubscriptionStatus": "OPT_IN"
          }
      ],
      "AttributesData": "{\"Name\": \"John\", \"Location\": \"Seattle\"}"
  }

  Im obigen Beispiel zeigt ein UnsubscribeAll-Wert von falsean, dass sich der Kontakt nicht von allen Themen abgemeldet hat, wobei der Wert true bedeuten würde, dass sich der Kontakt von allen Themen abgemeldet hat.

  TopicPreferences enthält Informationen zum Abonnementstatus des Kontakts für Themen. Im vorangegangenen Beispiel hat sich der Kontakt für das Thema „Sport“ entschieden und erhält alle E-Mails zum Thema „Sport“.

  AttributesData ist ein JSON-Feld, in dem Sie beliebige Metadaten über unseren Kontakt einfügen können. Es muss ein gültiges JSON-Objekt sein.

1. Kontakte auflisten mit dem AWS CLI — Sie können den ListContactsVorgang verwenden, um in Verbindung mit dem SendEmailVorgang eine Liste all Ihrer Kontakte abzurufen, die ein bestimmtes Thema abonniert haben, sodass Sie ihnen E-Mails senden können.

   Geben Sie in der Befehlszeile folgenden Befehl ein:

   aws sesv2 list-contacts --cli-input-json file://LIST-CONTACTS-JSON

   Ersetzen Sie dies im vorherigen Befehl LIST-CONTACTS-JSON durch den Pfad zu Ihrer JSON-Datei für Ihre ListContactsAnfrage.

   Eine Beispielhafte ListContacts-Eingabe-JSON-Datei für die Anforderung ist wie folgt:

   {
       "ContactListName": "ExampleContactListName",
       "Filter": {
           "FilteredStatus": "OPT_IN",
           "TopicFilter": {
               "TopicName": "Cycling",
               "UseDefaultIfPreferenceUnavailable": true
           }
       },
       "PageSize": 50
   }

   FilteredStatus zeigt den Abonnementstatus an, auf den Sie filtern möchten, der entweder OPT_INoder OPT_OUT ist.

   TopicFilter ist ein optionaler Filter, der angibt, für welches Thema Sie Ergebnisse wünschen. Im obigen Beispiel ist das „Radfahren“.

   UseDefaultIfPreferenceUnavailable kann den Wert true oder false aufweisen. Wenntrue, wird die Standardeinstellung des Themas verwendet, wenn der Kontakt keine explizite Präferenz für ein Thema hat. Wennfalseauswählen, werden nur Kontakte mit einer explizit festgelegten Voreinstellung für die Filterung berücksichtigt.

2. E-Mail mit ListManagementOptions aktiviert senden – nachdem Sie die Kontakte in Ihrer Liste mit der oben genannten ListContacts-Operation aufgelistet haben, können Sie mit der SendEmail-Operation E-Mails an jeden Ihrer Kontakte senden, indem Sie den ListManagementOptions-Header verwenden, um Ihre Kontaktliste und Ihren Themennamen anzugeben.

   Wenn Sie ListManagementOptions mit der SendEmail-Operation verwenden möchten, schließen Sie contactListName und topicName zu der die E-Mail gehört (der topicName ist optional) ein:

   
   ListManagementOptions:
       String contactListName
       String topicName
                   

   Wenn Sie ListManagementOptions in Ihre SendEmail-Anfrage an eine Empfänger-E-Mail-Adresse einfügen, die nicht in Ihrer Kontaktliste enthalten ist, wird automatisch ein Kontakt in Ihrer Liste erstellt.

   SES gibt ein Bounce-Ereignis für eine Nachricht aus, die an einen Kontakt auf Ihrer Kontaktliste gesendet wird, der sich nicht angemeldet hat. Das bedeutet, dass Sie Ihre SendEmail Anfragen nicht aktualisieren müssen, um zu vermeiden, dass sie an Kontakte gesendet werden, die sich abgemeldet haben.

3. Geben Sie den Speicherort für Ihre Abmeldelinks an — Wenn Sie diese Option verwenden, haben ListManagementOptionsSie die Möglichkeit, SES zu ermöglichen, Ihrer E-Mail Fußzeilenlinks zum Abbestellen hinzuzufügen. Verwenden Sie dazu den {{amazonSESUnsubscribeUrl}} Platzhalter, um anzugeben, wo SES die Abmelde-URL einfügen muss. Der Austausch von Platzhaltern wird nur für HTML- und TEXT-Typen unterstützt. Sie können den Platzhalter maximal zwei Mal einschließen. Bei mehrfacher Verwendung werden nur die ersten beiden Vorkommen ersetzt. Weitere Informationen finden Sie unter Abonnementverwaltung.

   Sie können aber auch den X-SES-LIST-MANAGEMENT-OPTIONS-Header verwenden, um beim Senden von E-Mails über die SMTP-Schnittstelle eine Liste und einen Themennamen anzugeben.

   Um beim Senden von E-Mails über die SMTP-Schnittstelle eine Liste und ein Thema anzugeben, fügen Sie der Nachricht den folgenden E-Mail-Header hinzu:

   X-SES-LIST-MANAGEMENT-OPTIONS: {contactListName}; topic={topicName}