View a markdown version of this page

Utilisation de listes de suppression au niveau des locataires dans Amazon SES - Amazon Simple Email Service
Comment fonctionne la suppression au niveau des locatairesPriorité de suppressionEnregistrement de suppression automatiqueIdentifier les rebonds liés à la suppression des locatairesGestion des entréesConsidérations et restrictionsRessources connexes

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.

Utilisation de listes de suppression au niveau des locataires dans Amazon SES

Si vous utilisez la solution mutualisée Amazon Simple Email Service (SES) pour envoyer des e-mails au nom de plusieurs locataires, vous pouvez attribuer à chaque locataire sa propre liste de suppression. Tenant-level la suppression isole les rebonds et les plaintes afin qu'ils n'affectent que le locataire qui a envoyé l'e-mail. Sans cette fonctionnalité, tous les locataires partagent la liste de suppression au niveau du compte. Lorsqu'un destinataire renvoie ou se plaint de l'adresse e-mail d'un locataire, cette adresse est supprimée pour tous les locataires du compte. Tenant-level la suppression empêche cette contamination entre locataires en maintenant une liste distincte d'adresses supprimées pour chaque locataire.

Comment fonctionne la suppression au niveau des locataires

Deux paramètres contrôlent le comportement de suppression pour chaque locataire : l'étendue de la suppression et les raisons de la suppression. Vous configurez les deux paramètres ensemble en utilisant l'opération d'PutTenantSuppressionAttributesAPI ou en spécifiant à SuppressionAttributes quel moment vous créez un locataire avec l'opération CreateTenant d'API.

L'étendue de suppression détermine la liste de suppression utilisée par SES pour le locataire :

  • TENANT— Utilisez la propre liste de suppression du locataire.

  • ACCOUNT— Utilisez la liste de suppression au niveau du compte. Il s'agit de la valeur par défaut pour les locataires existants et nouveaux.

Les raisons supprimées déterminent les événements qui poussent SES à ajouter des adresses à la liste de suppression :

  • BOUNCE— Ajoutez des adresses qui produisent des rebonds brusques.

  • COMPLAINT— Ajoutez les adresses qui génèrent des plaintes.

  • BOUNCEet COMPLAINT — Ajoutez les adresses qui produisent l'un ou l'autre événement.

  • Vide : ne cochez ni n'inscrivez dans aucune liste de suppression.

Note

Vous devez fournir SuppressionScope et SuppressedReasons ensemble, ou définir les deux sur null. Le fait de définir les deux sur null efface les paramètres de suppression du locataire et rétablit le comportement d'ACCOUNTétendue par défaut du locataire.

Comportement de suppression par configuration

Le tableau suivant décrit l'heure d'envoi et le comportement d'enregistrement pour chaque combinaison d'étendue de suppression et de raisons de suppression.

Scope Motifs Send-time comportement Comportement d'enregistrement
TENANT BOUNCE, COMPLAINT Vérifie la liste des locataires pour détecter les rebonds et les plaintes Enregistre les deux dans la liste des locataires
TENANT BOUNCE Vérifie la liste des locataires pour les rebonds uniquement Les enregistrements sont renvoyés à la liste des locataires uniquement
TENANT COMPLAINT Vérifie la liste des locataires pour les plaintes uniquement Enregistre les plaintes adressées uniquement à la liste des locataires
TENANT Vide Aucun contrôle de suppression Pas d'enregistrement
ACCOUNT BOUNCE, COMPLAINT Vérifie la liste des comptes pour détecter les rebonds et les plaintes Enregistre les deux dans la liste des comptes
ACCOUNT BOUNCE Vérifie la liste des comptes pour les rebonds uniquement Les enregistrements sont renvoyés à la liste des comptes uniquement
ACCOUNT COMPLAINT Vérifie la liste des comptes pour les plaintes uniquement Enregistre les plaintes uniquement dans la liste des comptes
ACCOUNT Vide Aucun contrôle de suppression Pas d'enregistrement

Priorité de suppression et comportement au moment de l'envoi

SES résout les paramètres de suppression dans l'ordre de priorité suivant, du plus élevé au plus bas :

  1. Ensemble de configuration : si le jeu de configuration spécifie des paramètres de suppression, SES utilise ces paramètres.

  2. Tenant — S'il n'existe aucune dérogation aux ensembles de configuration, SES utilise les paramètres de suppression du locataire.

  3. Compte — Si ni le jeu de configuration ni le locataire ne spécifient de paramètres, SES utilise les valeurs par défaut au niveau du compte.

Important

L'étendue de suppression détermine la liste de suppression que SES vérifie au moment de l'envoi. Lorsque le périmètre est définiTENANT, SES vérifie uniquement la liste de suppression du locataire et ignore la liste de suppression au niveau du compte. Une adresse figurant sur la liste de suppression au niveau du compte mais pas sur la liste de suppression du locataire n'est pas supprimée. Lorsque le champ d'application est ACCOUNT défini, SES vérifie uniquement la liste de suppression au niveau du compte. Le scope contrôle également l'endroit où les rebonds et les plaintes sont enregistrés.

