Configurer un domaine pour gérer les redirections de liens d'ouvertures et de clics Spécification de votre domaine de redirection personnalisé et de votre politique HTTPS Spécification des types d'événements d'ouverture et de clic

Configuration de domaines personnalisés pour gérer le suivi des ouvertures et des clics

Lorsque vous utilisez la publication d'événements pour capturer les événements d'ouvertures et de clics, Amazon SES apporte des modifications mineures sur les e-mails que vous envoyez. Pour capturer des événements ouverts, SES ajoute une image GIF transparente de 1 pixel par 1 pixel dans chaque e-mail envoyé via SES, qui inclut un nom de fichier unique pour chaque e-mail, et est hébergé sur un serveur exploité par SES. Lorsque l'image est téléchargée, SES peut indiquer exactement quel message a été ouvert et par qui.

Par défaut, ce pixel est inséré en bas de l'e-mail. Toutefois, les applications de certains fournisseurs de messagerie tronquent l'aperçu d'un e-mail lorsqu'il dépasse une certaine taille et peut fournir un lien pour afficher le reste du message. Dans ce scénario, l'image de suivi des pixels SES ne se charge pas et supprimera les taux d'ouverture que vous tentez de suivre. Pour contourner ce problème, vous pouvez éventuellement placer le pixel au début de l'e-mail, ou n'importe où ailleurs, en insérant l'espace réservé {{ses:openTracker}} dans le corps de l'e-mail. Une fois que SES aura reçu le message avec l'espace réservé, il sera remplacé par une image de pixel de suivi ouverte.

Important

Tout {{ses:openTracker}} espace réservé supérieur à un sera supprimé lors de l'envoi par SES.
N'ajoutez qu'un seul {{ses:openTracker}} espace réservé si vous les utilisez dans un modèle d'e-mail, car plusieurs d'entre eux entraîneront le renvoi 400 BadRequestException d'un code d'erreur.

Pour capturer les événements liés aux clics sur des liens, SES remplace les liens contenus dans vos e-mails par des liens vers un serveur géré par SES. Cela redirige immédiatement le destinataire vers sa destination initiale. La taille totale des en-têtes, cookies compris, des requêtes adressées à ce serveur ne doit pas dépasser 8192 octets, sinon un code d'400 BadRequestExceptionerreur est renvoyé.

Vous avez également la possibilité d'utiliser vos propres domaines, plutôt que des domaines détenus et exploités par SES, afin de créer une expérience plus cohérente pour vos destinataires, ce qui signifie que tous les indicateurs SES sont supprimés. Vous pouvez configurer plusieurs domaines personnalisés pour gérer les événements de suivi des ouvertures et des clics. Ces domaines personnalisés sont associés à des jeux de configuration. Lorsque vous envoyez un e-mail à l'aide d'un jeu de configuration, si ce jeu de configuration est configuré pour utiliser un domaine personnalisé, les liens d'ouvertures et de clics de cet e-mail utilisent automatiquement le domaine personnalisé spécifié dans ce jeu de configuration.

Cette section décrit les procédures de configuration d'un sous-domaine sur un serveur dont vous êtes le propriétaire afin de rediriger automatiquement les utilisateurs vers les serveurs de suivi des ouvertures et des clics exploités par SES. Trois étapes sont impliquées dans la configuration de ces domaines. Tout d'abord, vous configurez le sous-domaine lui-même, puis vous définissez un jeu de configurations pour utiliser le domaine personnalisé, puis vous définissez sa destination d'événement pour publier des événements ouverts et de clics. Cette rubrique contient les procédures de réalisation de ces étapes.

Toutefois, si vous souhaitez simplement activer le suivi des ouvertures ou des clics sans configurer de domaine personnalisé, vous pouvez définir directement les destinations des événements pour votre jeu de configuration, ce qui permet la publication d'événements déclenchée sur les types d'événements que vous spécifiez, y compris les événements d'ouverture et de clic. Un jeu de configurations peut comporter plusieurs destinations d'événements avec plusieurs types d'événements définis. Consultez Création de destinations d'événement Amazon SES.

Partie 1 : Configurer un domaine pour gérer les redirections de liens d'ouvertures et de clics

