Einrichten einer Domäne für die Verarbeitung der Umleitungen von Öffnungs- und Klicklinks Angabe Ihrer benutzerdefinierten Weiterleitungsdomäne und HTTPS -richtlinie Spezifizierung der Ereignistypen Öffnen und Klicken

Konfigurieren von benutzerdefinierten Domänen zur Verarbeitung der Öffnungs- und Klicknachverfolgung

Wenn Sie Ereignisse veröffentlichen, um Ereignisse zu erfassen, die geöffnet und angeklickt wurden, SES nimmt Amazon geringfügige Änderungen an den von Ihnen gesendeten E-Mails vor. Um offene Ereignisse zu erfassen, SES fügt jeder gesendeten E-Mail ein transparentes GIF Bild von 1 Pixel x 1 Pixel hinzu, SES das einen eindeutigen Dateinamen für jede E-Mail enthält. Es wird auf einem Server gehostet, der vonSES; wenn das Bild heruntergeladen wird, SES kann genau erkennen, welche Nachricht geöffnet wurde und von wem.

Standardmäßig wird dieses Pixel am Ende der E-Mail eingefügt. Die Anwendungen einiger E-Mail-Anbieter beschneiden jedoch die Vorschau einer E-Mail, wenn sie eine bestimmte Größe überschreitet, und stellen möglicherweise einen Link zur Anzeige der restlichen Nachricht zur Verfügung. In diesem Szenario wird das SES Pixel-Tracking-Bild nicht geladen und die Öffnungsraten, die Sie verfolgen möchten, werden dadurch beeinträchtigt. Um dies zu umgehen, können Sie das Pixel optional an den Anfang der E-Mail oder an eine andere Stelle setzen, indem Sie den Platzhalter {{ses:openTracker}} in den E-Mail-Text einfügen. Sobald die Nachricht mit dem Platzhalter SES empfangen wurde, wird sie durch ein offenes Tracking-Pixelbild ersetzt.

Wichtig

Alle {{ses:openTracker}} Platzhalter, die mehr als einen Platzhalter enthalten, werden beim Absenden von entfernt. SES
Fügen Sie nur einen {{ses:openTracker}} Platzhalter hinzu, wenn Sie ihn in einer E-Mail-Vorlage verwenden, da mehrere Platzhalter dazu führen, dass ein 400 BadRequestException Fehlercode zurückgegeben wird.

Um Ereignisse mit Linkklicks zu erfassen, werden die Links in Ihren E-Mails durch Links zu einem Server SES ersetzt, der von SES betrieben wird. Dadurch wird der Empfänger sofort an sein ausgewähltes Ziel weitergeleitet. Die Gesamtgröße der Header, einschließlich Cookies, der Anfragen an diesen Server darf 8192 Byte nicht überschreiten, andernfalls wird ein 400 BadRequestException Fehlercode zurückgegeben.

Sie haben auch die Möglichkeit, Ihre eigenen Domains anstelle von Domains zu verwenden, die Eigentum sind und von denen diese betrieben werdenSES, um Ihren Empfängern ein einheitlicheres Erlebnis zu bieten, d. h. alle SES Indikatoren werden entfernt. Sie können mehrere benutzerdefinierte Domänen konfigurieren, um Öffnungs- und Klicknachverfolgungsereignisse zu verarbeiten. Diese benutzerdefinierten Domänen stehen im Zusammenhang mit Konfigurationssätzen. Wenn Sie eine E-Mail mit einem Konfigurationssatz senden und wenn dieser Konfigurationssatz für die Verwendung einer benutzerdefinierten Domäne konfiguriert ist, verwenden die Öffnungs- und Klicklinks in dieser E-Mail automatisch die benutzerdefinierte Domäne, die in diesem Konfigurationssatz angegeben ist.