Dérogations des ensembles de configuration

Le set SuppressionOptions for a configuration inclut désormais un SuppressionScope champ. Vous pouvez utiliser un ensemble de configuration pour modifier le champ d'application uniquement, les raisons uniquement, ou les deux indépendamment. Cela vous permet de contrôler avec précision le comportement de suppression pour des flux de travail d'envoi spécifiques. Il n'est pas nécessaire de modifier les paramètres par défaut du locataire.

Enregistrement de suppression automatique

Lorsque le périmètre de suppression est définiTENANT, SES enregistre automatiquement les entrées de suppression comme suit :

  • Hard bounces — SES ajoute l'adresse à la liste de suppression du locataire et à la liste de suppression globale. SES n'ajoute pas l'adresse à la liste de suppression au niveau du compte.

  • Réclamations — SES ajoute l'adresse uniquement à la liste de suppression du locataire.

  • Not-spam feedback — Lorsqu'un destinataire marque un message précédemment signalé comme n'étant pas du spam, SES supprime automatiquement les entrées COMPLAINT -reason de la liste de suppression du locataire.

Identifier les rebonds liés à la suppression des locataires

Lorsque SES supprime un message parce que l'adresse figure sur la liste de suppression d'un locataire, vous pouvez identifier l'événement à l'aide des indicateurs suivants :

  • Notification de rebond — Le type de rebond comporte un Permanent sous-type de. OnTenantSuppressionList

  • Virtual Deliverability Manager (VDM) — La raison du rebond est que. ON_TENANT_SUPPRESSION_LIST

  • Code diagnostique — "Amazon SES did not send the message to this address because it is on the suppression list for your tenant."

  • Tag d'événement : SES ajoute un ses:tenant-name tag aux notifications de rebond et de réclamation afin que vous puissiez identifier à quel locataire appartient l'événement.

Gestion des entrées de la liste de suppression des locataires

Vous gérez les entrées de la liste de suppression des locataires en utilisant les mêmes opérations d'API que celles que vous utilisez pour les entrées au niveau du compte. Pour cibler la liste de suppression d'un locataire, incluez le TenantName paramètre dans votre demande :

  • PutSuppressedDestination— Ajoutez une adresse à la liste de suppression d'un locataire.

  • GetSuppressedDestination— Récupère les détails d'une adresse supprimée pour un locataire.

  • DeleteSuppressedDestination— Supprime une adresse de la liste de suppression d'un locataire.

  • ListSuppressedDestinations— Répertorie toutes les adresses supprimées pour un locataire.

Si vous omettez le TenantName paramètre, ces opérations ciblent la liste de suppression au niveau du compte. Cela permet de maintenir la rétrocompatibilité avec les intégrations existantes.

Considérations et restrictions

Gardez les points suivants à l'esprit lorsque vous utilisez des listes de suppression au niveau des locataires :

  • Multi-tenancy obligatoire — La mutualisation de SES doit être configurée avec au moins un locataire pour utiliser cette fonctionnalité.

  • Une liste par locataire — Chaque locataire possède exactement une liste de suppression. Il existe un mappage 1:1 entre les locataires et les listes de suppression.

  • Region-specific— Les listes de suppression de locataires sont spécifiques à Région AWS celles dans lesquelles vous les configurez.

  • Les adresses persistent : les adresses supprimées restent sur la liste du locataire jusqu'à ce que vous les supprimiez explicitement ou jusqu'à ce que SES les supprime automatiquement (par exemple, lorsqu'un destinataire signale un événement de non-spam pour une entrée « COMPLAINT -reason »).

  • Case-sensitive stockage — Les adresses e-mail figurant sur la liste de suppression sont stockées en majuscules et minuscules. Les appels d'API pour la gestion des listes de suppression nécessitent une correspondance entre les cas exacts.

  • Impact du quota d'envoi : les messages supprimés par une liste de suppression de locataires sont pris en compte dans votre quota d'envoi quotidien.

  • Données relatives aux plaintes Gmail : Gmail n'envoie pas de données relatives aux plaintes à SES. Les adresses hébergées par Gmail ne sont pas automatiquement ajoutées à la liste de suppression des plaintes.

  • Restrictions relatives au bac à sable : vous ne pouvez pas appeler PutSuppressedDestination tant que votre compte ne dispose pas d'un accès à la production.

  • Effacement des paramètres : pour effacer les paramètres de suppression d'un locataire, appelez PutTenantSuppressionAttributes avec des valeurs nulles pour des raisons d'étendue et pour des raisons.

  • Supprimer un locataire : lorsque vous supprimez un locataire, SES supprime également toutes les entrées de la liste de suppression pour ce locataire.

Les ressources suivantes peuvent vous aider à en savoir plus sur les listes de suppression dans SES.