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.
Surveillez l'envoi d'e-mails à l'aide d'Amazon SES Event Publishing
Pour vous permettre de suivre vos envois d'e-mails à un niveau détaillé, vous pouvez configurer Amazon SES pour qu'il publie 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 enverrez un e-mail, indiquez le nom du jeu de configurations, ainsi qu'une ou plusieurs balises de message sous forme de paires nom/valeur, afin de 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 EmailTags
dans le champ de l'SendEmail
APIopération, soit ajouter la balise de message à l'en-tête X-SES-MESSAGE-TAGS
de message SES spécifique à l'e-mail. Pour en savoir plus sur les jeux de configurations, consultez Utilisation des ensembles de configuration dans Amazon SES.
Outre les balises de message que vous spécifiez, ajoute SES é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 SES de cette méthode.
Nom de balise automatique | Description |
---|---|
ses:caller-identity |
L'IAMidentité de l'SESutilisateur 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 SES utilisée 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 TLS protocole utilisée par l'appelant pour envoyer l'e-mail. |
ses:outgoing-tls-version |
Version du TLS protocole SES utilisée 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. a
or
b
>ses:
Vous pouvez utiliser jusqu'à deux de ces balises définies par ses:feedback-id-a
etses:feedback-id-b
.
Lorsque vous spécifiez ces balises, vous les ajoutez SES 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 feedback (FBL), voirBoucles de rétroaction. L'Feedback-ID
en-tête est composé de l'identifiant SESInternalID, utilisé SES pour collecter les informations relatives aux plaintes, et de la balise statique, Amazon SES, identifiant SES la plate-forme 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 a
or
b
>EmailTags
champ de la demande d'SendEmail
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 SES X-SES-MESSAGE-TAGSspécifique.a
or
b
>
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 Ajout d'une destination d'événement CloudWatch (Des frais supplémentaires s'appliquent, voir Prix par métrique pour CloudWatch.)a
or
b
>
Utilisation de la publication d'événements
Les sections suivantes contiennent les informations dont vous avez besoin pour configurer et utiliser la publication d'SESévénements.
Terminologie de publication d'événements
La liste suivante définit les termes relatifs à la publication d'SESévénements.
- É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 :
-
Envoyer — La demande d'envoi a réussi et Amazon SES tentera de transmettre le message au serveur de messagerie du destinataire. (Si une suppression globale ou au niveau du compte est utilisée, elle SES sera toujours considérée 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 se produit uniquement lorsque vous envoyez un e-mail à l'aide
SendBulkTemplatedEmail
APIdes opérationsSendTemplatedEmail
or.) -
Rejeter : Amazon SES a accepté l'e-mail, mais a déterminé qu'il contenait un virus et n'a pas tenté de le transmettre au serveur de messagerie du destinataire.
-
Livraison : Amazon a SES correctement envoyé 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 lorsqu'SESil 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
.) -
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 lienUnsubscribe
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 les événements d'envoi d'e-mails sont SES publiés, 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 auquel vous publiez des événements d'envoi d'SESe-mails. Chaque destination d'événement que vous configurez appartient à un, et à un seul, jeu de configurations.
- Balise de message
-
Paire nom/valeur utilisée pour classer un e-mail à des fins de publication d'événements. Par exemple, campagne/livre et campagne/vêtements. Lorsque vous envoyez un e-mail, vous spécifiez le tag du message en tant que paramètre de l'APIappel ou en tant qu'en-tête d'e-mail SES spécifique.
- Balise automatique
-
Balises de messages qui sont automatiquement incluses dans les rapports de publication d'événements. Il existe une étiquette automatique pour le nom du jeu de configuration, le domaine de l'adresse « De », l'adresse IP sortante de l'appelant, l'adresse IP SES sortante et l'IAMidentité de l'appelant.