Dieser Abschnitt enthält Verfahren zum Einrichten einer Subdomain auf einem Server, den Sie besitzen, um Benutzer automatisch zu den Servern weiterzuleiten, von denen das Öffnen und das Klicken verfolgt werden. SES Die Einrichtung dieser Domänen umfasst drei Schritte. Zuerst konfigurieren Sie die Subdomäne selbst. Dann legen Sie einen Konfigurationssatz zur Verwendung der benutzerdefinierten Domäne fest. Anschließend legen Sie das Ereignisziel zur Veröffentlichung von Öffnungs- und Klickereignissen fest. In diesem Abschnitt werden Verfahren für alle drei Schritte beschrieben.

Wenn Sie jedoch einfach die Öffnungs- oder Klicknachverfolgung aktivieren möchten, ohne eine benutzerdefinierte Domäne einzurichten, können Sie direkt mit der Definition von Ereigniszielen für Ihren Konfigurationssatz fortfahren. Dies ermöglicht die Ereignisveröffentlichung, die bei den angegebenen Ereignistypen ausgelöst wird, einschließlich Öffnungs- und Klickereignissen. Ein Konfigurationssatz kann über mehrere Ereignisziele mit mehreren Ereignistypen verfügen. Siehe SESAmazon-Veranstaltungsziele erstellen.

Teil 1: Einrichten einer Domäne für die Verarbeitung der Umleitungen von Öffnungs- und Klicklinks

Die spezifischen Verfahren für die Einrichtung einer Weiterleitungsdomain hängen von Ihrem Webhosting-Anbieter (und Ihrem Content Delivery Network, falls Sie einen HTTPS Server verwenden) ab. Die Verfahren in den folgenden Abschnitten bieten allgemeine Richtlinien und nicht bestimmte Schritte.

Option 1: Konfiguration einer HTTP Domain

Wenn Sie planen, eine HTTP Domain für Links zum Öffnen und Klicken zu verwenden (im Gegensatz zu einer HTTPS Domain), umfasst der Prozess zur Konfiguration der Subdomain nur wenige Schritte.

Anmerkung

Wenn Sie eine benutzerdefinierte Domain einrichten, die das HTTP Protokoll verwendet, und Sie eine E-Mail senden, die Links enthält, die das HTTPS Protokoll verwenden, wird Ihren Kunden möglicherweise eine Warnmeldung angezeigt, wenn sie auf die Links in Ihrer E-Mail klicken. Wenn Sie E-Mails versenden möchten, die Links enthalten, die das HTTPS Protokoll verwenden, sollten Sie eine HTTPS Domain für die Behandlung von Click-Tracking-Ereignissen verwenden.

Um eine HTTP Subdomain für den Umgang mit Links zum Öffnen und Klicken einzurichten

Erstellen Sie eine Subdomäne zur Verwendung für Öffnungs- und Klicknachverfolgungs-Links. SESempfiehlt, dass diese Subdomain speziell für den Umgang mit diesen Links vorgesehen ist und dass für jede versendete E-Mail, die AWS-Region Sie verfolgen möchten, eine Subdomain erstellt wird.
Überprüfen Sie die Subdomain für die Verwendung mit. SES Weitere Informationen finden Sie unter Erstellen einer Domänenidentität.

Fügen Sie den DNS Einstellungen Ihrer Subdomain einen neuen CNAME Eintrag hinzu, der Anfragen an die SES Tracking-Domain weiterleitet. Die Adresse, an die Sie weiterleiten, muss mit Ihrer benutzerdefinierten AWS-Region Subdomain identisch sein.

Die folgende Tabelle enthält eine Liste der Tracking-Domains für den Bereich „ AWS-Regionen Wo verfügbar“. Wählen Sie die Domain aus, die sich in derselben Region wie Ihre benutzerdefinierte Domain SES befindet:

