Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillance de l'envoi d'e-mails à l'aide de la publication d'événements Amazon SES
Pour vous permettre de suivre vos envois d'e-mails de manière détaillée, vous pouvez configurer Amazon SES pour publier les *événements d'envoi d'e-mails* sur Amazon CloudWatch, Amazon Data Firehose, Amazon Pinpoint, Amazon Simple Notification Service ou EventBridge Amazon en fonction des caractéristiques que vous définissez.
Vous pouvez suivre plusieurs types d'événements d'envoi d'e-mails, notamment les envois, les livraisons, les ouvertures, les clics, les rebonds, les réclamations, les refus, les échecs de rendu et les retards de livraison. Ces informations peuvent être utiles à des fins analytiques et opérationnelles. Par exemple, vous pouvez publier vos données d'envoi d'e-mails CloudWatch et créer des tableaux de bord qui suivent les performances de vos campagnes par e-mail, ou vous pouvez utiliser Amazon SNS pour vous envoyer des notifications lorsque certains événements se produisent.
## Comment fonctionne la publication d'événements avec les ensembles de configuration et les balises de message
Pour utiliser la publication d'événements, vous devez commencer par configurer un ou plusieurs *ensembles de configuration*. Un jeu de configurations spécifie l'emplacement de publication des événements, ainsi que les types d'événements à publier. Ensuite, chaque fois que vous envoyez un e-mail, vous fournissez le nom du jeu de configuration et une ou plusieurs *balises de message*, sous forme de name/value paires, pour classer l'e-mail. Par exemple, si vous faites la promotion de livres, vous pouvez nommer une balise de message *genre* et attribuer la valeur *sci-fi* ou *western* lorsque vous envoyez un e-mail pour la campagne associée.
Selon l'interface d'envoi d'e-mail que vous utilisez, vous pouvez soit fournir la balise de message en tant que paramètre [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags)dans le champ de l'opération d'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)API, soit l'ajouter à l'en-tête de message spécifique à SES. [https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-send-email.html#event-publishing-using-ses-headers) Pour en savoir plus sur les jeux de configurations, consultez [Utilisation des jeux de configuration dans Amazon SES](using-configuration-sets.md).
Outre les balises de message que vous spécifiez, SES ajoute également des *balises automatiques* aux messages que vous envoyez. Vous n'avez pas besoin d'effectuer des étapes supplémentaires pour utiliser des balises automatiques.
Le tableau suivant répertorie les balises automatiques qui sont automatiquement appliquées aux messages que vous envoyez à l'aide de SES.
**Balises automatiques SES**
| Nom de balise automatique | Description |
| --- | --- |
| ses:caller-identity | L'identité IAM de l'utilisateur SES qui a envoyé l'e-mail. |
| ses:configuration-set | Nom du jeu de configurations associé à l'e-mail. |
| ses:from-domain | Domaine de l'adresse de l'expéditeur. |
| ses:outgoing-ip | Adresse IP utilisée par SES pour envoyer l'e-mail. |
| ses:source-ip | Adresse IP que l'appelant a utilisée pour envoyer l'e-mail. |
| ses:source-tls-version | Version du protocole TLS que l'appelant a utilisée pour envoyer l'e-mail. |
| ses:outgoing-tls-version | Version du protocole TLS utilisée par SES pour envoyer l'e-mail. |
## Feedback précis pour les campagnes par e-mail
La `ses:feedback-id-` balise est une balise de message facultative que vous pouvez considérer comme une balise hybride ou semi-automatique. Bien qu'elle soit similaire aux balises automatiques décrites dans la section précédente, la différence est que vous devez l'ajouter manuellement et utiliser la clé de préfixe. `ses:` Vous pouvez utiliser jusqu'à deux de ces balises définies par `ses:feedback-id-a` et`ses:feedback-id-b`.
Lorsque vous spécifiez ces balises, SES les ajoute automatiquement à l'`Feedback-ID`en-tête standard qui est utilisé pour fournir des statistiques de livraison, telles que les taux de plaintes et de spam, dans le cadre d'une boucle de rétroaction (FBL), voir. [Boucles de rétroaction](faqs-enforcement.md#cm-feedback-loop) L'`Feedback-ID`en-tête est composé de l'identifiant, l'*SESInternalID*, utilisé par SES pour collecter les informations relatives aux plaintes, et de la balise statique, *AmazonSES*, identifiant SES en tant que plateforme d'envoi, telle que :
`FeedBackId:feedback-id-a:feedback-id-b:((SESInternalID):(AmazonSES))`
Ces balises d'identification de commentaires facultatives vous permettent de générer des commentaires précis, par exemple pour les messages que vous envoyez dans le cadre d'une campagne par e-mail. Vous pouvez l'utiliser `ses:feedback-id-` en le spécifiant sous forme de balise de message dans le [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html#SES-SendEmail-request-EmailTags)champ de la demande d'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)opération, comme indiqué dans l'exemple suivant :
```
{
"FromEmailAddress": "noreply@example.com",
"Destination": {
"ToAddresses": [
"customer@example.net"
]
},
"Content": {
"Simple": {
"Subject": {
"Data": "Hello and welcome"
},
"Body": {
"Text": {
"Data": "Lorem ipsum dolor sit amet."
},
"Html": {
"Data": "Lorem ipsum dolor sit amet."
}
}
}
},
"EmailTags": [
{
"Name": "ses:feedback-id-a",
"Value": "new-members-campaign"
},
{
"Name": "ses:feedback-id-b",
"Value": "football-campaign"
}
],
"ConfigurationSetName": "football-club"
}
```
Si vous envoyez au format brut, vous devez l'ajouter `ses:feedback-id-` en tant que balise de message à l'en-tête spécifique à SES. [`X-SES-MESSAGE-TAGS`](event-publishing-send-email.md#event-publishing-using-ses-headers)
La balise de `ses:feedback-id-` message peut également être CloudWatch suivie sur Amazon en la spécifiant comme source de CloudWatch valeur, comme toute autre balise de message, voir [Ajouter une destination CloudWatch d'événement](event-publishing-add-event-destination-cloudwatch.md#event-publishing-add-event-destination-cloudwatch-add) *(Des frais supplémentaires s'appliquent, voir [Prix par métrique pour CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)*
## Utilisation de la publication d'événements
Les sections suivantes contiennent les informations dont vous avez besoin pour configurer et utiliser la publication d'événements SES.
+ [Configuration de la publication d'événements](monitor-sending-using-event-publishing-setup.md)
+ [Utilisation des données d'événement](working-with-event-data.md)
## Terminologie de publication d'événements
La liste suivante définit les termes relatifs à la publication d'événements SES.
**Événement d'envoi d'e-mail**
Informations associées au résultat d'un e-mail que vous avez envoyé à SES. Les événements d'envoi incluent ce qui suit :
+ **Send (Envoi)** – La demande d'envoi a réussi et Amazon SES tente de remettre le message au serveur de messagerie du destinataire. (Si une suppression globale ou au niveau du compte est utilisée, SES la comptera toujours comme un envoi, mais la livraison sera supprimée).
+ **RenderingFailure**— L'e-mail n'a pas été envoyé en raison d'un problème de rendu du modèle. Ce type d'événement peut se produire lorsqu'il manque des données du modèle ou lorsqu'il n'y a pas concordance entre les paramètres du modèle et les données. Ce type d'événement ne se produit que lorsque vous envoyez un e-mail à l'aide des opérations d'API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html).
+ **Reject (Rejet)** – Amazon SES a accepté l'e-mail, a déterminé qu'il contenait un virus et l'a rejeté. Amazon SES n'a pas tenté de remettre l'e-mail au serveur de messagerie du destinataire.
+ **Delivery (Livraison)** – Amazon SES a bien remis l'e-mail au serveur de messagerie du destinataire.
+ **Bounce** – *Message d'erreur définitif* indiquant que le serveur de messagerie du destinataire a définitivement rejeté l'e-mail. (Les *soft bounces* ne sont inclus que lorsque SES n'essaie plus de livrer l'e-mail. En général, ces rebonds souples indiquent un échec de livraison, bien que dans certains cas, un rebond souple puisse être renvoyé même lorsque le courrier parvient avec succès dans la boîte de réception du destinataire. Cela se produit généralement lorsque le destinataire envoie une réponse out-of-office automatique. Pour en savoir plus sur les soft bounces, consultez cet article de [AWS Re:Post](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint (Réclamation)** – L'e-mail a été correctement remis au serveur de messagerie du destinataire, mais le destinataire l'a marqué comme courrier indésirable.
+ **DeliveryDelay**— L'e-mail n'a pas pu être remis au serveur de messagerie du destinataire en raison d'un problème temporaire. Des retards de livraison peuvent se produire, par exemple lorsque la boîte de réception du destinataire est pleine ou lorsque le serveur de messagerie de réception rencontre un problème transitoire.
+ **Subscription (Abonnement)** – L'e-mail a été envoyé avec succès, mais le destinataire a mis à jour les préférences d'abonnement en cliquant sur `List-Unsubscribe` dans l'en-tête de l'e-mail ou le lien `Unsubscribe` dans le pied-de-page.
+ **Open (Ouverture)** – Le destinataire a reçu le message et l'a ouvert dans son client de messagerie.
+ **Click (Clic)** – Le destinataire a cliqué sur un ou plusieurs liens contenus dans l'e-mail.
**Jeu de configurations**
Ensemble de règles qui définit la destination vers laquelle SES publie les événements d'envoi d'e-mails, ainsi que les types d'événements d'envoi d'e-mails que vous souhaitez publier. Lorsque vous envoyez un e-mail que vous voulez utiliser avec la publication d'événements, vous spécifiez le jeu de configurations à associer à l'e-mail.
**Destination de l'événement**
AWS Service vers lequel vous publiez des événements d'envoi d'e-mails SES. Chaque destination d'événement que vous configurez appartient à un, et à un seul, jeu de configurations.
**Balise de message**
Une name/value paire que vous utilisez pour classer un e-mail dans le but de publier un événement. Par exemple, *campagne/livre* et *campagne/vêtements*. Lorsque vous envoyez un e-mail, vous spécifiez la balise du message en tant que paramètre de l'appel d'API ou en tant qu'en-tête d'e-mail spécifique à SES.
**Balise automatique**
Balises de messages qui sont automatiquement incluses dans les rapports de publication d'événements. Il existe un tag automatique pour le nom du jeu de configuration, le domaine de l'adresse « From », l'adresse IP sortante de l'appelant, l'adresse IP sortante SES et l'identité IAM de l'appelant.
# Configuration de la publication d'événements Amazon SES
Cette section décrit ce que vous devez faire pour configurer Amazon SES afin de publier vos événements d'envoi d'e-mails aux AWS services suivants :
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
Les étapes suivantes, nécessaires à la configuration de la publication d'événements, sont décrites dans les rubriques ci-dessous :
1. Vous devez créer un *jeu de configurations* à l'aide de la console ou de l'API Amazon SES.
1. Ajoutez une ou plusieurs *destinations d'événements* (FirehoseCloudWatch, Pinpoint ou SNS) à l'ensemble de configuration et configurez des paramètres propres à la destination de l'événement.
1. Lorsque vous envoyez un e-mail, vous devez spécifier le jeu de configuration à utiliser qui contient la destination de votre événement.
**Topics**
+ [Étape 1 : Création d'un jeu de configurations](event-publishing-create-configuration-set.md)
+ [Étape 2 : Ajout d'une destination d'événement](event-publishing-add-event-destination.md)
+ [Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail](event-publishing-send-email.md)
# Étape 1 : Création d'un jeu de configurations
Vous devez d'abord disposer d'un jeu de configuration pour mettre en place la publication d'événements. Si vous n'avez pas encore de jeu de configuration, ou si vous souhaitez en créer un nouveau, consultez [Création de jeux de configuration dans SES](creating-configuration-sets.md)
Vous pouvez également créer des ensembles de configuration à l'aide de l'[CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)opération de l'API Amazon SES V2 ou de l'Amazon SES CLI v2, voir[Créer un jeu de configurations (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli).
# Étape 2 : Ajout d'une destination d'événement
Les destinations d'événements sont des endroits où vous publiez des événements Amazon SES Chaque destination d'événement que vous configurez appartient à un, et à un seul, jeu de configurations. Lorsque vous configurez une destination d'événement avec Amazon SES, vous choisissez la destination du AWS service et vous spécifiez les paramètres associés à cette destination.
Lorsque vous configurez la destination d'un événement, vous pouvez choisir d'envoyer des événements à l'un des AWS services suivants :
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon EventBridge
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
La destination d'événement que vous choisissez dépend du niveau de détail voulu sur les événements et de la façon dont vous souhaitez recevoir les informations sur les événements. Si vous voulez simplement un total cumulé de chaque type d'événement (par exemple, pour pouvoir définir le déclenchement d'une alarme lorsque le total devient trop élevé), utilisez CloudWatch.
Si vous souhaitez des enregistrements d'événements détaillés que vous pouvez envoyer à un autre service tel qu'Amazon OpenSearch Service ou Amazon Redshift à des fins d'analyse, vous pouvez utiliser Firehose.
Si vous souhaitez recevoir des notifications lorsque certains événements se produisent, choisissez Amazon SNS.
**Topics**
+ [Configurer une destination d' CloudWatch événement pour la publication d'événements](event-publishing-add-event-destination-cloudwatch.md)
+ [Configurer une destination d'événements Data Firehose pour la publication d'événements Amazon SES](event-publishing-add-event-destination-firehose.md)
+ [Configurer une EventBridge destination Amazon pour la publication d'événements](event-publishing-add-event-destination-eventbridge.md)
+ [Configuration d'une destination d'événement Amazon Pinpoint pour la publication d'événements](event-publishing-add-event-destination-pinpoint.md)
+ [Configurer une destination d'événement Amazon SNS pour la publication d'événements](event-publishing-add-event-destination-sns.md)
# Configurer une destination d' CloudWatch événement pour la publication d'événements
Avec [Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), vous pouvez utiliser les destinations des événements pour publier les événements d'envoi d'e-mails vers Amazon SES CloudWatch. Étant donné qu'une destination d' CloudWatch événement ne peut être configurée que dans un ensemble de configuration, vous devez d'abord [créer un ensemble de configuration](event-publishing-create-configuration-set.md), puis ajouter la destination de l'événement au jeu de configuration.
Lorsque vous ajoutez une destination d' CloudWatch événement à un ensemble de configuration, vous devez choisir une ou plusieurs CloudWatch *dimensions* correspondant aux balises de message que vous utilisez lorsque vous envoyez vos e-mails. À l'instar des balises de message, une CloudWatch dimension est une name/value paire qui vous permet d'identifier une métrique de manière unique.
Par exemple, vous pouvez utiliser une balise de message et une dimension appelée `campaign` pour identifier votre campagne d'e-mailing. Lorsque vous publiez vos événements d'envoi d'e-mails sur CloudWatch, il est important de choisir les balises et les dimensions de vos messages, car ces choix ont une incidence sur votre CloudWatch facturation et déterminent la manière dont vous pouvez filtrer les données de vos événements d'envoi d'e-mails CloudWatch.
Cette section fournit des informations pour vous aider à choisir vos dimensions, puis montre comment ajouter une destination d' CloudWatch événement à un ensemble de configuration.
**Topics**
+ [Ajouter une destination CloudWatch d'événement](#event-publishing-add-event-destination-cloudwatch-add)
+ [Choix des CloudWatch dimensions](#event-publishing-add-event-destination-cloudwatch-dimensions)
## Ajouter une destination CloudWatch d'événement
La procédure décrite dans cette section explique comment ajouter les détails de la destination d'un CloudWatch événement à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Pour ajouter les détails de la destination de l' CloudWatch événement à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner le type CloudWatch de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de CloudWatch destination**, saisi un **nom** de destination et activé la **publication d'événements**, le volet des ** CloudWatch dimensions Amazon** s'affiche. Ses champs sont traités dans les étapes suivantes. *(Des frais supplémentaires s'appliquent, voir [Prix par métrique pour CloudWatch](#cw-add-pricing).)*
1. Pour **Value Source**, spécifiez comment Amazon SES obtiendra les données auxquelles elles seront transmises CloudWatch. Les sources de valeur suivantes sont disponibles :
+ **Message Tag (Balise de message)** – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous spécifiez à l'aide de l'en-tête `X-SES-MESSAGE-TAGS` ou du paramètre d'API `EmailTags`. Pour en savoir plus sur l'utilisation des balises de message, consultez la page [Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail](event-publishing-send-email.md).
**Note**
Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (\$1).
Vous pouvez également utiliser la source de valeur **Message Tag (Balise de message)** pour créer des dimensions en fonction des balises automatiques pour Amazon SES. Pour utiliser une balise automatique, tapez le nom de cette balise automatique en tant que **Dimension Name (Nom de la dimension)**. Par exemple, pour créer une dimension basée sur la balise automatique de jeu de configurations, utilisez `ses:configuration-set` pour **Dimension Name (Nom de la dimension)**, et le nom du jeu de configurations pour **Default Value (Valeur par défaut)**. Pour obtenir la liste complète des balises automatiques, consultez [Comment fonctionne la publication d'événements avec les ensembles de configuration et les balises de message](monitor-using-event-publishing.md#event-publishing-how-works).
+ **Email Header (En-tête d'e-mail)** – Amazon SES extrait le nom et la valeur de la dimension d'un en-tête dans l'e-mail.
**Note**
Vous ne pouvez pas utiliser les en-têtes d'e-mail suivants comme **Dimension Name (Nom de dimension)** : `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` ou `Return-Path`.
+ **Link Tag (Balise de lien)** – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous avez spécifiée dans un lien. Pour en savoir plus sur l'ajout des balises, consultez [Puis-je baliser les liens avec des identificateurs uniques ?](faqs-metrics.md#sending-metric-faqs-clicks-q5).
1. Pour **Dimension Name (Nom de la dimension)**, tapez le nom de la dimension que vous souhaitez transmettre à CloudWatch.
**Note**
Les noms de dimension peuvent uniquement contenir des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (\$1) ou des tirets (-). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.
1. Dans **Default Value (Valeur par défaut)**, saisissez la valeur de la dimension.
**Note**
Les valeurs de dimension ne peuvent contenir que des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (\$1), des tirets (-), des signes (@) et des points (.). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.
1. Pour ajouter d'autres dimensions, sélectionnez **Add Dimension (Ajouter une dimension)**. Sinon, choisissez **Next (Suivant)**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**.
## Choix des CloudWatch dimensions
Lorsque vous choisissez des noms et des valeurs à utiliser comme CloudWatch dimensions, tenez compte des facteurs suivants :
+ **Prix par métrique** — Vous pouvez consulter les statistiques de base d'Amazon SES CloudWatch gratuitement. Toutefois, lorsque vous collectez des statistiques à l'aide de la publication d'événements, vous encourez des coûts [de surveillance CloudWatch détaillée](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Chaque combinaison unique de type d'événement, de nom de dimension et de valeur de dimension crée une métrique différente dans CloudWatch. Lorsque vous utilisez CloudWatch la surveillance détaillée, vous êtes facturé pour chaque métrique. Pour cette raison, vous pouvez décider de ne pas choisir de dimensions qui peuvent prendre de nombreuses valeurs différentes. Par exemple, à moins que vous soyez très intéressé par le suivi de vos événements d'envoi d'e-mails par domaine d'expédition, vous pouvez décider de ne pas définir de dimension pour la balise automatique `ses:from-domain` Amazon SES, car elle peut prendre de nombreuses valeurs différentes. Pour plus d’informations, consultez [Tarification d’CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Filtrage des métriques** : si une métrique possède plusieurs dimensions, vous ne pouvez pas accéder à la métrique en CloudWatch fonction de chaque dimension séparément. Pour cette raison, réfléchissez bien avant d'ajouter plusieurs dimensions à une même destination d' CloudWatch événement. Par exemple, si vous souhaitez des métriques par `campaign` et par combinaison de `campaign` et `genre`, vous devez ajouter deux destinations d'événement : l'une avec uniquement `campaign` comme dimension, et l'autre avec `campaign` et `genre` comme dimensions.
+ **Source des valeurs de dimension** – Au lieu de spécifier vos valeurs de dimension en utilisant des en-têtes propres à Amazon SES ou un paramètre destiné à l'API, vous pouvez également choisir de laisser Amazon SES prendre les valeurs de dimension de vos propres en-têtes de message MIME. Vous pouvez opter pour cette solution si vous utilisez déjà des en-têtes personnalisés et que vous ne voulez pas modifier vos e-mails ou vos appels à l'API d'envoi d'e-mails de façon à collecter les métriques en fonction de vos valeurs d'en-tête. Si vous utilisez vos propres en-têtes de message MIME pour la publication d'événements Amazon SES, les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES peuvent uniquement inclure les lettres A à Z, les nombres 0 à 9, les traits de soulignement (\$1), les arobas (@), les traits d'union (-) et les points (.). Si vous spécifiez un nom ou une valeur contenant d'autres caractères, l'appel d'envoi d'e-mail réussira toujours, mais les statistiques de l'événement ne seront pas envoyées à Amazon CloudWatch.
Pour plus d'informations sur CloudWatch les concepts, consultez [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) dans le *guide de CloudWatch l'utilisateur Amazon*.
# Configurer une destination d'événements Data Firehose pour la publication d'événements Amazon SES
Une destination d'événement Amazon Data Firehose représente une entité qui publie des événements spécifiques d'envoi d'e-mails Amazon SES vers Firehose. Comme la destination d'un événement Firehose ne peut être configurée que dans un ensemble de configuration, vous devez d'abord [créer un ensemble de configuration](event-publishing-create-configuration-set.md). Ensuite, vous ajoutez la destination de l'événement au jeu de configuration.
La procédure décrite dans cette section explique comment ajouter les détails de la destination des événements Firehose à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans. [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add)
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans la destination Amazon SES API V2 pour créer et mettre à jour des destinations d'événements.
**Pour ajouter les détails de la destination des événements Firehose à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Firehose comme type de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes. [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add) Après avoir sélectionné le **type de destination** Firehose, saisi un **nom** de destination et activé la **publication d'événements**, le volet du **flux de diffusion Amazon Data Firehose** s'affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour le **flux de diffusion**, choisissez un flux de diffusion Firehose existant ou choisissez **Create new stream pour en créer** un nouveau à l'aide de la console Firehose.
Pour plus d'informations sur la création d'un flux à l'aide de la console Firehose, consultez la section [Création d'un flux de diffusion Amazon Kinesis Firehose dans le manuel Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) *Developer Guide*.
1. Pour le rôle **Identity and Access Management (IAM), choisissez un rôle** IAM pour lequel Amazon SES est autorisé à publier sur Firehose en votre nom. Vous pouvez choisir un rôle existant, demander à Amazon SES de créer un rôle à votre place ou créer votre propre rôle.
Si vous choisissez un rôle existant ou si vous créez votre propre rôle, vous devez modifier manuellement les politiques du rôle pour autoriser le rôle à accéder au flux de diffusion Firehose et pour autoriser Amazon SES à assumer ce rôle. Pour obtenir des exemples de politiques, consultez [Autoriser Amazon SES à publier sur votre flux de diffusion Firehose](#event-publishing-add-event-destination-firehose-role).
1. Choisissez **Next (Suivant)**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**.
Pour plus d'informations sur l'utilisation de l'`UpdateConfigurationSetEventDestination`API pour ajouter une destination d'événement Firehose, consultez le manuel [Amazon Simple Email Service API](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html) Reference.
## Autoriser Amazon SES à publier sur votre flux de diffusion Firehose
Pour permettre à Amazon SES de publier des enregistrements dans votre flux de diffusion Firehose, vous devez utiliser un [rôle Gestion des identités et des accès AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) (IAM) et associer ou modifier la politique d'autorisation et la politique de confiance du rôle. La politique d'autorisations permet au rôle de publier des enregistrements sur votre flux de diffusion Firehose, et la politique de confiance permet à Amazon SES d'assumer ce rôle.
Cette section fournit des exemples des deux stratégies. Pour obtenir des informations sur l'attachement de stratégies à des rôles IAM, consultez [Modification d'un rôle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) dans le *Guide de l'utilisateur IAM*.
### stratégie d'autorisations
La politique d'autorisation suivante permet au rôle de publier des enregistrements de données dans votre flux de diffusion Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Action": [
"firehose:PutRecordBatch"
],
"Resource": [
"arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name"
]
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *delivery-region*Remplacez-le par la AWS région dans laquelle vous avez créé le flux de diffusion Firehose.
+ Remplacez *111122223333* par votre ID de compte AWS .
+ Remplacez *delivery-stream-name* par le nom du flux de diffusion Firehose.
### Stratégie d’approbation
La stratégie d'approbation suivante permet à Amazon SES d'assumer ce rôle.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *delivery-region*Remplacez-le par la AWS région dans laquelle vous avez créé le flux de diffusion Firehose.
+ Remplacez *111122223333* par votre ID de compte AWS .
+ *configuration-set-name*Remplacez-le par le nom de votre ensemble de configuration associé au flux de diffusion Firehose.
# Configurer une EventBridge destination Amazon pour la publication d'événements
Une destination d' EventBridge événement Amazon vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. SES génère et envoie les événements d'envoi d'e-mails que vous définissez lors de la création d'une destination d'événement au bus d'événements EventBridge par défaut. Un [bus d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) est un routeur qui reçoit des événements et peut les transmettre à plusieurs destinations. Vous pouvez en savoir plus sur l'intégration des événements d'envoi d'e-mails EventBridge à Amazon dans[Surveillance des événements SES à l'aide d'Amazon EventBridge](monitoring-eventbridge.md). Comme une destination d' EventBridgeévénement ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure décrite dans cette section explique comment ajouter les détails de la destination d'un EventBridge événement à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Pour ajouter les détails de la destination de l' EventBridge événement à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner le type EventBridge de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de EventBridge destination** *Amazon*, saisi un **nom** de destination et activé la **publication d'événements**, un volet d'information sur le **bus d' EventBridge événements Amazon** s'affiche.
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
# Configuration d'une destination d'événement Amazon Pinpoint pour la publication d'événements
La destination d'un événement Amazon Pinpoint vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. Comme la destination d'un événement Amazon Pinpoint ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure de cette section montre comment ajouter les détails de la destination d'événement Amazon Pinpoint à un jeu de configurations et suppose que vous avez effectué les étapes 1 à 6 de la procédure de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
Des frais supplémentaires s'appliquent pour les types de canaux que vous avez configurés dans vos projets Amazon Pinpoint. Pour plus d'informations, veuillez consulter [Tarification d'Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
**Pour ajouter les détails d'une destination d'événement Amazon Pinpoint à un jeu de configurations à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Amazon Pinpoint comme type de destination d'événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step). Cela suppose que vous avez terminé toutes les étapes précédentes de la procédure de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
**Note**
Amazon Pinpoint ne prend pas en charge les types d'événements **Retards de livraison** ou **Abonnements**.
Après avoir sélectionné le **type de destination** Amazon Pinpoint, saisi un **nom** de destination et activé la **publication d'événements**, le volet des détails du **projet Amazon Pinpoint** s'affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour **Projet**, choisissez un projet Amazon Pinpoint existant ou choisissez **Create a new project in Amazon Pinpoint** (Créer un projet dans Amazon Pinpoint) pour en créer un nouveau.
Pour plus d'informations sur la création d'un projet, consultez [Create a project](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) (Création d'un projet) dans le manuel *Amazon Pinpoint User Guide*.
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
# Configurer une destination d'événement Amazon SNS pour la publication d'événements
La destination d'un événement Amazon SNS vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. Comme la destination d'un événement Amazon SNS ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure de cette section montre comment ajouter les détails de la destination des événements Amazon SNS à un jeu de configuration et suppose que vous avez effectué les étapes 1 à 6 dans [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Note**
Les notifications de commentaires concernant les retours à l'expéditeur, les réclamations et les livraisons peuvent également être configurées via Amazon SNS pour n'importe laquelle de vos identités d'expéditeur vérifiées. Pour plus d'informations, consultez [Configuration des notifications Amazon SNS pour Amazon SES](configure-sns-notifications.md).
Il y a des frais supplémentaires pour l'envoi de messages aux points de terminaison abonnés à vos rubriques Amazon SNS. Pour plus d'informations, consultez la [tarification Amazon SNS](https://aws.amazon.com/sns/pricing/).
**Pour ajouter les détails d'une destination Amazon SNS à un jeu de configurations à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Amazon SNS comme type de destination d'événement dans [Étape 7](event-destinations-manage.md#specify-event-dest-step). Cela suppose que vous avez terminé toutes les étapes précédentes de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de destination** Amazon SNS, saisi un **nom** de destination et activé la **publication d'événements**, le volet thématique **Amazon Simple Notification Service (SNS) s'**affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour **Topic SNS (Rubrique SNS)**, choisissez une rubrique Amazon SNS existante ou choisissez **Create new topic SNS (Créer une rubrique SNS)** pour en créer une nouvelle.
Pour en savoir plus, consultez [Création d'une rubrique (Create a Topic)](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dans le *Guide du développeur d'Amazon Simple Notification Service *.
**Important**
Lorsque vous créez votre rubrique à l'aide d'Amazon SNS, pour **Type**, choisissez uniquement **Standard**. (SES ne prend pas en charge les rubriques de type FIFO.)
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
1. Que vous créiez une nouvelle rubrique SNS ou sélectionniez une rubrique existante, vous devez donner un accès à SES pour publier des notifications sur la rubrique. Sur la page récapitulative de la destination de l'événement à partir de l'étape précédente, choisissez **Amazon SNS** à partir de la colonne **Destination type (Type de destination)**, cela vous mènera à la list **Topics (Rubriques)** dans la console Amazon Simple Notification Service, *effectuez les étapes suivantes à partir de la console Amazon SNS :*
1. Sélectionnez le nom de la rubrique SNS que vous avez créée ou modifiée à l'étape précédente.
1. Sur l'écran de détails du sujet, choisissez **Edit (Modifier)**.
1. Pour donner à Amazon SES la permission de publier des notifications sur la rubrique, sur l'écran **Edit topic (Modifier la rubrique)** de la console SNS, développez **Access policy (Stratégie d'accès)** et dans **JSON editor (Éditeur JSON)**, ajoutez la politique d'autorisation suivante :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *topic\$1region*Remplacez-le par la AWS région dans laquelle vous avez créé le sujet SNS.
+ Remplacez *111122223333* par votre identifiant de AWS compte.
+ *topic\$1name*Remplacez-le par le nom de votre rubrique SNS.
+ *configuration-set-name*Remplacez-le par le nom de votre ensemble de configuration associé à la destination de l'événement SNS.
1. Sélectionnez **Enregistrer les modifications**.
# Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail
Une fois que vous avez [créé un jeu de configurations](event-publishing-create-configuration-set.md) et [ajouté une destination d'événement](event-publishing-add-event-destination.md), la dernière étape de la publication d'événements consiste à envoyer vos e-mails.
Pour publier les événements associés à un e-mail, vous devez indiquer le nom du jeu de configurations à associer à l'e-mail. Vous pouvez éventuellement fournir des balises de message pour classer l'e-mail dans une catégorie.
Vous fournissez ces informations à Amazon SES sous forme de paramètres pour l'API d'envoi d'e-mails, d'en-têtes d'e-mail propres à ou d'en-têtes personnalisés dans votre message MIME. La méthode que vous choisissez dépend de l'interface d'envoi d'e-mails que vous utilisez, comme le montre le tableau suivant.
****
| Interface d'envoi d'e-mails | Méthodes de publication d'événements |
| --- | --- |
| `SendEmail` | Paramètres d'API |
| `SendTemplatedEmail` | Paramètres d'API |
| `SendBulkTemplatedEmail` | Paramètres d'API |
| `SendCustomVerificationEmail` | Paramètres d'API |
| `SendRawEmail` | Paramètres d'API, en-têtes d'e-mail propres à Amazon SES ou en-têtes MIME personnalisés Si vous spécifiez des balises de message en utilisant à la fois des en-têtes de message et des paramètres d'API, Amazon SES utilise uniquement les balises de message fournies par les paramètres d'API. Amazon SES ne joint pas les balises de message spécifiées par les paramètres d'API et les en-têtes. |
| Interface SMTP | En-têtes d'e-mail propres à Amazon SES |
Les sections suivantes expliquent comment spécifier le jeu de configurations et les balises de message à l'aide d'en-têtes et de paramètres d'API.
+ [Utilisation des paramètres d'API Amazon SES](#event-publishing-using-ses-parameters)
+ [Utilisation d'en-têtes d'e-mail propres à Amazon SES](#event-publishing-using-ses-headers)
+ [Utilisation d'en-têtes d'e-mail personnalisés](#event-publishing-using-custom-headers)
**Note**
Vous pouvez éventuellement inclure des balises de message dans les en-têtes de vos e-mails. Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (\$1).
## Utilisation des paramètres d'API Amazon SES
Pour utiliser [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html),, [SendTemplatedEmail[SendBulkTemplatedEmail[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), ou [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)avec la publication d'événements, vous devez spécifier le jeu de configuration et les balises de message en transmettant les structures de données appelées [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)et [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)à l'appel d'API.
Pour en savoir plus sur l'utilisation de l'API Amazon SES, consultez le document [Amazon Simple Email Service API Reference](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Utilisation d'en-têtes d'e-mail propres à Amazon SES
Lorsque vous utilisez `SendRawEmail` ou l'interface SMTP, vous pouvez spécifier le jeu de configurations et les balises de message en ajoutant à l'e-mail des en-têtes propres à Amazon SES. Amazon SES supprime les en-têtes avant d'envoyer l'e-mail. Le tableau suivant présente les noms des en-têtes à utiliser.
| Informations de publication d'événements | En-tête |
| --- | --- |
| Jeu de configurations | `X-SES-CONFIGURATION-SET` |
| Balises de message | `X-SES-MESSAGE-TAGS` |
L'exemple suivant montre l'aspect des têtes dans un e-mail brut que vous envoyez à Amazon SES.
```
1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
2. X-SES-CONFIGURATION-SET: myConfigurationSet
3. From: sender@example.com
4. To: recipient@example.com
5. Subject: Subject
6. Content-Type: multipart/alternative;
7. boundary="----=_boundary"
8.
9. ------=_boundary
10. Content-Type: text/plain; charset=UTF-8
11. Content-Transfer-Encoding: 7bit
12.
13. body
14. ------=_boundary
15. Content-Type: text/html; charset=UTF-8
16. Content-Transfer-Encoding: 7bit
17.
18. body
19. ------=_boundary--
```
## Utilisation d'en-têtes d'e-mail personnalisés
Bien que vous soyez tenu de spécifier le nom du jeu de configurations à l'aide de l'en-tête propre à Amazon SES `X-SES-CONFIGURATION-SET`, vous pouvez spécifier les message des balises en utilisant vos propres en-têtes MIME.
**Note**
Les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES doivent être en ASCII. Si vous spécifiez un nom ou une valeur d'en-tête non ASCII pour la publication d'événements Amazon SES, l'appel d'envoi d'e-mail réussira toujours, mais les statistiques de l'événement ne seront pas transmises à Amazon. CloudWatch
# Utilisation des données d'événement Amazon SES
Une fois que vous avez [configuré la publication de l'événement](monitor-sending-using-event-publishing-setup.md) et spécifié un jeu de configurations pour envoyer des e-mails, vous pouvez récupérer vos événements d'envoi d'e-mail à partir de l'événement de destination que vous avez spécifié lors de la configuration du jeu de configurations associé à l'e-mail.
Cette section explique comment récupérer vos événements d'envoi d'e-mails depuis Amazon CloudWatch et Amazon Data Firehose, et comment interpréter les données d'événements fournies par Amazon SNS.
+ [Extraction des données d'événements Amazon SES depuis CloudWatch](event-publishing-retrieving-cloudwatch.md)
+ [Récupération des données d'événements Amazon SES depuis Firehose](event-publishing-retrieving-firehose.md)
+ [Interprétation des données d'événement Amazon SES à partir d'Amazon SNS](event-publishing-retrieving-sns.md)
# Extraction des données d'événements Amazon SES depuis CloudWatch
Amazon SES peut publier des statistiques relatives à vos événements d'envoi d'e-mails à Amazon CloudWatch. Lorsque vous publiez des données d'événements sur CloudWatch, il fournit ces mesures sous la forme d'un ensemble ordonné de données de séries chronologiques. Vous pouvez utiliser ces métriques pour surveiller les performances de votre envoi d'e-mails. Par exemple, vous pouvez surveiller la métrique de réclamation et définir une CloudWatch alarme pour qu'elle se déclenche lorsque la métrique dépasse une certaine valeur.
Amazon SES peut publier ces événements à deux niveaux de granularité pour CloudWatch :
+ **Dans votre ensemble Compte AWS** — Ces indicateurs grossiers, qui correspondent aux indicateurs que vous surveillez à l'aide de la console Amazon SES et de l'`GetSendStatistics`API, sont des totaux pour l'ensemble Compte AWS de votre entreprise. Amazon SES publie ces statistiques CloudWatch automatiquement.
+ **Fine-grained (Détaillées)** – Ces métriques sont classées par caractéristiques d'e-mail que vous définissez à l'aide des *balises de message*. Pour publier ces métriques sur CloudWatch, vous devez [configurer la publication d'événements](monitor-sending-using-event-publishing-setup.md) avec une destination d' CloudWatch événement et [spécifier un ensemble de configuration](event-publishing-send-email.md) lorsque vous envoyez un e-mail. Vous pouvez également spécifier des balises de message ou utiliser des [balises automatiques](monitor-using-event-publishing.md#event-publishing-how-works) qu'Amazon SES fournit automatiquement.
Cette section décrit les métriques disponibles et comment afficher les métriques dans CloudWatch.
## Métriques disponibles
Vous pouvez publier les statistiques d'envoi d'e-mails Amazon SES suivantes sur CloudWatch :
+ **Send (Envoi)** – La demande d'envoi a réussi et Amazon SES tente de remettre le message au serveur de messagerie du destinataire. (Si une suppression globale ou au niveau du compte est utilisée, SES la comptera toujours comme un envoi, mais la livraison sera supprimée).
+ **RenderingFailure**— L'e-mail n'a pas été envoyé en raison d'un problème de rendu du modèle. Ce type d'événement peut se produire lorsqu'il manque des données du modèle ou lorsqu'il n'y a pas concordance entre les paramètres du modèle et les données. Ce type d'événement ne se produit que lorsque vous envoyez un e-mail à l'aide des opérations d'API [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html).
+ **Reject (Rejet)** – Amazon SES a accepté l'e-mail, a déterminé qu'il contenait un virus et l'a rejeté. Amazon SES n'a pas tenté de remettre l'e-mail au serveur de messagerie du destinataire.
+ **Delivery (Livraison)** – Amazon SES a bien remis l'e-mail au serveur de messagerie du destinataire.
+ **Bounce** – *Message d'erreur définitif* indiquant que le serveur de messagerie du destinataire a définitivement rejeté l'e-mail. (Les *soft bounces* ne sont inclus que lorsque SES n'essaie plus de livrer l'e-mail. En général, ces rebonds souples indiquent un échec de livraison, bien que dans certains cas, un rebond souple puisse être renvoyé même lorsque le courrier parvient avec succès dans la boîte de réception du destinataire. Cela se produit généralement lorsque le destinataire envoie une réponse out-of-office automatique. Pour en savoir plus sur les soft bounces, consultez cet article de [AWS Re:Post](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **Complaint (Réclamation)** – L'e-mail a été correctement remis au serveur de messagerie du destinataire, mais le destinataire l'a marqué comme courrier indésirable.
+ **DeliveryDelay**— L'e-mail n'a pas pu être remis au serveur de messagerie du destinataire en raison d'un problème temporaire. Des retards de livraison peuvent se produire, par exemple lorsque la boîte de réception du destinataire est pleine ou lorsque le serveur de messagerie de réception rencontre un problème transitoire.
+ **Subscription (Abonnement)** – L'e-mail a été envoyé avec succès, mais le destinataire a mis à jour les préférences d'abonnement en cliquant sur `List-Unsubscribe` dans l'en-tête de l'e-mail ou le lien `Unsubscribe` dans le pied-de-page.
+ **Open (Ouverture)** – Le destinataire a reçu le message et l'a ouvert dans son client de messagerie.
+ **Click (Clic)** – Le destinataire a cliqué sur un ou plusieurs liens contenus dans l'e-mail.
## Dimensions disponibles
CloudWatch utilise les noms de dimension que vous spécifiez lorsque vous ajoutez une destination d' CloudWatch événement à un ensemble de configuration dans Amazon SES. Pour de plus amples informations, veuillez consulter [Configurer une destination d' CloudWatch événement pour la publication d'événements](event-publishing-add-event-destination-cloudwatch.md).
## Afficher les métriques Amazon SES dans la CloudWatch console
La procédure suivante explique comment consulter les métriques de publication de vos événements Amazon SES à l'aide de la CloudWatch console.
**Pour afficher les métriques à l'aide de la CloudWatch console**
1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Si nécessaire, changez la région. Dans la barre de navigation, sélectionnez la région dans laquelle se trouvent vos AWS ressources. Pour plus d’informations, consultez [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html).
1. Dans le volet de navigation, sélectionnez **Toutes les métriques**.
1. Dans le volet **Métriques**, sélectionnez **SES**.
1. Sélectionnez la métrique que vous voulez afficher. Pour consulter les [métriques de publication d'événement détaillées](monitor-using-event-publishing.md), choisissez la combinaison de dimensions que vous avez spécifiée lors de la [configuration de votre destination d'événement CloudWatch](event-publishing-add-event-destination-cloudwatch.md). Pour en savoir plus sur l'affichage des métriques avec CloudWatch, consultez [Utiliser CloudWatch les métriques Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
**Pour consulter les statistiques à l'aide du AWS CLI**
+ À partir d'une invite de commande, utilisez la commande suivante :
```
1. aws cloudwatch list-metrics --namespace "AWS/SES"
```
# Récupération des données d'événements Amazon SES depuis Firehose
Amazon SES publie les événements d'envoi d'e-mails à Firehose sous forme d'enregistrements JSON. Firehose publie ensuite les enregistrements vers la destination du AWS service que vous avez choisie lorsque vous avez configuré le flux de diffusion dans Firehose. Pour plus d'informations sur la configuration des flux de diffusion Firehose, consultez la section [Création d'un flux de diffusion Firehose dans](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) le manuel Amazon *Data Firehose* Developer Guide.
**Topics**
+ [Contenu des données d'événements publiées par Amazon SES sur Firehose](event-publishing-retrieving-firehose-contents.md)
+ [Exemples de données d'événements publiées par Amazon SES sur Firehose](event-publishing-retrieving-firehose-examples.md)
# Contenu des données d'événements publiées par Amazon SES sur Firehose
Amazon SES publie des enregistrements d'événements d'envoi d'e-mails à Amazon Data Firehose au format JSON. Lors de la publication d'événements sur Firehose, Amazon SES suit chaque enregistrement JSON avec un caractère de nouvelle ligne.
Vous pouvez trouver des exemples de registres pour tous ces types de notifications dans [Exemples de données d'événements publiées par Amazon SES sur Firehose](event-publishing-retrieving-firehose-examples.md).
**Topics**
+ [Objet JSON de niveau supérieur](#event-publishing-retrieving-firehose-contents-top-level-json-object)
+ [Objet de l'e-mail](#event-publishing-retrieving-firehose-contents-mail-object)
+ [Objet bounce](#event-publishing-retrieving-firehose-contents-bounce-object)
+ [Objet de réclamation](#event-publishing-retrieving-firehose-contents-complaint-object)
+ [Objet Delivery](#event-publishing-retrieving-firehose-contents-delivery-object)
+ [Objet Send](#event-publishing-retrieving-firehose-contents-send-object)
+ [Objet Reject](#event-publishing-retrieving-firehose-contents-reject-object)
+ [Objet Open](#event-publishing-retrieving-firehose-contents-open-object)
+ [Objet Click](#event-publishing-retrieving-firehose-contents-click-object)
+ [Objet Rendering Failure](#event-publishing-retrieving-firehose-contents-failure-object)
+ [DeliveryDelay objet](#event-publishing-retrieving-firehose-delivery-delay-object)
+ [Objet Abonnement](#event-publishing-retrieving-firehose-subscription-object)
## Objet JSON de niveau supérieur
L'objet JSON de niveau supérieur d'un registre d'événement d'envoi d'e-mail contient les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `eventType` | Chaîne qui décrit le type d'événement. Valeurs possibles : `Bounce`, `Complaint`, `Delivery`, `Send`, `Reject`, `Open`, `Click`, `Rendering Failure`, `DeliveryDelay` ou `Subscription`. Si vous n'avez pas effectué la [Configuration de la publication d'événements](monitor-sending-using-event-publishing-setup.md), ce champ est nommé `notificationType`. |
| `mail` | Objet JSON qui contient des informations sur l'e-mail qui a généré l'événement. |
| `bounce` | Ce champ est présent uniquement si `eventType` a la valeur `Bounce`. Il contient des informations sur le retour à l'expéditeur. |
| `complaint` | Ce champ est présent uniquement si `eventType` a la valeur `Complaint`. Il contient des informations sur la réclamation. |
| `delivery` | Ce champ est présent uniquement si `eventType` a la valeur `Delivery`. Il contient des informations sur la remise. |
| `send` | Ce champ est présent uniquement si `eventType` a la valeur `Send`. |
| `reject` | Ce champ est présent uniquement si `eventType` a la valeur `Reject`. Il contient des informations sur le rejet. |
| `open` | Ce champ est présent uniquement si `eventType` a la valeur `Open`. Il contient des informations sur l'événement ouvert. |
| `click` | Ce champ est présent uniquement si `eventType` a la valeur `Click`. Il contient des informations sur l'événement de clic. |
| `failure` | Ce champ est présent uniquement si `eventType` a la valeur `Rendering Failure`. Il contient des informations sur l'événement d'échec d'affichage. |
| `deliveryDelay` | Ce champ est présent uniquement si `eventType` a la valeur `DeliveryDelay`. Il contient des informations sur la livraison différée d'un e-mail. |
| `subscription` | Ce champ est présent uniquement si `eventType` a la valeur `Subscription`. Il contient des informations sur les préférences d'abonnement. |
## Objet de l'e-mail
Chaque registre d'événement d'envoi d'e-mail contient des informations sur l'e-mail d'origine dans l'objet `mail`. L'objet JSON qui contient les informations sur un objet `mail` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `timestamp` | Date et heure, au ISO8601 format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le message a été envoyé. |
| `messageId` | ID unique attribué par Amazon SES au message. Amazon SES vous a renvoyé cette valeur lorsque vous avez envoyé le message. Cet ID de message a été attribué par Amazon SES. Vous trouverez l'ID de message de l'e-mail d'origine dans les champs `headers` et `commonHeaders` de l'objet `mail`. |
| `source` | Adresse e-mail à partir de laquelle le message a été envoyé (adresse MAIL FROM de l'enveloppe). |
| `sourceArn` | ARN (Amazon Resource Name) de l'identité qui a été utilisée pour envoyer l'e-mail. Dans le cas d'une autorisation d'envoi, `sourceArn` correspond à l'ARN de l'identité dont le propriétaire a autorisé l'utilisation pour l'envoi de l'e-mail par l'expéditeur délégué. Pour en savoir plus sur l'autorisation d'envoi, consultez [Méthodes d'authentification d'e-mailUtilisation de l'autorisation d'envoi](sending-authorization.md). |
| `sendingAccountId` | L' AWS identifiant du compte utilisé pour envoyer l'e-mail. Dans le cas de l'autorisation d'envoi, `sendingAccountId` correspond à l'ID de compte de l'expéditeur délégué. |
| `destination` | Liste des adresses e-mail destinataires de l'e-mail original. |
| `headersTruncated` | Chaîne qui spécifie si les en-têtes ont été tronqués dans la notification, ce qui a lieu s'ils ont une taille supérieure à 10 Ko. Les valeurs possibles sont `true` et `false`. |
| `headers` | Liste des en-têtes d'origine de l'e-mail. Chaque en-tête de la liste a un champ `name` et un champ `value`. Tout ID de message du champ `headers` provient du message d'origine que vous avez transmis à Amazon SES. L'ID de message qu'Amazon SES a ensuite affecté au message se trouve dans le champ `messageId` de l'objet `mail`. |
| `commonHeaders` | Mappage des en-têtes originaux de l'e-mail communément utilisés. Tout ID de message contenu dans le champ `commonHeaders` correspond à l'ID de message qu'Amazon SES a par la suite affecté au message dans le champ `messageId` de l'objet `mail`. |
| `tags` | Une liste des identifications associées à l'e-mail. |
## Objet bounce
L'objet JSON qui contient les informations sur un événement `Bounce` comporte toujours les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `bounceType` | Type de retour à l'expéditeur, tel que déterminé par Amazon SES. |
| `bounceSubType` | Sous-type de retour à l'expéditeur, tel que déterminé par Amazon SES. |
| `bouncedRecipients` | Liste qui contient les informations sur les destinataires de l'e-mail d'origine ayant fait l'objet d'un retour à l'expéditeur. |
| `timestamp` | Date et heure, au ISO8601 format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le FAI a envoyé la notification de rebond. |
| `feedbackId` | ID unique du retour à l'expéditeur. |
| `reportingMTA` | Valeur du champ `Reporting-MTA` du DSN. Il s'agit de la valeur de la MTA qui a tenté d'effectuer l'opération de remise, de relais ou de passerelle décrite dans le DSN. Ce champ n'apparaît que si une notification de statut de livraison (DSN) a été attachée au retour à l'expéditeur. |
### Destinataires à l'origine d'un retour à l'expéditeur
Un événement de retour à l'expéditeur peut se rapporter à un seul destinataire ou à plusieurs destinataires. Le champ `bouncedRecipients` contient une liste d'objets (un objet par destinataire auquel l'événement de retour à l'expéditeur s'applique), ainsi que le champ suivant.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse e-mail du destinataire. Si un DSN est disponible, l'adresse correspond à la valeur du champ `Final-Recipient` du DSN. |
En outre, si un DSN est attaché au retour à l'expéditeur, les champs suivants peuvent également être présents.
| Nom de champ | Description |
| --- | --- |
| `action` | Valeur du champ `Action` du DSN. Cette valeur indique l'action effectuée par la MTA de suivi comme résultat de sa tentative de remettre le message à ce destinataire. |
| `status` | Valeur du champ `Status` du DSN. Il s'agit du code de statut indépendant du transport par destinataire qui indique le statut de remise du message. |
| `diagnosticCode` | Code de statut émis par la MTA de suivi. Il s'agit de la valeur du champ `Diagnostic-Code` du DSN. Ce champ peut être absent du DSN (et donc également absent du JSON). |
### Types de retour à l'expéditeur
Chaque évènement de retour à l'expéditeur présente l'un des types affichés dans le tableau suivant.
Le système de publication d'événements ne publie que les retours à l'expéditeur définitifs ou temporaires qui ne seront plus réessayés par Amazon SES. Lorsque vous recevez des retours à l'expéditeur marqués `Permanent`, vous devez supprimer les adresses e-mail correspondantes de votre liste de diffusion ; vous ne pourrez plus leur envoyer d'e-mails à l'avenir. Des retours à l'expéditeur `Transient` vous sont envoyés lorsqu'un message a fait plusieurs fois l'objet d'un message d'erreur temporaire, et qu'Amazon SES a arrêté toute tentative de remise. Plus tard, vous aurez peut-être la possibilité de renvoyer avec succès l'e-mail à une adresse ayant dans un premier temps généré un retour à l'expéditeur `Transient`.
| bounceType | bounceSubType | Description |
| --- | --- | --- |
| `Undetermined` | `Undetermined` | Amazon SES n'a pas pu déterminer de motif de retour à l'expéditeur. |
| `Permanent` | `General` | Amazon SES a reçu un message d'erreur définitif général. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion. |
| `Permanent` | `NoEmail` | Amazon SES a reçu un message d'erreur définitif, car l'adresse e-mail cible n'existe pas. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion. |
| `Permanent` | `Suppressed` | Amazon SES a supprimé l'envoi à cette adresse, car elle a un historique récent de retour à l'expéditeur sous la forme d'adresse non valide. Pour remplacer la liste de suppression globale, consultez [Utilisation de la liste de suppression au niveau du compte Amazon SES](sending-email-suppression-list.md). |
| Permanent | OnAccountSuppressionList | Amazon SES a supprimé l'envoi à cette adresse car celle-ci figure dans la [liste de suppression au niveau du compte](sending-email-suppression-list.md). Cela n'est pas pris en compte dans votre métrique de taux de retours à l'expéditeur. |
| `Transient` | `General` | Amazon SES a reçu un retour à l'expéditeur général. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir. |
| `Transient` | `MailboxFull` | Amazon SES a reçu un retour à l'expéditeur de boîte aux lettres pleine. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir. |
| `Transient` | `MessageTooLarge` | Amazon SES a reçu un message de retour à l'expéditeur trop volumineux. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous réduisez la taille du message. |
| `Transient` | `CustomTimeoutExceeded` | Amazon SES n'a pas réussi à envoyer l'e-mail dans le délai spécifié par l'expéditeur de l'e-mail. *(Le message de rebond indiquera la raison de tout échec éventuel de tentative de livraison dans le cadre du TTL défini.)* |
| `Transient` | `ContentRejected` | Amazon SES a reçu un retour à l'expéditeur de contenu rejeté. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous modifiez le contenu du message. |
| `Transient` | `AttachmentRejected` | Amazon SES a reçu un retour à l'expéditeur de pièce jointe rejetée. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous supprimez ou modifiez la pièce jointe. |
## Objet de réclamation
L'objet JSON qui contient les informations sur un événement `Complaint` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `complainedRecipients` | Liste contenant des informations sur les destinataires qui ont soumis la réclamation. |
| `timestamp` | Date et heure, au ISO8601 format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le FAI a envoyé la notification de plainte. |
| `feedbackId` | ID unique de la réclamation. |
| `complaintSubType` | Sous-type de la réclamation, tel que déterminé par Amazon SES. |
De plus, si un rapport de commentaire est attaché à la réclamation, les champs suivants peuvent être présents.
| Nom de champ | Description |
| --- | --- |
| `userAgent` | Valeur du champ `User-Agent` du rapport de commentaires. Cette valeur indique le nom et la version du système ayant généré le rapport. |
| `complaintFeedbackType` | Valeur du champ `Feedback-Type` du rapport de commentaires reçu de l'ISP. La valeur contient le type de commentaires. |
| `arrivalDate` | La valeur du `Received-Date` champ `Arrival-Date` ou du rapport de commentaires au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh Le champ peut être absent du rapport (et donc également absent du JSON). |
### Destinataires à l'origine d'une réclamation
Le champ `complainedRecipients` contient la liste des destinataires susceptibles d'avoir déposé la réclamation.
**Important**
Étant donné que ISPs la plupart des utilisateurs suppriment l'adresse e-mail du destinataire qui a soumis la plainte à partir de leur notification de plainte, cette liste contient des informations sur les destinataires susceptibles d'avoir envoyé la plainte, en fonction des destinataires du message d'origine et du fournisseur de services Internet auprès duquel nous avons reçu la plainte. Amazon SES effectue une recherche sur le message d'origine afin de déterminer la liste des destinataires.
Les objets JSON de cette liste contiennent le champ suivant.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse e-mail du destinataire. |
### Types de réclamation
Vous pouvez voir les types de réclamation suivants dans le champ `complaintFeedbackType` tels qu'attribués par l'ISP du rapport, selon le [site web IANA (Internet Assigned Numbers)](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2) :
| Nom de champ | Description |
| --- | --- |
| `abuse` | Indique un e-mail indésirable ou un autre type d'e-mail malveillant. |
| `auth-failure` | Rapport d'échec d'authentification d'e-mail. |
| `fraud` | Indique certains types de fraude ou d'activité d'hameçonnage. |
| `not-spam` | Indique que l'entité qui fournit le rapport ne considère pas le message en tant que courrier indésirable. Cette option permet de corriger un message qui a été mal balisé ou classé à tort comme courrier indésirable. |
| `other` | Indique tout autre commentaire ne pouvant être classé dans les autres types enregistrés. |
| `virus` | Signale qu'un virus a été détecté dans le message d'origine. |
## Objet Delivery
L'objet JSON qui contient les informations sur un événement `Delivery` comporte toujours les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `timestamp` | Date et heure auxquelles Amazon SES a envoyé l'e-mail au serveur de messagerie du destinataire, au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `processingTimeMillis` | Délai, en millisecondes, entre le moment où Amazon SES a accepté la demande de l'expéditeur et le moment où Amazon SES a transmis le message au serveur de messagerie du destinataire. |
| `recipients` | Liste des destinataires auxquels l'événement de remise s'applique. |
| `smtpResponse` | Message de réponse SMTP du FAI distant ayant accepté l'e-mail depuis Amazon SES. Ce message varie selon l'e-mail, le serveur de messagerie de réception et l'ISP de réception. |
| `reportingMTA` | Nom d'hôte du serveur de messagerie Amazon SES ayant envoyé l'e-mail. |
| `remoteMtaIp` | Adresse IP de la MTA à laquelle Amazon SES a remis l'e-mail. |
## Objet Send
L'objet JSON qui contient les informations sur un événement `send` est toujours vide.
## Objet Reject
L'objet JSON qui contient les informations sur un événement `Reject` comporte toujours les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `reason` | Raison du rejet de l'e-mail. La seule valeur possible est `Bad content`, ce qui signifie qu'Amazon SES a détecté que l'e-mail contenait un virus. Lorsqu'un message est rejeté, Amazon SES arrête de le traiter et ne tente pas de le remettre au serveur de messagerie du destinataire. |
## Objet Open
L'objet JSON qui contient les informations sur un événement `Open` comporte toujours les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `ipAddress` | Adresse IP du destinataire. |
| `timestamp` | Date et heure auxquelles l'événement ouvert s'est produit au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `userAgent` | Agent utilisateur de l'appareil ou client de messagerie que le destinataire a utilisé pour ouvrir l'e-mail. |
## Objet Click
L'objet JSON qui contient les informations sur un événement `Click` comporte toujours les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `ipAddress` | Adresse IP du destinataire. |
| `timestamp` | Date et heure auxquelles l'événement de clic s'est produit au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `userAgent` | Agent utilisateur du client que le destinataire a utilisé pour cliquer sur un lien dans l'e-mail. |
| `link` | URL du lien sur lequel le destinataire a cliqué. |
| `linkTags` | Liste des balises ajoutées au lien à l'aide de l'attribut `ses:tags`. Pour en savoir plus sur l'ajout de balises aux liens de vos e-mails, consultez [Q5. Puis-je baliser les liens avec des identificateurs uniques ?](faqs-metrics.md#sending-metric-faqs-clicks-q5) dans le [Statistiques d'envoi d'e-mails Amazon SES FAQs](faqs-metrics.md). |
## Objet Rendering Failure
L'objet JSON qui contient les informations sur un événement `Rendering Failure` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `templateName` | Nom du modèle utilisé pour envoyer l'e-mail. |
| `errorMessage` | Message qui fournit des informations supplémentaires sur l'échec d'affichage. |
## DeliveryDelay objet
L'objet JSON qui contient les informations sur un événement `DeliveryDelay` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `delayType` | Type de retard. Les valeurs possibles sont : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/event-publishing-retrieving-firehose-contents.html) |
| `delayedRecipients` | Objet contenant des informations sur le destinataire de l'e-mail. |
| `expirationTime` | Date et heure auxquelles Amazon SES cessera d'essayer de remettre le message. Cette valeur est affichée au format ISO 8601. |
| `reportingMTA` | Adresse IP de l'agent de transfert de messages (MTA) qui a signalé le retard. |
| `timestamp` | La date et l'heure auxquelles le retard s'est produit, illustrées au format ISO 8601. |
### Destinataires retardés
L'objet `delayedRecipients` contient les valeurs suivantes.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse électronique ayant entraîné un retard dans la livraison du message. |
| `status` | Code d'état SMTP associé au délai de livraison. |
| `diagnosticCode` | Code de diagnostic fourni par l'agent de transfert de message (MTA) récepteur. |
## Objet Abonnement
L'objet JSON qui contient les informations sur un événement `Subscription` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `contactList` | Nom de la liste sur laquelle figure le contact. |
| `timestamp` | Date et heure, ISO8601 au format *(YYYY-MM DDThh -:MM:SS.sz*), auxquelles le fournisseur de services Internet a envoyé la notification d'abonnement. |
| `source` | Adresse e-mail à partir de laquelle le message a été envoyé (adresse MAIL FROM de l'enveloppe). |
| `newTopicPreferences` | Structure de données JSON (carte) qui spécifie l'état d'abonnement de toutes les rubriques de la liste de contacts en indiquant le statut après une modification (contact abonné ou désabonné). |
| `oldTopicPreferences` | Structure de données JSON (carte) qui spécifie le statut d'abonnement de toutes les rubriques de la liste de contacts en indiquant l'état avant la modification (contact souscrit ou désabonné). |
### Préférences de la nouvelle ou de l'ancienne rubrique
Les objets `newTopicPreferences` et `oldTopicPreferences` contiennent les valeurs suivantes.
| Nom de champ | Description |
| --- | --- |
| `unsubscribeAll` | Indique si le contact s'est désabonné de toutes les rubriques de la liste de contacts. |
| `topicSubscriptionStatus` | Spécifie le statut d'abonnement du sujet dans le `topicName` champ indiquant s'il est actuellement abonné pour recevoir des notifications de SES pour le type d'événement spécifié. Les valeurs possibles sont **OptIn**(abonné) ou **OptOut**(désabonné) dans le `subscriptionStatus` champ. |
| `topicDefaultSubscriptionStatus` | Spécifie le statut d'abonnement par défaut du sujet dans le `topicName` champ déterminant si les nouveaux sujets ajoutés à la destination de l'événement seront abonnés ou désabonnés par défaut. Les valeurs possibles sont **OptIn**(abonné par défaut) ou **OptOut**(désabonné par défaut) dans le `subscriptionStatus` champ. |
# Exemples de données d'événements publiées par Amazon SES sur Firehose
Cette section fournit des exemples des types d'enregistrements d'événements d'envoi d'e-mails publiés par Amazon SES sur Firehose.
**Topics**
+ [registre de retour à l'expéditeur](#event-publishing-retrieving-firehose-bounce)
+ [registre de réclamation](#event-publishing-retrieving-firehose-complaint)
+ [registre de remise](#event-publishing-retrieving-firehose-delivery)
+ [registre d'envoi](#event-publishing-retrieving-firehose-send)
+ [registre de rejet](#event-publishing-retrieving-firehose-reject)
+ [registre d'ouverture](#event-publishing-retrieving-firehose-open)
+ [registre de clic](#event-publishing-retrieving-firehose-click)
+ [registre d'échec de rendu](#event-publishing-retrieving-firehose-failure)
+ [DeliveryDelay record](#event-publishing-retrieving-firehose-delayed-delivery)
+ [Abonnement](#event-publishing-retrieving-firehose-subscription)
**Note**
Dans les exemples suivants, où un champ `tag` est utilisé, il utilise la publication d'événements via un jeu de configuration pour lequel SES prend en charge la publication d'étiquettes pour tous les types d'événements. Si vous utilisez des notifications de commentaires directement sur l'identité, SES ne publie pas d'étiquettes. Découvrez comment ajouter des étiquettes lors de la [création d'un jeu de configuration](creating-configuration-sets.md) ou de la [modification d'un jeu de configuration](managing-configuration-sets.md#console-detail-configuration-sets).
## registre de retour à l'expéditeur
Voici un exemple d'enregistrement d'`Bounce`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## registre de réclamation
Voici un exemple d'enregistrement d'`Complaint`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## registre de remise
Voici un exemple d'enregistrement d'`Delivery`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## registre d'envoi
Voici un exemple d'enregistrement d'`Send`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## registre de rejet
Voici un exemple d'enregistrement d'`Reject`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## registre d'ouverture
Voici un exemple d'enregistrement d'`Open`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## registre de clic
Voici un exemple d'enregistrement d'`Click`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## registre d'échec de rendu
Voici un exemple d'enregistrement d'`Rendering Failure`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay record
Voici un exemple d'enregistrement d'`DeliveryDelay`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Abonnement
Voici un exemple d'enregistrement d'`Subscription`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```
# Interprétation des données d'événement Amazon SES à partir d'Amazon SNS
Amazon SES publie les événements d'envoi d'e-mails dans Amazon Simple Notification Service (Amazon SNS) sous forme de registres JSON. Amazon SNS transmet ensuite les notifications aux points de terminaison abonnés à la rubrique Amazon SNS associée à la destination de l'événement. Pour plus d'informations sur la configuration des rubriques et des abonnements dans Amazon SNS, veuillez consulter [Getting Started (Mise en route)](https://docs.aws.amazon.com/sns/latest/dg/GettingStarted.html) dans le *Guide du développeur d'Amazon Simple Notification Service*.
Pour obtenir une description des contenus de registre et des exemples de registre, consultez les sections suivantes.
+ [Contenu des registres d'événements](event-publishing-retrieving-sns-contents.md)
+ [Exemples de registre d'événement](event-publishing-retrieving-sns-examples.md)
# Contenu des données d'événement publiées par Amazon SES dans Amazon SNS
Amazon SES publie les registres d'événements d'envoi d'e-mails dans Amazon Simple Notification Service au format JSON.
Vous pouvez trouver des exemples de registres pour tous ces types de notifications dans [Exemples de données d'événement publiées par Amazon SES sur Amazon SNS](event-publishing-retrieving-sns-examples.md).
**Topics**
+ [Objet JSON de niveau supérieur](#event-publishing-retrieving-sns-contents-top-level-json-object)
+ [Objet de l'e-mail](#event-publishing-retrieving-sns-contents-mail-object)
+ [Objet bounce](#event-publishing-retrieving-sns-contents-bounce-object)
+ [Objet de réclamation](#event-publishing-retrieving-sns-contents-complaint-object)
+ [Objet Delivery](#event-publishing-retrieving-sns-contents-delivery-object)
+ [Objet Send](#event-publishing-retrieving-sns-contents-send-object)
+ [Objet Reject](#event-publishing-retrieving-sns-contents-reject-object)
+ [Objet Open](#event-publishing-retrieving-sns-contents-open-object)
+ [Objet Click](#event-publishing-retrieving-sns-contents-click-object)
+ [Objet Rendering Failure](#event-publishing-retrieving-sns-contents-failure-object)
+ [DeliveryDelay objet](#event-publishing-retrieving-sns-contents-delivery-delay-object)
+ [Objet Abonnement](#event-publishing-retrieving-sns-contents-subscription-object)
## Objet JSON de niveau supérieur
L'objet JSON de niveau supérieur d'un registre d'événement d'envoi d'e-mail contient les champs suivants. Le type d'événement détermine quels autres objets sont présents.
| Nom de champ | Description |
| --- | --- |
| `eventType` | Chaîne qui décrit le type d'événement. Valeurs possibles : `Bounce`, `Complaint`, `Delivery`, `Send`, `Reject`, `Open`, `Click`, `Rendering Failure`, `DeliveryDelay` ou `Subscription`. Si vous n'avez pas effectué la [Configuration de la publication d'événements](monitor-sending-using-event-publishing-setup.md), ce champ est nommé `notificationType`. |
| `mail` | Objet JSON qui contient des informations sur l'e-mail qui a généré l'événement. |
| `bounce` | Ce champ est présent uniquement si `eventType` a la valeur `Bounce`. Il contient des informations sur le retour à l'expéditeur. |
| `complaint` | Ce champ est présent uniquement si `eventType` a la valeur `Complaint`. Il contient des informations sur la réclamation. |
| `delivery` | Ce champ est présent uniquement si `eventType` a la valeur `Delivery`. Il contient des informations sur la remise. |
| `send` | Ce champ est présent uniquement si `eventType` a la valeur `Send`. |
| `reject` | Ce champ est présent uniquement si `eventType` a la valeur `Reject`. Il contient des informations sur le rejet. |
| `open` | Ce champ est présent uniquement si `eventType` a la valeur `Open`. Il contient des informations sur l'événement ouvert. |
| `click` | Ce champ est présent uniquement si `eventType` a la valeur `Click`. Il contient des informations sur l'événement de clic. |
| `failure` | Ce champ est présent uniquement si `eventType` a la valeur `Rendering Failure`. Il contient des informations sur l'événement d'échec d'affichage. |
| `deliveryDelay` | Ce champ est présent uniquement si `eventType` a la valeur `DeliveryDelay`. Il contient des informations sur la livraison différée d'un e-mail. |
| `subscription` | Ce champ est présent uniquement si `eventType` a la valeur `Subscription`. Il contient des informations sur les préférences d'abonnement. |
## Objet de l'e-mail
Chaque registre d'événement d'envoi d'e-mail contient des informations sur l'e-mail d'origine dans l'objet `mail`. L'objet JSON qui contient les informations sur un objet `mail` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `timestamp` | Date et heure, au ISO8601 format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le message a été envoyé. |
| `messageId` | ID unique attribué par Amazon SES au message. Amazon SES vous a renvoyé cette valeur lorsque vous avez envoyé le message. Cet ID de message a été attribué par Amazon SES. Vous trouverez l'ID de message de l'e-mail d'origine dans les champs `headers` et `commonHeaders` de l'objet `mail`. |
| `source` | Adresse e-mail à partir de laquelle le message a été envoyé (adresse MAIL FROM de l'enveloppe). |
| `sourceArn` | ARN (Amazon Resource Name) de l'identité qui a été utilisée pour envoyer l'e-mail. Dans le cas d'une autorisation d'envoi, `sourceArn` correspond à l'ARN de l'identité dont le propriétaire a autorisé l'utilisation pour l'envoi de l'e-mail par l'expéditeur délégué. Pour en savoir plus sur l'autorisation d'envoi, consultez [Méthodes d'authentification d'e-mailUtilisation de l'autorisation d'envoi](sending-authorization.md). |
| `sendingAccountId` | L' AWS identifiant du compte qui a été utilisé pour envoyer l'e-mail. Dans le cas de l'autorisation d'envoi, `sendingAccountId` correspond à l'ID de compte de l'expéditeur délégué. |
| `destination` | Liste des adresses e-mail destinataires de l'e-mail original. |
| `headersTruncated` | Chaîne qui spécifie si les en-têtes ont été tronqués dans la notification, ce qui a lieu s'ils ont une taille supérieure à 10 Ko. Les valeurs possibles sont `true` et `false`. |
| `headers` | Liste des en-têtes d'origine de l'e-mail. Chaque en-tête de la liste a un champ `name` et un champ `value`. Tout ID de message du champ `headers` provient du message d'origine que vous avez transmis à Amazon SES. L'ID de message qu'Amazon SES a ensuite affecté au message se trouve dans le champ `messageId` de l'objet `mail`. |
| `commonHeaders` | Mappage des en-têtes originaux de l'e-mail communément utilisés. Tout ID de message contenu dans le champ `commonHeaders` correspond à l'ID de message qu'Amazon SES a par la suite affecté au message dans le champ `messageId` de l'objet `mail`. |
| `tags` | Une liste des identifications associées à l'e-mail. |
## Objet bounce
L'objet JSON qui contient les informations sur un événement `Bounce` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `bounceType` | Type de retour à l'expéditeur, tel que déterminé par Amazon SES. |
| `bounceSubType` | Sous-type de retour à l'expéditeur, tel que déterminé par Amazon SES. |
| `bouncedRecipients` | Liste qui contient les informations sur les destinataires de l'e-mail d'origine ayant fait l'objet d'un retour à l'expéditeur. |
| `timestamp` | Date et heure, au ISO8601 format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le FAI a envoyé la notification de rebond. |
| `feedbackId` | ID unique du retour à l'expéditeur. |
| `reportingMTA` | Valeur du champ `Reporting-MTA` du DSN. Il s'agit de la valeur de la MTA qui a tenté d'effectuer l'opération de remise, de relais ou de passerelle décrite dans le DSN. Ce champ n'apparaît que si une notification de statut de livraison (DSN) a été attachée au retour à l'expéditeur. |
### Destinataires à l'origine d'un retour à l'expéditeur
Un événement de retour à l'expéditeur peut se rapporter à un seul destinataire ou à plusieurs destinataires. Le champ `bouncedRecipients` contient une liste d'objets (un objet par destinataire dont l'adresse e-mail a généré un retour à l'expéditeur), ainsi que le champ suivant.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse e-mail du destinataire. Si un DSN est disponible, l'adresse correspond à la valeur du champ `Final-Recipient` du DSN. |
En outre, si un DSN est attaché au retour à l'expéditeur, les champs suivants peuvent également être présents.
| Nom de champ | Description |
| --- | --- |
| `action` | Valeur du champ `Action` du DSN. Cette valeur indique l'action effectuée par la MTA de suivi comme résultat de sa tentative de remettre le message à ce destinataire. |
| `status` | Valeur du champ `Status` du DSN. Il s'agit du code de statut indépendant du transport par destinataire qui indique le statut de remise du message. |
| `diagnosticCode` | Code de statut émis par la MTA de suivi. Il s'agit de la valeur du champ `Diagnostic-Code` du DSN. Ce champ peut être absent du DSN (et donc également absent du JSON). |
### Types de retour à l'expéditeur
Chaque évènement de retour à l'expéditeur présente l'un des types affichés dans le tableau suivant.
Le système de publication d'événements ne publie que les retours à l'expéditeur définitifs ou temporaires qui ne sont plus retentés par Amazon SES. Lorsque vous recevez des retours à l'expéditeur marqués `Permanent`, vous devez supprimer les adresses e-mail correspondantes de votre liste de diffusion ; vous ne pourrez plus leur envoyer d'e-mails à l'avenir. Des retours à l'expéditeur `Transient` vous sont envoyés lorsqu'un message a fait plusieurs fois l'objet d'un message d'erreur temporaire, et qu'Amazon SES a arrêté toute tentative de remise. Plus tard, vous aurez peut-être la possibilité de renvoyer avec succès l'e-mail à une adresse ayant dans un premier temps généré un retour à l'expéditeur `Transient`.
| bounceType | bounceSubType | Description |
| --- | --- | --- |
| `Undetermined` | `Undetermined` | Amazon SES n'a pas pu déterminer de motif de retour à l'expéditeur. |
| `Permanent` | `General` | Amazon SES a reçu un message d'erreur définitif général. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion. |
| `Permanent` | `NoEmail` | Amazon SES a reçu un message d'erreur définitif, car l'adresse e-mail cible n'existe pas. Si vous recevez ce type de retour à l'expéditeur, vous devez supprimer l'adresse e-mail du destinataire de votre liste de diffusion. |
| `Permanent` | `Suppressed` | Amazon SES a supprimé l'envoi à cette adresse, car elle a un historique récent de retour à l'expéditeur sous la forme d'adresse non valide. Pour remplacer la liste de suppression globale, consultez [Utilisation de la liste de suppression au niveau du compte Amazon SES](sending-email-suppression-list.md). |
| Permanent | OnAccountSuppressionList | Amazon SES a supprimé l'envoi à cette adresse car celle-ci figure dans la [liste de suppression au niveau du compte](sending-email-suppression-list.md). Cela n'est pas pris en compte dans votre métrique de taux de retours à l'expéditeur. |
| `Transient` | `General` | Amazon SES a reçu un retour à l'expéditeur général. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir. |
| `Transient` | `MailboxFull` | Amazon SES a reçu un retour à l'expéditeur de boîte aux lettres pleine. Vous pouvez réessayer avec succès l'envoi à ce destinataire à l'avenir. |
| `Transient` | `MessageTooLarge` | Amazon SES a reçu un message de retour à l'expéditeur trop volumineux. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous réduisez la taille du message. |
| `Transient` | `CustomTimeoutExceeded` | Amazon SES n'a pas réussi à envoyer l'e-mail dans le délai spécifié par l'expéditeur de l'e-mail. *(Le message de rebond indiquera la raison de tout échec éventuel de tentative de livraison dans le cadre du TTL défini.)* |
| `Transient` | `ContentRejected` | Amazon SES a reçu un retour à l'expéditeur de contenu rejeté. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous modifiez le contenu du message. |
| `Transient` | `AttachmentRejected` | Amazon SES a reçu un retour à l'expéditeur de pièce jointe rejetée. Vous pouvez réessayer avec succès l'envoi à ce destinataire si vous supprimez ou modifiez la pièce jointe. |
## Objet de réclamation
L'objet JSON qui contient les informations sur un événement `Complaint` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `complainedRecipients` | Liste contenant des informations sur les destinataires qui ont soumis la réclamation. |
| `timestamp` | Date et heure, ISO8601 au format (*YYYY-MM DDThh -:MM:SS.sz*), auxquelles le fournisseur de services Internet a envoyé la notification de plainte. |
| `feedbackId` | ID unique de la réclamation. |
| `complaintSubType` | Sous-type de la réclamation, tel que déterminé par Amazon SES. |
De plus, si un rapport de commentaire est attaché à la réclamation, les champs suivants peuvent être présents.
| Nom de champ | Description |
| --- | --- |
| `userAgent` | Valeur du champ `User-Agent` du rapport de commentaires. Cette valeur indique le nom et la version du système ayant généré le rapport. |
| `complaintFeedbackType` | Valeur du champ `Feedback-Type` du rapport de commentaires reçu de l'ISP. La valeur contient le type de commentaires. |
| `arrivalDate` | La valeur du `Received-Date` champ `Arrival-Date` ou du rapport de commentaires au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh Le champ peut être absent du rapport (et donc également absent du JSON). |
### Destinataires à l'origine d'une réclamation
Le champ `complainedRecipients` contient la liste des destinataires susceptibles d'avoir déposé la réclamation.
**Important**
La plupart ISPs expurgent les adresses e-mail des destinataires qui soumettent des plaintes. Pour cette raison, le champ `complainedRecipients` inclut une liste de toutes les personnes auxquelles l'e-mail dont l'adresse est sur le domaine qui a émis la notification de réclamation a été envoyé.
Les objets JSON de cette liste contiennent le champ suivant.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse e-mail du destinataire. |
### Types de réclamation
Vous pouvez voir les types de réclamation suivants dans le champ `complaintFeedbackType` tels qu'attribués par l'ISP du rapport, selon le [site web IANA (Internet Assigned Numbers)](https://www.iana.org/assignments/marf-parameters/marf-parameters.xml#marf-parameters-2) :
| Nom de champ | Description |
| --- | --- |
| `abuse` | Indique un e-mail indésirable ou un autre type d'e-mail malveillant. |
| `auth-failure` | Rapport d'échec d'authentification d'e-mail. |
| `fraud` | Indique certains types de fraude ou d'activité d'hameçonnage. |
| `not-spam` | Indique que l'entité qui fournit le rapport ne considère pas le message en tant que courrier indésirable. Cette option permet de corriger un message qui a été mal balisé ou classé à tort comme courrier indésirable. |
| `other` | Indique tout autre commentaire ne pouvant être classé dans les autres types enregistrés. |
| `virus` | Signale qu'un virus a été détecté dans le message d'origine. |
### Sous-types de réclamation
La valeur du champ `complaintSubType` peut être null ou `OnAccountSuppressionList`. Si la valeur est `OnAccountSuppressionList`, Amazon SES a accepté le message, mais n'a pas essayé de l'envoyer car elle figurait dans la [liste de suppression au niveau du compte](sending-email-suppression-list.md).
## Objet Delivery
L'objet JSON qui contient les informations sur un événement `Delivery` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `timestamp` | Date et heure auxquelles Amazon SES a envoyé l'e-mail au serveur de messagerie du destinataire, au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `processingTimeMillis` | Délai, en millisecondes, entre le moment où Amazon SES a accepté la demande de l'expéditeur et le moment où Amazon SES a transmis le message au serveur de messagerie du destinataire. |
| `recipients` | Liste des destinataires auxquels l'événement de remise s'applique. |
| `smtpResponse` | Message de réponse SMTP du FAI distant ayant accepté l'e-mail depuis Amazon SES. Ce message varie selon l'e-mail, le serveur de messagerie de réception et l'ISP de réception. |
| `reportingMTA` | Nom d'hôte du serveur de messagerie Amazon SES ayant envoyé l'e-mail. |
| `remoteMtaIp` | Adresse IP de la MTA à laquelle Amazon SES a remis l'e-mail. |
## Objet Send
L'objet JSON qui contient les informations sur un événement `send` est toujours vide.
## Objet Reject
L'objet JSON qui contient les informations sur un événement `Reject` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `reason` | Raison du rejet de l'e-mail. La seule valeur possible est `Bad content`, ce qui signifie qu'Amazon SES a détecté que l'e-mail contenait un virus. Lorsqu'un message est rejeté, Amazon SES arrête de le traiter et ne tente pas de le remettre au serveur de messagerie du destinataire. |
## Objet Open
L'objet JSON qui contient les informations sur un événement `Open` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `ipAddress` | Adresse IP du destinataire. |
| `timestamp` | Date et heure auxquelles l'événement ouvert s'est produit au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `userAgent` | Agent utilisateur de l'appareil ou client de messagerie que le destinataire a utilisé pour ouvrir l'e-mail. |
## Objet Click
L'objet JSON qui contient les informations sur un événement `Click` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `ipAddress` | Adresse IP du destinataire. |
| `timestamp` | Date et heure auxquelles l'événement de clic s'est produit au ISO8601 format (*YYYY-MM* -:MM:SS.sz). DDThh |
| `userAgent` | Agent utilisateur du client que le destinataire a utilisé pour cliquer sur un lien dans l'e-mail. |
| `link` | URL du lien sur lequel le destinataire a cliqué. |
| `linkTags` | Liste des balises ajoutées au lien à l'aide de l'attribut `ses:tags`. Pour en savoir plus sur l'ajout de balises aux liens de vos e-mails, consultez [Q5. Puis-je baliser les liens avec des identificateurs uniques ?](faqs-metrics.md#sending-metric-faqs-clicks-q5) dans le [Statistiques d'envoi d'e-mails Amazon SES FAQs](faqs-metrics.md). |
## Objet Rendering Failure
L'objet JSON qui contient les informations sur un événement `Rendering Failure` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `templateName` | Nom du modèle utilisé pour envoyer l'e-mail. |
| `errorMessage` | Message qui fournit des informations supplémentaires sur l'échec d'affichage. |
## DeliveryDelay objet
L'objet JSON qui contient les informations sur un événement `DeliveryDelay` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `delayType` | Type de retard. Les valeurs possibles sont : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/ses/latest/dg/event-publishing-retrieving-sns-contents.html) |
| `delayedRecipients` | Objet contenant des informations sur le destinataire de l'e-mail. |
| `expirationTime` | Date et heure auxquelles Amazon SES cessera d'essayer de remettre le message. Cette valeur est affichée au format ISO 8601. |
| `reportingMTA` | Adresse IP de l'agent de transfert de messages (MTA) qui a signalé le retard. |
| `timestamp` | La date et l'heure auxquelles le retard s'est produit, illustrées au format ISO 8601. |
### Destinataires retardés
L'objet `delayedRecipients` contient les valeurs suivantes.
| Nom de champ | Description |
| --- | --- |
| `emailAddress` | Adresse électronique ayant entraîné un retard dans la livraison du message. |
| `status` | Code d'état SMTP associé au délai de livraison. |
| `diagnosticCode` | Code de diagnostic fourni par l'agent de transfert de message (MTA) récepteur. |
## Objet Abonnement
L'objet JSON qui contient les informations sur un événement `Subscription` comporte les champs suivants.
| Nom de champ | Description |
| --- | --- |
| `contactList` | Nom de la liste sur laquelle figure le contact. |
| `timestamp` | Date et heure, ISO8601 au format *(YYYY-MM DDThh -:MM:SS.sz*), auxquelles le fournisseur de services Internet a envoyé la notification d'abonnement. |
| `source` | Adresse e-mail à partir de laquelle le message a été envoyé (adresse MAIL FROM de l'enveloppe). |
| `newTopicPreferences` | Structure de données JSON (carte) qui spécifie l'état d'abonnement de toutes les rubriques de la liste de contacts en indiquant le statut après une modification (contact abonné ou désabonné). |
| `oldTopicPreferences` | Structure de données JSON (carte) qui spécifie le statut d'abonnement de toutes les rubriques de la liste de contacts en indiquant l'état avant la modification (contact souscrit ou désabonné). |
### Préférences de la nouvelle ou de l'ancienne rubrique
Les objets `newTopicPreferences` et `oldTopicPreferences` contiennent les valeurs suivantes.
| Nom de champ | Description |
| --- | --- |
| `unsubscribeAll` | Indique si le contact s'est désabonné de toutes les rubriques de la liste de contacts. |
| `topicSubscriptionStatus` | Spécifie le statut d'abonnement du sujet dans le `topicName` champ indiquant s'il est actuellement abonné pour recevoir des notifications de SES pour le type d'événement spécifié. Les valeurs possibles sont **OptIn**(abonné) ou **OptOut**(désabonné) dans le `subscriptionStatus` champ. |
| `topicDefaultSubscriptionStatus` | Spécifie le statut d'abonnement par défaut du sujet dans le `topicName` champ déterminant si les nouveaux sujets ajoutés à la destination de l'événement seront abonnés ou désabonnés par défaut. Les valeurs possibles sont **OptIn**(abonné par défaut) ou **OptOut**(désabonné par défaut) dans le `subscriptionStatus` champ. |
# Exemples de données d'événement publiées par Amazon SES sur Amazon SNS
Cette section fournit des exemples de chaque type de registre d'événement d'envoi d'e-mails publié par Amazon SES dans Amazon SNS.
**Topics**
+ [registre de retour à l'expéditeur](#event-publishing-retrieving-sns-bounce)
+ [registre de réclamation](#event-publishing-retrieving-sns-complaint)
+ [registre de remise](#event-publishing-retrieving-sns-delivery)
+ [registre d'envoi](#event-publishing-retrieving-sns-send)
+ [registre de rejet](#event-publishing-retrieving-sns-reject)
+ [registre d'ouverture](#event-publishing-retrieving-sns-open)
+ [registre de clic](#event-publishing-retrieving-sns-click)
+ [registre d'échec de rendu](#event-publishing-retrieving-sns-failure)
+ [DeliveryDelay record](#event-publishing-retrieving-sns-delayed-delivery)
+ [Enregistrement d'abonnement](#event-publishing-retrieving-sns-subscription)
**Note**
Dans les exemples suivants, où un champ `tag` est utilisé, il utilise la publication d'événements via un jeu de configuration pour lequel SES prend en charge la publication d'étiquettes pour tous les types d'événements. Si vous utilisez des notifications de commentaires directement sur l'identité, SES ne publie pas d'étiquettes. Découvrez comment ajouter des étiquettes lors de la [création d'un jeu de configuration](creating-configuration-sets.md) ou de la [modification d'un jeu de configuration](managing-configuration-sets.md#console-detail-configuration-sets).
## registre de retour à l'expéditeur
L'exemple suivant présente un registre d'événement `Bounce` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType":"Bounce",
3. "bounce":{
4. "bounceType":"Permanent",
5. "bounceSubType":"General",
6. "bouncedRecipients":[
7. {
8. "emailAddress":"recipient@example.com",
9. "action":"failed",
10. "status":"5.1.1",
11. "diagnosticCode":"smtp; 550 5.1.1 user unknown"
12. }
13. ],
14. "timestamp":"2017-08-05T00:41:02.669Z",
15. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
16. "reportingMTA":"dsn; mta.example.com"
17. },
18. "mail":{
19. "timestamp":"2017-08-05T00:40:02.012Z",
20. "source":"Sender Name ",
21. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
22. "sendingAccountId":"123456789012",
23. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
24. "destination":[
25. "recipient@example.com"
26. ],
27. "headersTruncated":false,
28. "headers":[
29. {
30. "name":"From",
31. "value":"Sender Name "
32. },
33. {
34. "name":"To",
35. "value":"recipient@example.com"
36. },
37. {
38. "name":"Subject",
39. "value":"Message sent from Amazon SES"
40. },
41. {
42. "name":"MIME-Version",
43. "value":"1.0"
44. },
45. {
46. "name":"Content-Type",
47. "value":"multipart/alternative; boundary=\"----=_Part_7307378_1629847660.1516840721503\""
48. }
49. ],
50. "commonHeaders":{
51. "from":[
52. "Sender Name "
53. ],
54. "to":[
55. "recipient@example.com"
56. ],
57. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
58. "subject":"Message sent from Amazon SES"
59. },
60. "tags":{
61. "ses:configuration-set":[
62. "ConfigSet"
63. ],
64. "ses:source-ip":[
65. "192.0.2.0"
66. ],
67. "ses:from-domain":[
68. "example.com"
69. ],
70. "ses:caller-identity":[
71. "ses_user"
72. ]
73. }
74. }
75. }
```
## registre de réclamation
L'exemple suivant présente un registre d'événement `Complaint` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType":"Complaint",
3. "complaint": {
4. "complainedRecipients":[
5. {
6. "emailAddress":"recipient@example.com"
7. }
8. ],
9. "timestamp":"2017-08-05T00:41:02.669Z",
10. "feedbackId":"01000157c44f053b-61b59c11-9236-11e6-8f96-7be8aexample-000000",
11. "userAgent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36",
12. "complaintFeedbackType":"abuse",
13. "arrivalDate":"2017-08-05T00:41:02.669Z"
14. },
15. "mail":{
16. "timestamp":"2017-08-05T00:40:01.123Z",
17. "source":"Sender Name ",
18. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
19. "sendingAccountId":"123456789012",
20. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
21. "destination":[
22. "recipient@example.com"
23. ],
24. "headersTruncated":false,
25. "headers":[
26. {
27. "name":"From",
28. "value":"Sender Name "
29. },
30. {
31. "name":"To",
32. "value":"recipient@example.com"
33. },
34. {
35. "name":"Subject",
36. "value":"Message sent from Amazon SES"
37. },
38. {
39. "name":"MIME-Version","value":"1.0"
40. },
41. {
42. "name":"Content-Type",
43. "value":"multipart/alternative; boundary=\"----=_Part_7298998_679725522.1516840859643\""
44. }
45. ],
46. "commonHeaders":{
47. "from":[
48. "Sender Name "
49. ],
50. "to":[
51. "recipient@example.com"
52. ],
53. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
54. "subject":"Message sent from Amazon SES"
55. },
56. "tags":{
57. "ses:configuration-set":[
58. "ConfigSet"
59. ],
60. "ses:source-ip":[
61. "192.0.2.0"
62. ],
63. "ses:from-domain":[
64. "example.com"
65. ],
66. "ses:caller-identity":[
67. "ses_user"
68. ]
69. }
70. }
71. }
```
## registre de remise
L'exemple suivant présente un registre d'événement `Delivery` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType": "Delivery",
3. "mail": {
4. "timestamp": "2016-10-19T23:20:52.240Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "text/html; charset=UTF-8"
33. },
34. {
35. "name": "Content-Transfer-Encoding",
36. "value": "7bit"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "ses:outgoing-ip": [
63. "192.0.2.0"
64. ],
65. "myCustomTag1": [
66. "myCustomTagValue1"
67. ],
68. "myCustomTag2": [
69. "myCustomTagValue2"
70. ]
71. }
72. },
73. "delivery": {
74. "timestamp": "2016-10-19T23:21:04.133Z",
75. "processingTimeMillis": 11893,
76. "recipients": [
77. "recipient@example.com"
78. ],
79. "smtpResponse": "250 2.6.0 Message received",
80. "remoteMtaIp": "123.456.789.012",
81. "reportingMTA": "mta.example.com"
82. }
83. }
```
## registre d'envoi
L'exemple suivant présente un registre d'événement `Send` publié sur Amazon SNS par Amazon SES. Certains champs ne sont pas toujours présents. Par exemple, avec un e-mail modèle, l'objet est rendu ultérieurement et inclus dans les événements suivants.
```
1. {
2. "eventType": "Send",
3. "mail": {
4. "timestamp": "2016-10-14T05:02:16.645Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "recipient@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"----=_Part_0_716996660.1476421336341\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "send": {}
71. }
```
## registre de rejet
L'exemple suivant présente un registre d'événement `Reject` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType": "Reject",
3. "mail": {
4. "timestamp": "2016-10-14T17:38:15.211Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination": [
10. "sender@example.com"
11. ],
12. "headersTruncated": false,
13. "headers": [
14. {
15. "name": "From",
16. "value": "sender@example.com"
17. },
18. {
19. "name": "To",
20. "value": "recipient@example.com"
21. },
22. {
23. "name": "Subject",
24. "value": "Message sent from Amazon SES"
25. },
26. {
27. "name": "MIME-Version",
28. "value": "1.0"
29. },
30. {
31. "name": "Content-Type",
32. "value": "multipart/mixed; boundary=\"qMm9M+Fa2AknHoGS\""
33. },
34. {
35. "name": "X-SES-MESSAGE-TAGS",
36. "value": "myCustomTag1=myCustomTagValue1, myCustomTag2=myCustomTagValue2"
37. }
38. ],
39. "commonHeaders": {
40. "from": [
41. "sender@example.com"
42. ],
43. "to": [
44. "recipient@example.com"
45. ],
46. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
47. "subject": "Message sent from Amazon SES"
48. },
49. "tags": {
50. "ses:configuration-set": [
51. "ConfigSet"
52. ],
53. "ses:source-ip": [
54. "192.0.2.0"
55. ],
56. "ses:from-domain": [
57. "example.com"
58. ],
59. "ses:caller-identity": [
60. "ses_user"
61. ],
62. "myCustomTag1": [
63. "myCustomTagValue1"
64. ],
65. "myCustomTag2": [
66. "myCustomTagValue2"
67. ]
68. }
69. },
70. "reject": {
71. "reason": "Bad content"
72. }
73. }
```
## registre d'ouverture
L'exemple suivant présente un registre d'événement `Open` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType": "Open",
3. "mail": {
4. "commonHeaders": {
5. "from": [
6. "sender@example.com"
7. ],
8. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "subject": "Message sent from Amazon SES",
10. "to": [
11. "recipient@example.com"
12. ]
13. },
14. "destination": [
15. "recipient@example.com"
16. ],
17. "headers": [
18. {
19. "name": "X-SES-CONFIGURATION-SET",
20. "value": "ConfigSet"
21. },
22. {
23. "name":"X-SES-MESSAGE-TAGS",
24. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
25. },
26. {
27. "name": "From",
28. "value": "sender@example.com"
29. },
30. {
31. "name": "To",
32. "value": "recipient@example.com"
33. },
34. {
35. "name": "Subject",
36. "value": "Message sent from Amazon SES"
37. },
38. {
39. "name": "MIME-Version",
40. "value": "1.0"
41. },
42. {
43. "name": "Content-Type",
44. "value": "multipart/alternative; boundary=\"XBoundary\""
45. }
46. ],
47. "headersTruncated": false,
48. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
49. "sendingAccountId": "123456789012",
50. "source": "sender@example.com",
51. "tags": {
52. "myCustomTag1":[
53. "myCustomValue1"
54. ],
55. "myCustomTag2":[
56. "myCustomValue2"
57. ],
58. "ses:caller-identity": [
59. "IAM_user_or_role_name"
60. ],
61. "ses:configuration-set": [
62. "ConfigSet"
63. ],
64. "ses:from-domain": [
65. "example.com"
66. ],
67. "ses:source-ip": [
68. "192.0.2.0"
69. ]
70. },
71. "timestamp": "2017-08-09T21:59:49.927Z"
72. },
73. "open": {
74. "ipAddress": "192.0.2.1",
75. "timestamp": "2017-08-09T22:00:19.652Z",
76. "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60"
77. }
78. }
```
## registre de clic
L'exemple suivant présente un registre d'événement `Click` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType": "Click",
3. "click": {
4. "ipAddress": "192.0.2.1",
5. "link": "http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp.html",
6. "linkTags": {
7. "samplekey0": [
8. "samplevalue0"
9. ],
10. "samplekey1": [
11. "samplevalue1"
12. ]
13. },
14. "timestamp": "2017-08-09T23:51:25.570Z",
15. "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.90 Safari/537.36"
16. },
17. "mail": {
18. "commonHeaders": {
19. "from": [
20. "sender@example.com"
21. ],
22. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
23. "subject": "Message sent from Amazon SES",
24. "to": [
25. "recipient@example.com"
26. ]
27. },
28. "destination": [
29. "recipient@example.com"
30. ],
31. "headers": [
32. {
33. "name": "X-SES-CONFIGURATION-SET",
34. "value": "ConfigSet"
35. },
36. {
37. "name":"X-SES-MESSAGE-TAGS",
38. "value":"myCustomTag1=myCustomValue1, myCustomTag2=myCustomValue2"
39. },
40. {
41. "name": "From",
42. "value": "sender@example.com"
43. },
44. {
45. "name": "To",
46. "value": "recipient@example.com"
47. },
48. {
49. "name": "Subject",
50. "value": "Message sent from Amazon SES"
51. },
52. {
53. "name": "MIME-Version",
54. "value": "1.0"
55. },
56. {
57. "name": "Content-Type",
58. "value": "multipart/alternative; boundary=\"XBoundary\""
59. },
60. {
61. "name": "Message-ID",
62. "value": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000"
63. }
64. ],
65. "headersTruncated": false,
66. "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
67. "sendingAccountId": "123456789012",
68. "source": "sender@example.com",
69. "tags": {
70. "myCustomTag1":[
71. "myCustomValue1"
72. ],
73. "myCustomTag2":[
74. "myCustomValue2"
75. ],
76. "ses:caller-identity": [
77. "ses_user"
78. ],
79. "ses:configuration-set": [
80. "ConfigSet"
81. ],
82. "ses:from-domain": [
83. "example.com"
84. ],
85. "ses:source-ip": [
86. "192.0.2.0"
87. ]
88. },
89. "timestamp": "2017-08-09T23:50:05.795Z"
90. }
91. }
```
## registre d'échec de rendu
L'exemple suivant présente un registre d'événement `Rendering Failure` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType":"Rendering Failure",
3. "mail":{
4. "timestamp":"2018-01-22T18:43:06.197Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "failure":{
20. "errorMessage":"Attribute 'attributeName' is not present in the rendering data.",
21. "templateName":"MyTemplate"
22. }
23. }
```
## DeliveryDelay record
L'exemple suivant présente un registre d'événement `DeliveryDelay` publié sur Amazon SNS par Amazon SES.
```
1. {
2. "eventType": "DeliveryDelay",
3. "mail":{
4. "timestamp":"2020-06-16T00:15:40.641Z",
5. "source":"sender@example.com",
6. "sourceArn":"arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId":"123456789012",
8. "messageId":"EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000",
9. "destination":[
10. "recipient@example.com"
11. ],
12. "headersTruncated":false,
13. "tags":{
14. "ses:configuration-set":[
15. "ConfigSet"
16. ]
17. }
18. },
19. "deliveryDelay": {
20. "timestamp": "2020-06-16T00:25:40.095Z",
21. "delayType": "TransientCommunicationFailure",
22. "expirationTime": "2020-06-16T00:25:40.914Z",
23. "delayedRecipients": [{
24. "emailAddress": "recipient@example.com",
25. "status": "4.4.1",
26. "diagnosticCode": "smtp; 421 4.4.1 Unable to connect to remote host"
27. }]
28. }
29. }
```
## Enregistrement d'abonnement
Voici un exemple d'enregistrement d'`Subscription`événement publié par Amazon SES sur Firehose.
```
1. {
2. "eventType": "Subscription",
3. "mail": {
4. "timestamp": "2022-01-12T01:00:14.340Z",
5. "source": "sender@example.com",
6. "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com",
7. "sendingAccountId": "123456789012",
8. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
9. "destination": ["recipient@example.com"],
10. "headersTruncated": false,
11. "headers": [
12. {
13. "name": "From",
14. "value": "sender@example.com"
15. },
16. {
17. "name": "To",
18. "value": "recipient@example.com"
19. },
20. {
21. "name": "Subject",
22. "value": "Message sent from Amazon SES"
23. },
24. {
25. "name": "MIME-Version",
26. "value": "1.0"
27. },
28. {
29. "name": "Content-Type",
30. "value": "text/html; charset=UTF-8"
31. },
32. {
33. "name": "Content-Transfer-Encoding",
34. "value": "7bit"
35. }
36. ],
37. "commonHeaders": {
38. "from": ["sender@example.com"],
39. "to": ["recipient@example.com"],
40. "messageId": "EXAMPLEe4bccb684-777bc8de-afa7-4970-92b0-f515137b1497-000000",
41. "subject": "Message sent from Amazon SES"
42. },
43. "tags": {
44. "ses:operation": ["SendEmail"],
45. "ses:configuration-set": ["ConfigSet"],
46. "ses:source-ip": ["192.0.2.0"],
47. "ses:from-domain": ["example.com"],
48. "ses:caller-identity": ["ses_user"],
49. "myCustomTag1": ["myCustomValue1"],
50. "myCustomTag2": ["myCustomValue2"]
51. }
52. },
53. "subscription": {
54. "contactList": "ContactListName",
55. "timestamp": "2022-01-12T01:00:17.910Z",
56. "source": "UnsubscribeHeader",
57. "newTopicPreferences": {
58. "unsubscribeAll": true,
59. "topicSubscriptionStatus": [
60. {
61. "topicName": "ExampleTopicName",
62. "subscriptionStatus": "OptOut"
63. }
64. ]
65. },
66. "oldTopicPreferences": {
67. "unsubscribeAll": false,
68. "topicSubscriptionStatus": [
69. {
70. "topicName": "ExampleTopicName",
71. "subscriptionStatus": "OptOut"
72. }
73. ]
74. }
75. }
76. }
```