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 votre activité d'envoi Amazon SES
Amazon SES fournit des méthodes pour surveiller votre activité d'envoi à l'aide d'événements, de métriques et de statistiques. Un événement est un élément lié à votre activité d'envoi et dont vous avez décidé d'effectuer un suivi en tant que métrique. Une métrique représente un ensemble chronologique de points de données représentant les valeurs d'un type d'événement surveillé qui produit des statistiques. Les statistiques sont des regroupements de données métriques sur une durée spécifiée, y compris jusqu'à l'instant présent.
Ces méthodes de surveillance vous aident à suivre des métriques importantes, telles que les taux de retours à l'expéditeur, de réclamations et de rejets. Des taux trop élevés de retours à l'expéditeur et de réclamations peuvent compromettre votre capacité à envoyer des e-mails à l'aide de SES. Ces méthodes peuvent aussi être exploitées pour mesurer les taux d'interaction de vos clients avec les e-mails que vous envoyez, vous aidant ainsi à identifier vos taux globaux d'ouverture et de clics en utilisant la publication d'événements et des domaines personnalisés associés à des jeux de configuration (voir [Configuration de domaines personnalisés pour gérer le suivi des ouvertures et des clics](configure-custom-open-click-domains.md)).
La première étape de la configuration de la surveillance consiste à identifier les types d'événements de messagerie liés à votre activité d'envoi que vous voulez mesurer et surveiller avec SES. Vous pouvez les types d'événement suivants à suivre dans SES :
+ **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.
Vous pouvez surveiller les événements d'envoi d'e-mails de différentes manières. La méthode que vous choisissez dépend du type d'événement que vous souhaitez surveiller, de la granularité et du niveau de détail avec lesquels vous souhaitez que SES publie les données. Vous devez utiliser les notifications de commentaires ou la publication d'événements pour suivre les événements de retour à l'expéditeur et de réclamation. Vous pouvez également choisir d'utiliser plusieurs méthodes de surveillance. Les caractéristiques de chaque méthode sont répertoriées dans le tableau suivant.
| Méthode de surveillance | Événements que vous pouvez surveiller | Méthode d'accès aux données | Niveau de détail | Granularité |
| --- | --- | --- | --- | --- |
| Console SES | État du compte, e-mails envoyés, quota utilisé, demandes d'envoi réussies, rejets, rebonds et réclamations *(historique récent jusqu'à la réputation actuelle)* | [Page du tableau de bord du compte](monitor-sending-activity-console.md) dans la console SES | Compte et pourcentage | Sur l'ensemble du AWS compte |
| Console SES | État du compte, e-mails envoyés, rebonds et réclamations *(réputation actuelle)* | [Page de statistiques de réputation](reputation-dashboard-dg.md) dans la console SES | Taux calculés uniquement | Sur l'ensemble du AWS compte |
| Virtual Deliverability Manager | Statistiques des comptes, fournisseur d'accès Internet, identités d'envoi, ensembles de configuration, envoi, livraison, plaintes, rebonds transitoires et permanents, ouvertures et clics, délivrabilité et réputation. | [Tableau de bord Virtual Deliverability Manager](vdm-dashboard.md)dans la console SES [Conseiller Virtual Deliverability Manager](vdm-advisor.md)dans la console SES | Compte et pourcentage | Sur l'ensemble du AWS compte |
| UTILISER L'API | Messages délivrés, retours à l'expéditeur, réclamations et rejets | [https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_GetSendStatistics.html)Opération d'API | Nombre uniquement | Sur l'ensemble du AWS compte |
| CloudWatch Console Amazon | Envois, livraisons, ouvertures, clics, rebonds, taux de rebond, plaintes, taux de plaintes, taux de réclamations, rejets, échecs de rendu et liste noire. IPs | CloudWatch console Certaines mesures n'apparaissent pas CloudWatch tant que l'événement associé ne se produit pas. [Par exemple, les métriques de rebond n'apparaissent que dans au moins un e-mail contenant des rebonds, ou CloudWatch tant que vous n'avez pas généré un événement de rebond simulé à l'aide du simulateur de boîte aux lettres.](send-an-email-from-console.md) | Nombre uniquement | Sur l'ensemble du AWS compte |
| Notifications de commentaire | Messages délivrés, retours à l'expéditeur et réclamations | Notification Amazon SNS (messages délivrés, retours à l'expéditeur et réclamations) ou e-mail (retours à l'expéditeur et réclamations uniquement). Consultez [Configuration des notifications d'événement par e-mail](monitor-sending-activity-using-notifications.md). | Détails sur chaque événement | Sur l'ensemble du AWS compte |
| Publication d'événement | Envois, messages délivrés, ouvertures, clics, retours à l'expéditeur, réclamations, rejets et échecs de rendu. | Amazon CloudWatch ou Amazon Data Firehose, ou par notification Amazon SNS, voir. [Surveillance de l'envoi d'e-mails à l'aide de la publication d'événements](monitor-using-event-publishing.md) *(Des frais supplémentaires s'appliquent, voir [Prix par métrique pour CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Détails sur chaque événement | Précise (en fonction des caractéristiques de messagerie définies par l'utilisateur) |
| Publication d'événements en utilisant des domaines personnalisés associés à des jeux de configuration – [Plus d'informations](configure-custom-open-click-domains.md) | Suivi des ouvertures et des clics. | Amazon CloudWatch ou Amazon Data Firehose, ou par notification Amazon SNS. *(Des frais supplémentaires s'appliquent, voir [Prix par métrique pour CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)* | Détails sur chaque événement. | Précise (en fonction des caractéristiques de messagerie définies par l'utilisateur) |
**Note**
Il est possible que les métriques mesurées par les événements d'envoi d'e-mails ne respectent pas parfaitement vos quotas d'envoi. Cet écart peut être dû à des rebonds et à des rejets d'e-mails, ou à l'utilisation du simulateur de boîte de réception SES. Pour connaître la marge de manœuvre que vous avez par rapport à vos quotas d'envoi, consultez [Surveillance de vos quotas d'envoi](manage-sending-quotas-monitor.md).
**Topics**
+ [Surveillance de vos statistiques d'envoi à l'aide de la console Amazon SES](monitor-sending-activity-console.md)
+ [Surveillance de vos statistiques d'utilisation à l'aide de l'API Amazon SES](monitor-sending-activity-api.md)
+ [Surveillance de l'envoi d'e-mails à l'aide de la publication d'événements Amazon SES](monitor-using-event-publishing.md)
# Surveillance de vos statistiques d'envoi à l'aide de la console Amazon SES
À partir des pages **Tableau de bord du compte**, **Métriques de réputation** et **Paramètres SMTP** de la console Amazon SES, vous pouvez surveiller tous les envois d'e-mails, l'utilisation, les statistiques, les paramètres SMTP, l'état général de votre compte et les métriques de réputation. Les sections suivantes décrivent les métriques et les statistiques fournies sur chacune de ces pages de la console.
Il convient de noter que si les deux pages [Tableau de bord du compte](#account-dashboard) et [Métriques de réputation](#reputation-metrics) de la console contiennent des métriques de retours à l'expéditeur et de réclamations, il existe une différence subtile entre ces deux ensembles de taux de retours à l'expéditeur et de réclamations, comme expliqué ci-dessous :
+ **Page Account dashboard (Tableau de bord du compte)** — selon la plage de dates sélectionnée, vous pouvez voir quels étaient les taux de rebonds et de réclamations par le passé, ce qui indique la progression du changement des métriques jusqu'au moment présent.
+ **Page des indicateurs de réputation** : taux de rebond et de plaintes basés sur les dernières données obtenues lors du calcul de votre moyenne historique globale à un niveau élevé (il ne faut pas le confondre avec votre bounce/complaint taux normal, qui correspond à des bounce/complaint événements précis tels qu'ils se produisent en temps réel, comme indiqué sur la page du tableau de **bord du compte**).
Comme exemple simple pour comparer les taux de retours à l'expéditeur ou de réclamations entre la page **Reputation metrics (Métriques de réputation)** et la page **Account dashboard (Tableau de bord du compte)**, supposons que le taux était de 2 % hier et qu’il est désormais de 1 %. Sur la page **Account dashboard (Tableau de bord du compte)**, les graphiques vont tracer la progression graphique montrant un taux de 2 % pour hier et de 1 % pour aujourd'hui.
## Tableau de bord du compte
Vous pouvez surveiller le nombre d'e-mails envoyés depuis votre compte, mais aussi le pourcentage de votre quota d'envoi qui a été utilisé, directement depuis la page **Account dashboard (Tableau de bord du compte)** de la console SES, dans le volet *Daily email usage (Utilisation quotidienne des e-mails)*. Les taux de remise et de rejet correspondant à votre compte peuvent être contrôlés dans le volet *Sending Statistics (Statistiques d'envoi)*, ainsi que d'autres facteurs clés liés à l'envoi de vos e-mails dans les volets suivants :
+ **Limites d'envoi** – Contient les quotas suivants applicables à l'envoi de courrier via SES :
+ *Daily sending quota (Quota d'envoi quotidien)* : nombre maximal d'e-mails que vous pouvez envoyer sur une période de 24 heures.
+ *Maximum send rate (Taux d'envoi maximum)* : nombre maximal d'e-mails par seconde pouvant être envoyés à partir de votre compte.
+ **État du compte** – Statut de votre compte SES :
+ `Healthy` – Aucun problème lié à la réputation n'affecte actuellement votre compte.
+ `Under review` – Des problèmes potentiels ont été identifiés avec votre compte SES - votre compte est en cours de révision pendant que vous travaillez à corriger les problèmes.
+ `Paused` – La capacité de votre compte à envoyer des e-mails est actuellement suspendue en raison d'un problème avec l'e-mail envoyé depuis votre compte. Lorsque le problème a été corrigé, vous pouvez demander que la capacité de votre compte à envoyer des e-mails soit reprise.
+ **Utilisation quotidienne des e-mails** – Pour vérifier votre utilisation quotidienne afin de vous assurer que vous n'approchez pas de vos limites d'envoi :
+ *Emails sent (E-mails envoyés)* : nombre total d'e-mails envoyés sur une période de 24 heures.
+ *Remaining sends (Envois restants)* : nombre total d'e-mails restants disponibles sur une période de 24 heures.
+ *Sending quota used (Quota d'envoi utilisé)* : pourcentage de votre quota d'envoi quotidien utilisé.
+ **Sending Statistics (Statistiques d'envoi)** – Xomprend des graphiques qui illustrent montrent la progression de quatre métriques clés dans un ensemble chronologique de points de données représentant les valeurs d'un type d'événement surveillé produisant des statistiques pour la plage de dates sélectionnée en utilisant une période d'agrégation d'*1 heure*. Vous pouvez sélectionner une plage de données avec des valeurs de départ de `Last 1 day` à `Last 14 days` pour filtrer les graphiques ci-dessous :
+ *Sends (Envois)* : somme des demandes d'envoi d'e-mails réussies.
+ *Rejects (Rejets)* : taux moyen de demandes d'envoi rejetées par SES basé sur `Rejects/Sends * 100` pour la plage de dates sélectionnée.
+ *Bounces (Retours à l'expéditeur)* : taux moyen dérivé de vos statistiques historiques de réputation globale d'expéditeur montrant la progression de la plage de dates sélectionnée.
+ *Complaints (Plaintes)* : taux moyen dérivé de vos statistiques historiques de réputation globale d'expéditeur montrant la progression de la plage de dates sélectionnée.
Chacun de ces graphiques contient un CloudWatch bouton **Afficher dans** qui ouvre la métrique correspondante dans la CloudWatch console Amazon, ce qui permet de consulter des données détaillées, d'effectuer des calculs métriques personnalisés et [de créer des alarmes CloudWatch](reputationdashboard-cloudwatch-alarm.md).
## Métriques de réputation
Outre les taux de retours à l'expéditeur et de réclamations tels que discutés, la page **Reputation metrics (Métriques de réputation)** offre également une visibilité de haut niveau sur les facteurs clés affectant votre réputation.
+ **Summary (Récapitulatif)** – Fournit une vue d'ensemble de l'état de votre réputation.
+ *Status (Statut)* : état global de la réputation basé sur les taux de retours à l'expéditeur et de plaintes historiques :
+ `Healthy` – Les deux métriques se trouvent à des niveaux normaux.
+ `Under review` – L'une ou les deux métriques ont automatiquement entraîné le placement sous vérification de votre compte.
+ `At risk` – L'une des métriques ou les deux ont atteint des niveaux inquiétants et la capacité de votre compte à envoyer des e-mails peut être menacée.
+ *E-mails envoyés (dernières 24 heures)* : nombre total d'e-mails envoyés sur les dernières 24 heures.
+ *Envois restants* : nombre total d'e-mails restants disponibles à envoyer sur une période de 24 heures.
+ *Quota d'envoi utilisé* : pourcentage de votre quota d'envoi quotidien utilisé.
+ **Contenu de l'onglet au niveau du compte :**
+ Bounce rate (Taux de retours à l’expéditeur)
+ *Status (Statut)* : indique l'état de santé de votre taux de retours à l'expéditeur en utilisant les mêmes valeurs que celles décrites dans le volet de récapitulatif.
+ *Historic bounce rate (Taux de retours à l'expéditeur historique)* : pourcentage d'e-mails provenant de votre compte qui ont entraîné un retour à l'expéditeur fort calculé à partir de votre moyenne historique globale en fonction d'un volume représentatif qui représente vos pratiques d'envoi habituelles.
+ Complaint rate (Taux de réclamations)
+ *Status (Statut)* : indique l'état de santé de votre taux de réclamation en utilisant les mêmes valeurs que celles décrites dans le volet Résumé.
+ *Historic bounce rate (Taux de retours à l'expéditeur historiques)* : pourcentage d'e-mails envoyés depuis votre compte et signalés en tant que courrier indésirable par les destinataires et signalés en tant que courrier indésirable par les destinataires.
+ **Contenu de l'onglet Configuration set (Jeu de configurations) :**
+ Réputation par jeu de configurations
+ *Configuration set (Jeu de configurations)* : permet de taper ou de sélectionner un jeu de configurations dont les métriques de réputation sont activées afin que vous puissiez voir les données de synthèse, de retour à l'expéditeur et de réclamation basées sur les e-mails envoyés à l'aide du jeu de configurations sélectionné. Les volets qui apparaissent après la sélection d'un jeu de configurations sont les mêmes que ceux décrits ci-dessus pour la page des métriques de réputation, sauf s'ils sont basés uniquement sur les e-mails envoyés avec le jeu de configurations sélectionné par rapport aux métriques d'envoi globales au niveau de votre compte.
## Paramètres SMTP
Cette page répertorie les paramètres SMTP requis pour utiliser l'interface SMTP Amazon SES via l'API SES ou par programmation, et fournit des liens pour créer et gérer vos informations d'identification SMTP :
+ **Paramètres SMTP** – Si vous souhaitez utiliser un langage de programmation, un serveur de messagerie ou une application compatible avec SMTP pour vous connecter à l'interface SMTP Amazon SES, les informations suivantes sont fournies :
+ Point de terminaison d'un SMTP
+ Port STARTTLS
+ Protocole TLS (Transport Layer Security)
+ Port TLS Wrapper
+ Liens d'authentification fournis pour la création et la gestion des informations d'identification SMTP et IAM
## Utilisation de la console pour la surveillance des métriques d'envoi et de réputation
Les procédures suivantes vous permettront de commencer à explorer vos mesures d'envoi et de réputation, soit à l'aide de la page **Account dashboard (Tableau de bord du compte)** pour les métriques basées sur l'historique récent (jusqu'à 14 jours), soit en utilisant la page **Reputation metrics (Métriques de réputation)** basées sur votre historique global jusqu'à présent.
**Pour afficher les e-mails envoyés et les quotas d'envoi utilisés**
1. Connectez-vous à la console Amazon SES AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).
1. Dans le panneau de navigation, choisissez **Account dashboard (Tableau de bord du compte)**. Vos statistiques d'utilisation figurent dans la section **Daily email usage (Utilisation quotidienne des e-mails)**.
**Pour afficher le nombre d'envois, les taux de rejets, de rebonds et de réclamations**
1. Dans le panneau de navigation, choisissez **Account dashboard (Tableau de bord du compte)**.
1. Dans **Sending Statistics (Statistiques d'envoi)**, utilisez la liste déroulante **Date range (Plage de dates)** pour sélectionner la valeur de départ d'une plage de dates afin de filtrer les quatre graphiques situés directement en dessous de la section **Sending Statistics (Statistiques d'envoi)**.
1. Selon la plage de dates sélectionnée, vous pouvez voir quels étaient les nombres et les taux par le passé, ce qui indique la progression du changement des métriques jusqu'au moment présent.
1. Dans tous les graphiques, cliquez **sur le CloudWatch bouton Afficher dans** pour ouvrir la métrique correspondante dans la CloudWatch console **Amazon** où vous pouvez consulter des données détaillées, effectuer des calculs métriques personnalisés et [créer des alarmes de surveillance CloudWatch](reputationdashboard-cloudwatch-alarm.md).
**Pour voir les taux historiques globaux de retours à l'expéditeur et de réclamations**
1. Dans le panneau de navigation de gauche, choisissez **Reputation metrics (Métriques de réputation)**.
1. Dans **Bounce rate (Taux de retours à l'expéditeur)**, vous pouvez consulter le pourcentage d'e-mails envoyés depuis votre compte ayant entraîné un message d'erreur, et dans le **Complaint rate (Taux de réclamations)**, vous pouvez consulter le pourcentage d'e-mails envoyés depuis votre compte et signalés en tant que courrier indésirable par les destinataires. Les deux métriques sont calculées à partir d'un volume représentatif d'e-mails basés sur vos pratiques d'envoi habituelles.
1. Dans l'un ou l'autre des volets, cliquez **sur le CloudWatch bouton Afficher dans** pour ouvrir la métrique correspondante dans la CloudWatch console **Amazon** où vous pouvez consulter des données détaillées, effectuer des calculs métriques personnalisés et [créer des alarmes de surveillance](reputationdashboard-cloudwatch-alarm.md). CloudWatch
**Pour afficher les métriques de réputation par jeux de configurations**
1. Dans le panneau de navigation de gauche, choisissez **Reputation metrics (Métriques de réputation)**.
1. Sur la page des métriques de réputation, sélectionnez l'option **Configuration set (Jeu de configurations)**.
1. Dans **Reputation by configuration set (Réputation par jeu de configurations)**, cliquez dans le champ **Configuration set (Jeu de configurations)** et commencez à taper ou sélectionnez un jeu de configurations dont les métriques de réputation sont activées.
1. Une fois que vous avez sélectionné le jeu de configurations, les volets du récapitulatif, des retours à l'expéditeur et des réclamations sont chargés avec des métriques basées uniquement sur les e-mails envoyés avec le jeu de configurations sélectionné.
# Surveillance de vos statistiques d'utilisation à l'aide de l'API Amazon SES
L'API Amazon SES fournit l'opération `GetSendStatistics`, qui renvoie des informations sur votre utilisation des services. Nous vous recommandons de vérifier vos statistiques d'envoi régulièrement, afin de pouvoir procéder à des ajustements si nécessaire.
Lorsque vous appelez l'opération `GetSendStatistics`, vous recevez une liste des points de données représentant les deux dernières semaines de votre activité d'envoi. Chaque point de données de cette liste représente 15 minutes d'activité et contient les informations suivantes pour cette période :
+ Le nombre de messages d'erreur définitifs
+ Le nombre de réclamations
+ Le nombre de tentatives de remise (correspond au nombre d'e-mails envoyés)
+ Le nombre de tentatives d'envoi rejetées
+ Un horodatage pour la période d'analyse
Pour une description complète de l'opération `GetSendStatistics`, consultez le document [Amazon Simple Email Service API Reference](https://docs.aws.amazon.com/ses/latest/APIReference/GetSendStatistics.html).
Dans cette section, vous allez retrouver les rubriques suivantes :
+ [Appel de l'opération `GetSendStatistics` d'API à l'aide du AWS CLI](#monitor-sending-activity-api-cli)
+ [Appel de l'opération `GetSendStatistics` par programmation](#monitor-sending-activity-api-sdk)
## Appel de l'opération `GetSendStatistics` d'API à l'aide du AWS CLI
La manière la plus simple d'appeler l'opération d'API `GetSendStatistics` consiste à utiliser l'[AWS Command Line Interface](https://aws.amazon.com/cli) (AWS CLI).
**Pour appeler l'opération `GetSendStatistics` d'API à l'aide du AWS CLI**
1. Si vous ne l'avez pas déjà fait, installez l AWS CLI.' Pour plus d'informations, reportez-vous à la section « [Installation du AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) » dans le *guide de AWS Command Line Interface l'utilisateur*.
1. Si ce n'est pas déjà fait, configurez le AWS CLI pour utiliser vos AWS informations d'identification. Pour plus d'informations, reportez-vous à [la section « Configuration du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) » dans le *guide de AWS Command Line Interface l'utilisateur*.
1. Dans la ligne de commande, exécutez la commande suivante :
```
aws ses get-send-statistics
```
Si le AWS CLI est correctement configuré, vous pouvez voir une liste des statistiques d'envoi au format JSON. Chaque objet JSON inclut des statistiques d'envoi agrégées pour une période de 15 minutes.
## Appel de l'opération `GetSendStatistics` par programmation
Vous pouvez également appeler l'`GetSendStatistics`opération à l'aide du AWS SDKs. Cette section inclut des exemples de code AWS SDKs pour Go, PHP, Python et Ruby. Choisissez un des liens suivants pour afficher des exemples de code pour ce langage :
+ [Exemple de code pour le kit AWS SDK pour Go](#code-example-getsendstatistics-golang)
+ [Exemple de code pour le kit AWS SDK pour PHP](#code-example-getsendstatistics-php)
+ [Exemple de code pour le kit AWS SDK pour Python (Boto)](#code-example-getsendstatistics-python)
+ [Exemple de code pour le kit AWS SDK pour Ruby](#code-example-getsendstatistics-ruby)
**Note**
Ces exemples de code supposent que vous avez créé un fichier d'informations d'identification AWS partagé contenant votre identifiant de clé d' AWS accès, votre clé d'accès AWS secrète et votre AWS région préférée. Pour de plus amples informations, veuillez consulter [Informations d'identification et fichiers de configuration partagés](https://docs.aws.amazon.com/credref/latest/refdocs/creds-config-files.html).
### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Go
```
1. package main
2.
3. import (
4. "fmt"
5.
6. //go get github.com/aws/aws-sdk-go/...
7. "github.com/aws/aws-sdk-go/aws"
8. "github.com/aws/aws-sdk-go/aws/session"
9. "github.com/aws/aws-sdk-go/service/ses"
10. "github.com/aws/aws-sdk-go/aws/awserr"
11. )
12.
13. const (
14. // Replace us-west-2 with the AWS Region you're using for Amazon SES.
15. AwsRegion = "us-west-2"
16. )
17.
18. func main() {
19.
20. // Create a new session and specify an AWS Region.
21. sess, err := session.NewSession(&aws.Config{
22. Region:aws.String(AwsRegion)},
23. )
24.
25. // Create an SES client in the session.
26. svc := ses.New(sess)
27. input := &ses.GetSendStatisticsInput{}
28.
29. result, err := svc.GetSendStatistics(input)
30.
31. // Display error messages if they occur.
32. if err != nil {
33. if aerr, ok := err.(awserr.Error); ok {
34. switch aerr.Code() {
35. default:
36. fmt.Println(aerr.Error())
37. }
38. } else {
39. // Print the error, cast err to awserr.Error to get the Code and
40. // Message from an error.
41. fmt.Println(err.Error())
42. }
43. return
44. }
45.
46. fmt.Println(result)
47. }
```
### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour PHP
```
1. 'latest',
16. 'region' => REGION
17. ));
18.
19. try {
20. $result = $client->getSendStatistics([]);
21. echo($result);
22. } catch (Exception $e) {
23. echo($e->getMessage()."\n");
24. }
25.
26. ?>
```
### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Python (Boto)
```
1. import boto3 #pip install boto3
2. import json
3. from botocore.exceptions import ClientError
4.
5. client = boto3.client('ses')
6.
7. try:
8. response = client.get_send_statistics(
9. )
10. except ClientError as e:
11. print(e.response['Error']['Message'])
12. else:
13. print(json.dumps(response, indent=4, sort_keys=True, default=str))
```
### Téléphoner `GetSendStatistics` à l'aide du AWS SDK pour Ruby
```
1. require 'aws-sdk' # gem install aws-sdk
2. require 'json'
3.
4. # Replace us-west-2 with the AWS Region you're using for Amazon SES.
5. awsregion = "us-west-2"
6.
7. # Create a new SES resource and specify a region
8. ses = Aws::SES::Client.new(region: awsregion)
9.
10. begin
11.
12. resp = ses.get_send_statistics({
13. })
14. puts JSON.pretty_generate(resp.to_h)
15.
16. # If something goes wrong, display an error message.
17. rescue Aws::SES::Errors::ServiceError => error
18. puts error
19.
20. end
```
# 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. }
```