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.
Konfigurieren von benutzerdefinierten Domänen zur Verarbeitung der Öffnungs- und Klicknachverfolgung
Wenn Sie die Ereignisveröffentlichung verwenden, um Öffnungs- und Klickereignisse zu erfassen, nimmt Amazon SES kleinere Änderungen an den von Ihnen gesendeten E-Mails vor. Zum Erfassen von Öffnungsereignissen fügt SES in jeder über SES gesendeten E-Mail ein transparentes GIF-Bild mit einer Breite und Höhe von jeweils 1 Pixel ein, das einen eindeutigen Dateinamen für jede E-Mail enthält und auf einem von SES betriebenen Server gehostet wird. Wenn das Bild heruntergeladen wird, kann SES genau feststellen, welche Nachricht von wem geöffnet wurde.
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-Pixelbild zur Nachverfolgung nicht geladen und verfälscht die Öffnungsraten, die Sie nachverfolgen möchten. 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 SES die Nachricht mit dem Platzhalter empfängt, wird sie durch ein Pixelbild zur Nachverfolgung von Öffnungen ersetzt.
Wichtig
-
Alle
{{ses:openTracker}}Platzhalter, die größer als eins sind, werden beim Senden durch SES entfernt. -
Fügen Sie nur einen
{{ses:openTracker}}Platzhalter hinzu, wenn Sie ihn in einer E-Mail-Vorlage verwenden, da bei mehr als einem Platzhalter ein400 BadRequestExceptionFehlercode zurückgegeben wird.
Um Ereignisse zu erfassen, die auf Links geklickt werden, ersetzt SES die Links in Ihren E-Mails durch Links zu einem von SES betriebenen Server. Dadurch wird der Empfänger sofort an sein ausgewähltes Ziel weitergeleitet. Die Gesamtgröße der Header, einschließlich Cookies, von 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 SES gehören und von SES betrieben werden, um Ihren Empfängern ein einheitlicheres Erlebnis zu bieten. Das bedeutet, dass alle SES-Indikatoren entfernt werden. 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 zur Einrichtung einer Subdomain auf einem Server, der Ihnen gehört, um Benutzer automatisch auf die von SES betriebenen Open-and-Click-Tracking-Server umzuleiten. 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 Erstellen von Amazon-SES-Ereigniszielen.
Teil 1: Einrichten einer Domäne für die Verarbeitung der Umleitungen von Öffnungs- und Klicklinks
Die spezifische Vorgehensweise zum Einrichten einer Umleitungsdomäne hängt vom Ihrem Webhosting-Anbieter (und Ihrem Netzwerk zur Bereitstellung von Inhalten, wenn Sie einen HTTPS-Server verwenden) ab. Die Verfahren in den folgenden Abschnitten bieten allgemeine Richtlinien und nicht bestimmte Schritte.
Option 1: Konfigurieren einer HTTP-Domäne
Wenn Sie vorhaben, eine HTTP-Domäne für die Verarbeitung von Öffnungs- und Klicklinks zu verwenden (im Gegensatz zu einer HTTPS-Domäne), umfasst der Konfigurationsvorgang für die Subdomäne nur ein paar Schritte.
Anmerkung
Wenn Sie eine benutzerdefinierte Domäne einrichten die das HTTP-Protokoll verwendet, und eine E-Mail mit Links senden, die das HTTPS-Protokoll verwendet, sehen Ihre Kunden möglicherweise eine Warnmeldung, wenn sie auf die Links in Ihrer E-Mail klicken. Wenn Sie vorhaben, E-Mails mit Links zu senden, die das HTTPS-Protokoll verwenden, sollten Sie eine HTTPS-Domäne für die Verarbeitung von Klicknachverfolgungsereignissen verwenden.
So richten Sie eine HTTP-Subdomäne für die Verarbeitung von Öffnungs- und Klicklinks ein
-
Erstellen Sie eine Subdomäne zur Verwendung für Öffnungs- und Klicknachverfolgungs-Links. SES empfiehlt, dass diese Subdomain speziell für die Verwaltung dieser Links vorgesehen ist und dass für jede E-Mail, die AWS-Region Sie verfolgen möchten, eine Subdomain erstellt wird.
-
Verifizieren 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 umleitet. Die Adresse, zu der Sie umleiten, muss mit Ihrer benutzerdefinierten AWS-Region Subdomain übereinstimmen.
-
Verwenden Sie die Tabelle Tracking-Domains in der Allgemeine AWS-Referenz , um die Tracking-Domain auszuwählen, die sich in derselben Region wie Ihre benutzerdefinierte Domain befindet.
Anmerkung
Abhängig von Ihrem Webhosting-Anbieter kann es einige Minuten dauern, bis die Änderungen, die Sie am DNS-Datensatz der Subdomäne vorgenommen haben, wirksam werden. Ihr Webhosting-Anbieter oder die IT-Organisation kann weitere Informationen zu diesen Verzögerungen bereitstellen.
-
Option 2: Konfigurieren einer HTTPS-Domäne
Sie können auch eine HTTPS-Domain verwenden, um Öffnungs- und Linkklicks zu verfolgen. Um eine HTTPS-Domain zum Nachverfolgen von Öffnungs- und Linkklicks einzurichten, müssen Sie einige zusätzliche Schritte ausführen, die über die für die Einrichtung einer HTTP-Domain erforderlichen hinausgehen.
So richten Sie eine HTTPS-Subdomäne für die Verarbeitung von Öffnungs- und Klicklinks ein
-
Erstellen Sie eine Subdomäne zur Verwendung für Öffnungs- und Klicknachverfolgungs-Links. SES empfiehlt, dass diese Subdomain speziell für die Verarbeitung dieser Links vorgesehen ist und dass für jede E-Mail, die AWS-Region Sie verfolgen möchten, eine Subdomain erstellt wird.
-
Verifizieren 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) wie Amazon CloudFront
. Weitere Informationen finden Sie unter Erste Schritte mit einer CloudFront Basisdistribution. -
Konfigurieren Sie das CDN für den Ursprung, der die SES-Tracking-Domain ist, wie zum Beispiel
r.us-east-1.awstrack.me. Das CDN muss auf die AWS Tracking-Domain verweisen, die sich in derselben Region wie Ihre benutzerdefinierte Domain befindet. Das CDN muss den vom Anforderer bereitgestelltenHostHeader an den Ursprung weiterleiten. Weitere Informationen finden Sie in diesem AWS re:POST-Artikel.-
Verwenden Sie die Tabelle Tracking-Domains in der Allgemeine AWS-Referenz , um die Tracking-Domain auszuwählen, die sich in derselben Region wie Ihre benutzerdefinierte Domain befindet.
-
-
Wenn Sie Route 53 zur Verwaltung der DNS-Konfiguration für Ihre Domain und CloudFront als CDN verwenden, erstellen Sie in Route 53 einen Alias-Datensatz, der sich auf Ihre CloudFront Distribution bezieht (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.
Fügen Sie andernfalls in der DNS-Konfiguration für Ihre Subdomäne einen CNAME-Datensatz hinzu, der sich auf die Adresse Ihres CDN bezieht.
-
Erwerben Sie ein SSL-Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle. Das Zertifikat sollte sowohl die Subdomäne, die Sie in Schritt 1 erstellt haben, als auch das CDN, das Sie in Schritt 3 bis 5 konfiguriert haben, abdecken. Laden Sie das Zertifikat in das CDN hoch.
-
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 alles bis auf den Namen Ihrer Domain ein Literal:
curl --head https://custom.domain.com/favicon.icoEine 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 GMTDiese Antwort enthält die folgenden Eigenschaften:
-
Der
x-amz-ses-regionHeader-Wert ist die SES-Region, die die Anfrage erhalten hat. -
Der
x-amz-ses-request-protocolHeader-Wert ist das Protokoll, das für die Anfrage zwischen dem CDN und SES im Header verwendet wird.
Wenn Ihr Setup korrekt ist, sollte die Region der Region entsprechen, in der Ihre Domain erstellt wurde, und das Protokoll sollte HTTPS sein.
-
Teil 2: Angabe Ihrer benutzerdefinierten Weiterleitungsdomäne und Ihrer 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 benutzerdefinierten Domänen- und HTTPS-Richtlinienoptionen, die im Konfigurationssatz angegeben sind.
Sie können dies mithilfe der SES-Konsole oder des CreateConfigurationSet v2-API-Vorgangs abschließen.
Um mithilfe der Konsole eine benutzerdefinierte Umleitungsdomäne und eine HTTPS-Richtlinie anzugeben
-
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 HTTPS-Richtlinie anzugeben, verwenden Sie die AWS CLI
Sie können den CreateConfigurationSet Vorgang in der SES-API v2 verwenden 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 in AWS-Region dem Ordner, an den 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—CustomRedirectDomaingibt die benutzerdefinierte Domain an, die für das Nachverfolgen von Links zum Öffnen und Klicken verwendet werden soll, undHttpsPolicygibt eine HTTPS-Richtlinienoption an:{ "ConfigurationSetName": "my-config-set", "TrackingOptions": { "CustomRedirectDomain": "marketing.example.com", "HttpsPolicy": "REQUIRE" }, "SendingOptions": { "SendingEnabled": true } }Für den
HttpsPolicyParameter können die folgenden Werte angegeben werden, um das Protokoll für das Öffnen und Klicken der Tracking-Links für Ihre benutzerdefinierte Weiterleitungsdomain festzulegen:-
OPTIONAL— (Standardverhalten) Offene Tracking-Links werden mit HTTP umschlossen. Links zur Klickverfolgung werden mit dem Originalprotokoll des Links verpackt. -
REQUIRE— Tracking-Links zum Öffnen und Klicken werden beide mit HTTPS umschlossen. -
REQUIRE_OPEN_ONLY— Offene Tracking-Links werden mit HTTPS verpackt. Links zur Klickverfolgung werden mit dem Originalprotokoll des Links verpackt.
-
Teil 3: Festlegung der Ereignistypen für Öffnen und Klicken mithilfe eines Konfigurationssatzes
Nachdem Sie Ihre benutzerdefinierte Domain und HTTPS-Richtlinie in der im vorherigen Schritt festgelegten Konfiguration angegeben haben, müssen Sie and/or Open-Click-Ereignistypen angeben, die in einem Event-Ziel mithilfe eines Konfigurationssatzes verfolgt werden sollen.
Sie können dies mithilfe der SES-Konsole oder der CreateConfigurationSetEventDestination v2-API-Operation abschließen.
Um Ereignistypen zum Öffnen und and/or Klicken mithilfe der Konsole auszuwählen
-
Verwenden Sie beim Erstellen oder Ändern eines Eventziels die Option Öffnen und Klick-Tracking in Schritt 6 vonErstellen eines Ereignisziels, um die Ereignistypen anzugeben.
Teil 4 (optional): Konfiguration benutzerdefinierter Pfadsegmente für Universal Links und App Links
Dieser Abschnitt ist optional. Füllen Sie es nur aus, wenn Sie eine mobile App haben und möchten, dass Universal Links für iOS oder Android App Links Ihre App direkt öffnen, wenn Empfänger auf Tracking-Links klicken. Füllen Sie den Unterabschnitt für jede mobile Plattform aus, die Ihre App unterstützt — iOS, Android oder beide. Bevor Sie beginnen, schließen Sie Teil 1 ab, um eine benutzerdefinierte Weiterleitungsdomäne einzurichten, und Teil 2, um Ihren Konfigurationssatz für die Verwendung dieser Domain zu konfigurieren.
Wenn Sie Universal Links für iOS oder Android App Links verwenden, überprüft das Betriebssystem eine Bestätigungsdatei, die auf der Click-Tracking-Domain gehostet wird, um zu entscheiden, welche App den Link öffnen soll. Wenn die App installiert ist, wird der Link direkt in der App geöffnet. Wenn die App nicht installiert ist, fällt der Link auf den Webbrowser zurück. Da diese Bestätigungsdateien den Abgleich von Pfadpräfix verwenden, benötigen Sie die Kontrolle über das Pfadsegment in Ihren Tracking-URLs.
Verwenden Sie das ses:custom-path Attribut für einzelne <a> Tags in Ihrem E-Mail-HTML, um der Tracking-URL ein festes Pfadsegment hinzuzufügen:
<a href="https://example.com/product/123" ses:custom-path="myapp">View product</a>
Die folgenden Beispiele zeigen den Unterschied zwischen einer Tracking-URL ohne und mitses:custom-path:
-
Ohne
ses:custom-path(Standard):https://{your-custom-redirect-domain}/CL0/{encodedUrl}/{index}/{messageId}/{hmac} -
Mit
ses:custom-path="myapp":https://{your-custom-redirect-domain}/CL1/myapp/{encodedUrl}/{index}/{messageId}/{hmac}
Der ses:custom-path Wert muss die folgenden Anforderungen erfüllen:
-
Nur Buchstaben (A—Z, a—z), Ziffern (0—9), Bindestriche (-), Punkte (.) oder Unterstriche (_)
-
1—32 Zeichen, Groß- und Kleinschreibung beachten
-
SES entfernt dieses Attribut vor der Zustellung aus der E-Mail
-
Greift auf das Standardformat zurück, wenn der Wert ungültig ist (entspricht dem Weglassen
ses:custom-path)
Der ses:custom-path Wert erscheint nicht in den Klickereignisdaten. Um zu ermitteln, auf welchen Link bei Ereignissen geklickt wurde, verwenden Sieses:tags.
Universelle Links für iOS
Hosten Sie die folgende Datei unter, um Ihre iOS-App für die Verarbeitung universeller Links auf Ihrer benutzerdefinierten Weiterleitungsdomain zu autorisieren: https://{your-custom-redirect-domain}/.well-known/apple-app-site-association
{
"applinks": {
"apps": [],
"details": [
{
"appID": "TEAMID.com.example.myapp",
"paths": ["/CL1/myapp/*"]
}
]
}
}
ErsetzenTEAMID. com.example.myappmit Ihrer Apple-Team-ID und App-Paket-ID sowie myapp mit dem Wert, den Sie in angebenses:custom-path.
Links zu Android-Apps
Hosten Sie die folgende Datei unter, um Ihre Android-App für die Verarbeitung von App-Links auf Ihrer benutzerdefinierten Weiterleitungsdomain zu autorisieren: https://{your-custom-redirect-domain}/.well-known/assetlinks.json
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.myapp",
"sha256_cert_fingerprints": ["certificate-fingerprint"]
}
}]
com.example.myappErsetzen Sie sie durch den Paketnamen Ihrer App und certificate-fingerprint durch den Fingerabdruck des Signaturzertifikats Ihrer App.
Anmerkung
Android behandelt den Abgleich von Pfadpräfixen anders als iOS. Anstatt Pfadpräfixe in der assetlinks.json Datei zu definieren, konfigurieren Sie einen Intent-Filter in Ihrer App AndroidManifest.xml mitandroid:pathPrefix="/CL1/, wobei sich der von Ihnen angegebene Wert myapp/"myapp befindet. ses:custom-path Weitere Informationen finden Sie in der Android App Links-Dokumentation auf der Android Developers-Website