Les procédures spécifiques de configuration d'un domaine de redirection varient en fonction de votre fournisseur d'hébergement web (et de votre réseau de diffusion de contenu, si vous utilisez un serveur HTTPS). Les procédures décrites dans les sections suivantes proposent des conseils généraux plutôt que des étapes spécifiques.

Option 1 : Configuration d'un domaine HTTP

Si vous avez l'intention d'utiliser un domaine HTTP pour gérer les liens d'ouvertures et de clics (plutôt qu'un domaine HTTPS), le processus de configuration du sous-domaine comprend seulement quelques étapes.

Note

Si vous configurez un domaine personnalisé qui utilise le protocole HTTP, et que vous envoyez un e-mail contenant des liens qui utilisent le protocole HTTPS, vos clients verront peut-être un message d'avertissement lorsqu'ils cliqueront sur les liens de votre e-mail. Si vous avez l'intention d'envoyer des e-mails contenant des liens qui utilisent le protocole HTTPS, vous devez utiliser un domaine HTTPS pour gérer les événements de suivi des clics.

Pour configurer un sous-domaine HTTP afin de gérer les liens d'ouvertures et de clics

Créez un sous-domaine à utiliser pour les liens de suivi des ouvertures et des clics. SES recommande que ce sous-domaine soit spécifiquement dédié à la gestion de ces liens et qu'un sous-domaine soit créé pour chaque e-mail que Région AWS vous envoyez et que vous souhaitez suivre.
Vérifiez le sous-domaine à utiliser avec SES. Pour de plus amples informations, veuillez consulter Création d'une identité de domaine.

Ajoutez un nouvel enregistrement CNAME aux paramètres DNS de votre sous-domaine qui redirige les demandes vers le domaine de suivi SES. L'adresse vers laquelle vous redirigez doit être Région AWS identique à celle de votre sous-domaine personnalisé.

Le tableau suivant contient une liste des domaines de suivi pour les domaines dans Régions AWS lesquels SES est disponible. Sélectionnez celui qui se trouve dans la même région que votre domaine personnalisé :