AWS Region	AWS Domain verfolgen
US East (Ohio)	`r.us-east-2.awstrack.me`
USA Ost (Nord-Virginia)	`r.us-east-1.awstrack.me`
USA West (Nordkalifornien)	`r.us-west-1.awstrack.me`
USA West (Oregon)	`r.us-west-2.awstrack.me`
Afrika (Kapstadt)	`r.af-south-1.awstrack.me`
Asien-Pazifik (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asien-Pazifik (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pacific (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seoul)	`r.ap-northeast-2.awstrack.me`
Asien-Pazifik (Singapur)	`r.ap-southeast-1.awstrack.me`
Asien-Pazifik (Sydney)	`r.ap-southeast-2.awstrack.me`
Asien-Pazifik (Jakarta)	r.ap-southeast-3.awstrack.me
Asien-Pazifik (Jakarta)	r.ap-southeast-3.awstrack.me
Asien-Pazifik (Tokio)	`r.ap-northeast-1.awstrack.me`
Canada (Central)	`r.ca-central-1.awstrack.me`
Europe (Frankfurt)	`r.eu-central-1.awstrack.me`
Europa (Irland)	`r.eu-west-1.awstrack.me`
Europa (London)	`r.eu-west-2.awstrack.me`
Europa (Milan)	`r.eu-south-1.awstrack.me`
Europa (Stockholm)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Naher Osten (Bahrain)	`r.me-south-1.awstrack.me`
Südamerika (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (US-West)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (US-Ost)	`r.us-gov-east-1.awstrack.me`

Anmerkung

Je nach Ihrem Webhosting-Anbieter kann es mehrere Minuten dauern, bis die Änderungen, die Sie am DNS Datensatz der Subdomain vornehmen, wirksam werden. Ihr Webhosting-Anbieter oder die IT-Organisation kann weitere Informationen zu diesen Verzögerungen bereitstellen.

Option 2: Konfiguration einer Domain HTTPS

Sie können eine HTTPS Domain auch zur Nachverfolgung von Öffnungs- und Linkklicks verwenden. Um eine HTTPS Domain für die Erfassung geöffneter Klicks und Linkklicks einzurichten, müssen Sie einige zusätzliche Schritte ausführen, die über die für die Einrichtung einer HTTP Domain erforderlichen Schritte hinausgehen.

Um eine HTTPS Subdomain für den Umgang mit Links zum Öffnen und Klicken einzurichten

Erstellen Sie eine Subdomäne zur Verwendung für Öffnungs- und Klicknachverfolgungs-Links. SESempfiehlt, dass diese Subdomain speziell für den Umgang mit diesen Links vorgesehen ist und dass für jede versendete E-Mail, die AWS-Region Sie verfolgen möchten, eine Subdomain erstellt wird.
Überprüfen Sie die Subdomain für die Verwendung mit. SES Weitere Informationen finden Sie unter Erstellen einer Domänenidentität.
Erstellen Sie ein neues Konto bei einem Content Delivery Network (CDN), z. B. Amazon CloudFront, siehe Erste Schritte mit einer CloudFront Basisdistribution.

Konfigurieren Sie CDN den Ursprung, bei dem es sich um die SES Tracking-Domain handelt, wie r.us-east-1.awstrack.me zum Beispiel. Das CDN muss auf die AWS Tracking-Domain verweisen, die sich in derselben Region wie Ihre benutzerdefinierte Domain befindet. Sie CDN müssen den vom Anforderer bereitgestellten Host Header an den Ursprung weitergeben. Weitere Informationen finden Sie in diesem AWS Re:POST-Artikel.

Die folgende Tabelle enthält eine Liste der Tracking-Domains für den AWS-Regionen Ort, an dem verfügbar SES ist. Wählen Sie die Domain aus, die sich in derselben Region wie Ihre benutzerdefinierte Domain befindet:

AWS Region	AWS Domain verfolgen
US East (Ohio)	`r.us-east-2.awstrack.me`
USA Ost (Nord-Virginia)	`r.us-east-1.awstrack.me`
USA West (Nordkalifornien)	`r.us-west-1.awstrack.me`
USA West (Oregon)	`r.us-west-2.awstrack.me`
Afrika (Kapstadt)	`r.af-south-1.awstrack.me`
Asien-Pazifik (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asien-Pazifik (Mumbai)	`r.ap-south-1.awstrack.me`
Asia Pacific (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seoul)	`r.ap-northeast-2.awstrack.me`
Asien-Pazifik (Singapur)	`r.ap-southeast-1.awstrack.me`
Asien-Pazifik (Sydney)	`r.ap-southeast-2.awstrack.me`
Asien-Pazifik (Tokio)	`r.ap-northeast-1.awstrack.me`
Canada (Central)	`r.ca-central-1.awstrack.me`
Europe (Frankfurt)	`r.eu-central-1.awstrack.me`
Europa (Irland)	`r.eu-west-1.awstrack.me`
Europa (London)	`r.eu-west-2.awstrack.me`
Europa (Milan)	`r.eu-south-1.awstrack.me`
Europa (Stockholm)	`r.eu-north-1.awstrack.me`
Israel (Tel Aviv)	`r.il-central-1.awstrack.me`
Naher Osten (Bahrain)	`r.me-south-1.awstrack.me`
Südamerika (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (USA, Westen)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (US-Ost)	`r.us-gov-east-1.awstrack.me`

Wenn Sie Route 53 zur Verwaltung der DNS Konfiguration für Ihre Domain und CloudFront als Ihre verwendenCDN, erstellen Sie in Route 53 einen Aliaseintrag, der auf Ihre CloudFront Distribution verweist (z. B. d111111abcdef8.cloudfront.net). Für weitere Informationen sehe Sie Erstellen von Datensätzen mithilfe der Amazon-Route-53-Konsole im Amazon Route 53-Entwicklerhandbuch.

Andernfalls fügen Sie in der DNS Konfiguration für Ihre Subdomain einen Datensatz hinzu, der sich auf die Adresse Ihrer bezieht. CNAME CDN
Erwerben Sie ein SSL Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle. Das Zertifikat sollte sowohl die Subdomain abdecken, die Sie in Schritt 1 erstellt haben, als auch die Subdomain, die CDN Sie in den Schritten 3—5 konfiguriert haben. Laden Sie das Zertifikat auf die hoch. CDN
Sie können den folgenden curl-Befehl verwenden, um zu überprüfen, ob Ihre neu erstellte benutzerdefinierte Domain die richtige Region und das richtige HTTPS Protokoll verwendet. Im folgenden Beispiel ist bis auf den Namen Ihrer Domain alles wörtlich:
```
curl --head https://custom.domain.com/favicon.ico
```
Eine Antwort wird wie im folgenden Beispiel zurückgegeben:
```
(python-sdk-test) jdoe@12a34567b89c BaconRedirectService % curl --head https://custom.domain.com/favicon.ico
HTTPS/1.1 200 OK
x-amz-ses-region: us-east-1
x-amz-ses-request-protocol: https
Content-Type: image/x-icon
Transfer-Encoding: chunked
Date: Fri, 30 Aug 2024 13:50:14 GMT
```
Diese Antwort enthält die folgenden Eigenschaften:
- Der x-amz-request-region Header-Wert ist die SES Region, die die Anfrage erhalten hat.
- Der x-amz-request-protocol Header-Wert ist das Protokoll, das für die Anfrage zwischen CDN und SES im Header verwendet wird.
Wenn Ihre Konfiguration korrekt ist, sollte die Region die Region widerspiegeln, in der Ihre Domain erstellt wurde, und das Protokoll sollte es seinHTTPS.

Teil 2: Spezifizieren Sie Ihre benutzerdefinierte Weiterleitungsdomäne und HTTPS -richtlinie mithilfe eines Konfigurationssatzes

Nachdem Sie Ihre Domain für die Verarbeitung von Weiterleitungen zum Öffnen und Klicken konfiguriert haben, müssen Sie Ihre benutzerdefinierte Domain und HTTPS Richtlinie in einem Konfigurationssatz angeben.

Wenn Sie eine E-Mail mit einem Konfigurationssatz senden und dieser Konfigurationssatz für die Verwendung einer benutzerdefinierten Weiterleitungsdomäne konfiguriert ist, verwenden die Links zum Öffnen und Klicken in dieser E-Mail automatisch die im Konfigurationssatz angegebenen benutzerdefinierten Domänen- und HTTPS Richtlinienoptionen.

Sie können dies über die SES Konsole oder den CreateConfigurationSetAPIv2-Vorgang abschließen.

So geben Sie mithilfe der Konsole eine benutzerdefinierte Umleitungsdomäne und HTTPS -richtlinie an

Verwenden Sie beim Erstellen oder Bearbeiten eines Konfigurationssatzes die Tracking-Optionen in Schritt 4 vonErstellen Sie einen Konfigurationssatz., um Ihre benutzerdefinierte Weiterleitungsdomäne und HTTPS Richtlinienoptionen anzugeben.

Um eine benutzerdefinierte Umleitungsdomäne und eine benutzerdefinierte HTTPS Richtlinie für die Weiterleitung anzugeben, verwenden Sie AWS CLI

Sie können den CreateConfigurationSetVorgang in Version 2 verwenden SES API und die TrackingOptions Eigenschaft verwenden, um Ihre benutzerdefinierte Umleitungsdomäne und die HTTPS Richtlinie anzugeben. Sie können diesen Vorgang von der aus aufrufen, AWS CLI wie im folgenden Beispiel gezeigt.

Erstellen Sie den Konfigurationssatz AWS-Region dort, wo Sie E-Mails senden und verfolgen möchten:
```
aws sesv2 create-configuration-set --cli-input-json file://create.json
```
In diesem Beispiel verwendet die Eingabedatei Parameter der TrackingOptionsEigenschaft — CustomRedirectDomain gibt die benutzerdefinierte Domain an, die für die Nachverfolgung von geöffneten und geklickten Links verwendet werden soll, und HttpsPolicy gibt eine HTTPS Richtlinienoption an:
```
{
    "ConfigurationSetName": "my-config-set",
    "TrackingOptions": {
        "CustomRedirectDomain": "marketing.example.com",
        "HttpsPolicy": "REQUIRE"
    },
    "SendingOptions": {
        "SendingEnabled": true
    }
}
```
Für den HttpsPolicy Parameter können die folgenden Werte angegeben werden, um das Protokoll der Tracking-Links zum Öffnen und Klicken für Ihre benutzerdefinierte Weiterleitungsdomäne festzulegen:
- OPTIONAL— (Standardverhalten) Offene Tracking-Links werden mit umschlossenHTTP. Links zur Klickverfolgung werden unter Verwendung des Originalprotokolls des Links umschlossen.
- REQUIRE— Links zum Öffnen und Klicken werden beide mit umschlossenHTTPS.
- REQUIRE_OPEN_ONLY— Offene Tracking-Links werden mit umschlossenHTTPS. Links zur Klickverfolgung werden unter Verwendung des Originalprotokolls des Links verpackt.

Teil 3: Spezifizierung der Ereignistypen „Öffnen“ und „Klicken“ mithilfe eines Konfigurationssatzes

Nachdem Sie Ihre benutzerdefinierte Domäne und HTTPS Richtlinie im Konfigurationssatz im vorherigen Schritt angegeben haben, müssen Sie die Ereignistypen für das Öffnen und/oder Klicken angeben, die in einem Ereignisziel über einen Konfigurationssatz nachverfolgt werden sollen.

Sie können dies mithilfe der SES Konsole oder der CreateConfigurationSetEventDestinationAPIv2-Operation abschließen.

So wählen Sie mithilfe der Konsole die Ereignistypen Öffnen und/oder Klicken aus

Verwenden Sie beim Erstellen oder Ändern eines Veranstaltungsziels die Option Öffnen und Klicken Sie in Schritt 6 von auf Tracking Erstellen eines Ereignisziels, um die Ereignistypen anzugeben.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

IP-Pols zuweisen

Festlegen von Konfigurationssätzen für E-Mails