AWS Région	AWS domaine de suivi
USA Est (Ohio)	`r.us-east-2.awstrack.me`
USA Est (Virginie du Nord)	`r.us-east-1.awstrack.me`
USA Ouest (Californie du Nord)	`r.us-west-1.awstrack.me`
USA Ouest (Oregon)	`r.us-west-2.awstrack.me`
Afrique (Le Cap)	`r.af-south-1.awstrack.me`
Asie-Pacifique (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asie-Pacifique (Mumbai)	`r.ap-south-1.awstrack.me`
Asie-Pacifique (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seoul)	`r.ap-northeast-2.awstrack.me`
Asie-Pacifique (Singapour)	`r.ap-southeast-1.awstrack.me`
Asie-Pacifique (Sydney)	`r.ap-southeast-2.awstrack.me`
Asie-Pacifique (Jakarta)	r.ap-southeast-3.awstrack.me
Asie-Pacifique (Jakarta)	r.ap-southeast-3.awstrack.me
Asie-Pacifique (Tokyo)	`r.ap-northeast-1.awstrack.me`
Canada (Centre)	`r.ca-central-1.awstrack.me`
Europe (Francfort)	`r.eu-central-1.awstrack.me`
Europe (Irlande)	`r.eu-west-1.awstrack.me`
Europe (Londres)	`r.eu-west-2.awstrack.me`
Europe (Milan)	`r.eu-south-1.awstrack.me`
Europe (Stockholm)	`r.eu-north-1.awstrack.me`
Israël (Tel Aviv)	`r.il-central-1.awstrack.me`
Moyen-Orient (Bahreïn)	`r.me-south-1.awstrack.me`
Amérique du Sud (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (US-Ouest)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (USA Est)	`r.us-gov-east-1.awstrack.me`

Note

En fonction de votre fournisseur d'hébergement web, l'application des modifications apportées à le registre DNS du sous-domaine peut prendre plusieurs minutes. Votre fournisseur d'hébergement web ou votre organisation TI peut fournir des informations supplémentaires sur ces retards.

Option 2 : Configuration d'un domaine HTTPS

Vous pouvez également utiliser un domaine HTTPS pour suivre les clics ouverts et sur les liens. Pour configurer un domaine HTTPS afin de suivre les clics ouverts et sur les liens, vous devez effectuer certaines étapes supplémentaires, en plus de celles requises pour configurer un domaine HTTP.

Pour configurer un sous-domaine HTTPS afin de gérer les liens d'ouvertures et de clics

Créez un sous-domaine à utiliser pour les liens de suivi des ouvertures et des clics. SES recommande que ce sous-domaine soit spécifiquement dédié à la gestion de ces liens et qu'un sous-domaine soit créé pour chaque e-mail que Région AWS vous envoyez et que vous souhaitez suivre.
Vérifiez le sous-domaine à utiliser avec SES. Pour de plus amples informations, veuillez consulter Création d'une identité de domaine.
Créez un nouveau compte auprès d'un réseau de diffusion de contenu (CDN), tel qu'Amazon CloudFront, voir Commencer avec une CloudFront distribution de base.

Configurez le CDN sur l'origine qui est le domaine de suivi SES, par exemple r.us-east-1.awstrack.me. Le CDN doit pointer vers le domaine AWS de suivi situé dans la même région que votre domaine personnalisé. Le CDN doit transmettre l'Hosten-tête fourni par le demandeur à l'origine. Consultez cet article de AWS Re:Post pour plus d'informations.

AWS Région	AWS domaine de suivi
USA Est (Ohio)	`r.us-east-2.awstrack.me`
USA Est (Virginie du Nord)	`r.us-east-1.awstrack.me`
USA Ouest (Californie du Nord)	`r.us-west-1.awstrack.me`
USA Ouest (Oregon)	`r.us-west-2.awstrack.me`
Afrique (Le Cap)	`r.af-south-1.awstrack.me`
Asie-Pacifique (Jakarta)	`r.ap-southeast-3.awstrack.me`
Asie-Pacifique (Mumbai)	`r.ap-south-1.awstrack.me`
Asie-Pacifique (Osaka)	`r.ap-northeast-3.awstrack.me`
Asia Pacific (Seoul)	`r.ap-northeast-2.awstrack.me`
Asie-Pacifique (Singapour)	`r.ap-southeast-1.awstrack.me`
Asie-Pacifique (Sydney)	`r.ap-southeast-2.awstrack.me`
Asie-Pacifique (Tokyo)	`r.ap-northeast-1.awstrack.me`
Canada (Centre)	`r.ca-central-1.awstrack.me`
Europe (Francfort)	`r.eu-central-1.awstrack.me`
Europe (Irlande)	`r.eu-west-1.awstrack.me`
Europe (Londres)	`r.eu-west-2.awstrack.me`
Europe (Milan)	`r.eu-south-1.awstrack.me`
Europe (Stockholm)	`r.eu-north-1.awstrack.me`
Israël (Tel Aviv)	`r.il-central-1.awstrack.me`
Moyen-Orient (Bahreïn)	`r.me-south-1.awstrack.me`
Amérique du Sud (São Paulo)	`r.sa-east-1.awstrack.me`
AWS GovCloud (US-Ouest)	`r.us-gov-west-1.awstrack.me`
AWS GovCloud (USA Est)	`r.us-gov-east-1.awstrack.me`

Si vous utilisez Route 53 pour gérer la configuration DNS de votre domaine et en CloudFront tant que CDN, créez un enregistrement Alias dans Route 53 qui fait référence à votre CloudFront distribution (par exemple d111111abcdef8.cloudfront.net). Pour en savoir plus, reportez-vous à la section Création de registres à l'aide de la console Amazon Route 53 dans le Guide du développeur Amazon Route 53.

Sinon, dans la configuration DNS de votre sous-domaine, ajoutez un registre CNAME qui fait référence à l'adresse de votre CDN.
Obtenez un certificat SSL auprès d'une autorité de certification approuvée. Le certificat doit couvrir le sous-domaine que vous avez créé à l'étape 1, ainsi que le CDN que vous avez configuré lors des étapes 3 à 5. Chargez le certificat sur le CDN.
Vous pouvez utiliser la commande curl suivante pour vérifier que le domaine personnalisé que vous venez de créer utilise la région et le protocole HTTPS appropriés. Dans l'exemple suivant, tout est littéral à l'exception du nom de votre domaine :
```
curl --head https://custom.domain.com/favicon.ico
```
Une réponse est renvoyée comme dans l'exemple suivant :
```
(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
```
Cette réponse contient les propriétés suivantes :
- La valeur x-amz-ses-region d'en-tête est la région SES qui a reçu la demande.
- La valeur x-amz-ses-request-protocol d'en-tête est le protocole utilisé pour la demande entre le CDN et SES dans l'en-tête.
Si votre configuration est correcte, la région doit refléter la région dans laquelle votre domaine a été créé et le protocole doit être HTTPS.

Partie 2 : Spécification de votre domaine de redirection personnalisé et de votre politique HTTPS via un ensemble de configuration

Après avoir configuré votre domaine pour gérer les redirections d'ouverture et de suivi des clics, vous devez spécifier votre domaine personnalisé et votre politique HTTPS dans un ensemble de configuration.

Lorsque vous envoyez un e-mail à l'aide d'un ensemble de configuration, si celui-ci est configuré pour utiliser un domaine de redirection personnalisé, les liens d'ouverture et de clic contenus dans cet e-mail utilisent automatiquement le domaine personnalisé et les options de politique HTTPS spécifiées dans le jeu de configuration.

Vous pouvez effectuer cette opération à l'aide de la console SES ou de l'opération API CreateConfigurationSetv2.

Pour spécifier un domaine de redirection personnalisé et une politique HTTPS à l'aide de la console

Lors de la création ou de la modification d'un ensemble de configuration, utilisez les options de suivi de l'étape 4 Créer des jeux de configuration pour spécifier votre domaine de redirection personnalisé et vos options de politique HTTPS.

Pour spécifier un domaine de redirection personnalisé et une politique HTTPS à l'aide du AWS CLI

Vous pouvez utiliser l'CreateConfigurationSetopération dans l'API SES v2 et utiliser la TrackingOptions propriété pour spécifier votre domaine de redirection personnalisé et la politique HTTPS. Vous pouvez appeler cette opération à partir du AWS CLI , comme indiqué dans l'exemple suivant.

Créez le paramètre de configuration dans l' Région AWS endroit où vous souhaitez envoyer et suivre les e-mails :
```
aws sesv2 create-configuration-set --cli-input-json file://create.json
```
Dans cet exemple, le fichier d'entrée utilise les paramètres de la TrackingOptionspropriété : CustomRedirectDomain indique le domaine personnalisé à utiliser pour le suivi des liens ouverts et cliqués, et HttpsPolicy spécifie une option de politique HTTPS :
```
{
    "ConfigurationSetName": "my-config-set",
    "TrackingOptions": {
        "CustomRedirectDomain": "marketing.example.com",
        "HttpsPolicy": "REQUIRE"
    },
    "SendingOptions": {
        "SendingEnabled": true
    }
}
```
Pour le HttpsPolicy paramètre, les valeurs suivantes peuvent être spécifiées pour définir le protocole des liens d'ouverture et de suivi des clics pour votre domaine de redirection personnalisé :
- OPTIONAL— (Comportement par défaut) Les liens de suivi ouverts seront encapsulés à l'aide du protocole HTTP. Les liens de suivi des clics seront encapsulés selon le protocole original du lien.
- REQUIRE— Les liens de suivi des ouvertures et des clics seront tous deux encapsulés à l'aide du protocole HTTPS.
- REQUIRE_OPEN_ONLY— Les liens de suivi ouverts seront encapsulés à l'aide du protocole HTTPS. Les liens de suivi des clics seront encapsulés selon le protocole original du lien.

Partie 3 : Spécification des types d'événements d'ouverture et de clic via un ensemble de configuration

Après avoir défini votre domaine personnalisé et votre politique HTTPS dans la configuration définie à l'étape précédente, vous devez spécifier les types d'événements d'ouverture et/ou de clic à suivre dans une destination d'événement via un ensemble de configuration.

Vous pouvez effectuer cette opération à l'aide de la console SES ou de l'opération API CreateConfigurationSetEventDestinationv2.

Pour sélectionner les types d'événements ouverts et/ou cliqués à l'aide de la console

Lors de la création ou de la modification d'une destination d'événement, utilisez Ouvrir et suivre les clics Création d'une destination d'événement à l'étape 6 pour spécifier les types d'événements.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Attribuer des groupes d'adresses

Spécification des jeux de configurations dans un e-mail