Configurer une liste autorisée allow-list
La liste autorisée est une liste d’envoi sécurisé que vous pouvez définir au niveau du sandbox. Il limite l’envoi d’e-mails à des adresses ou domaines spécifiques, en veillant à ce que seuls les destinataires explicitement répertoriés puissent recevoir des messages d’un sandbox donné.
Sur les sandbox hors production, où des envois accidentels peuvent se produire, la liste autorisée empêche les messages indésirables d’atteindre des adresses réelles des clients, fournissant ainsi un environnement sécurisé à des fins de test.
Lorsque la liste autorisée est active mais vide, aucun e-mail n’est envoyé. Cela en fait un frein d’urgence utile : si un problème critique se produit, vous pouvez activer une liste autorisée vide pour arrêter toutes les communications sortantes depuis Journey Optimizer jusqu’à ce que le problème soit résolu. En savoir plus sur la logique de liste autorisée.
Vous pouvez également utiliser l’API Journey Optimizer API REST de suppression pour gérer les messages sortants par programmation via la suppression et les listes autorisées. Découvrez comment utiliser l’API REST de suppression.
Accéder à la liste autorisée access-allowed-list
Pour accéder à la liste détaillée des adresses e-mail et domaines autorisés, accédez à Administration > Canaux > Paramètres des e-mails, puis sélectionnez Liste autorisée.
Page de Liste autorisée
Pour exporter la liste autorisée au format CSV, cliquez sur le bouton Télécharger CSV.
Utilisez le bouton Supprimer pour supprimer définitivement une entrée.
Vous pouvez effectuer des recherches sur les adresses e-mail ou domaines, puis filtrer selon le Type d’adresse. Une fois sélectionné, vous pouvez effacer le filtre affiché en haut de la liste.
Activer la liste autorisée enable-allow-list
Pour activer la liste autorisée, procédez comme suit.
-
Accédez au menu Canaux > Configuration des e-mails > Liste autorisée.
-
Sélectionnez le bouton bascule.
-
Sélectionnez Activer la liste autorisée. La liste autorisée est maintenant active.
note note NOTE - Après l’activation, un délai de 10 minutes est nécessaire avant que la liste autorisée ne prenne effet dans les parcours et les campagnes. Les mises à jour de la liste de liste autorisée et de suppression peuvent également prendre jusqu’à 10 minutes.
- Lorsqu’elle est active, la liste autorisée est appliquée non seulement dans les parcours en direct, mais également lors du test des messages avec des BAT et des parcours en mode test.
La logique de liste autorisée s’applique lorsque la fonctionnalité est active. En savoir plus dans cette section.
Désactiver la liste autorisée deactivate-allow-list
Pour désactiver la liste autorisée, procédez comme suit.
-
Accédez au menu Canaux > Configuration des e-mails > Liste autorisée.
-
Sélectionnez le bouton bascule.
-
Sélectionnez Désactiver la liste autorisée. La liste autorisée n’est plus active.
note note NOTE Une fois la liste autorisée désactivée, elle prend effet dans vos parcours et campagnes après un délai de 10 minutes. De même, la mise à jour de la liste autorisée et de la liste de suppression peut prendre jusqu’à 10 minutes.
La logique de liste autorisée ne s’applique pas lorsque la fonction est désactivée. En savoir plus dans cette section.
Ajout d'entités à la liste autorisée add-entities
Pour ajouter des adresses e-mail ou des domaines à la liste autorisée pour un sandbox spécifique, vous pouvez renseigner manuellement la liste ou utiliser un appel API.
Remplissage manuel de la liste autorisée manually-populate-list
Vous avez la possibilité de renseigner manuellement la liste autorisée Journey Optimizer en ajoutant une adresse e-mail ou un domaine par le biais de l’interface utilisateur.
Pour ce faire, suivez les étapes ci-après.
-
Sélectionnez le bouton Ajouter un e-mail ou un domaine.
-
Choisissez le type d'adresse : Adresse e-mail ou Adresse de domaine.
-
Saisissez l’adresse e-mail ou le domaine vers lesquels vous souhaitez envoyer des e-mails.
note note NOTE Veillez à saisir une adresse e-mail (par exemple abc@company) ou un domaine valide (par exemple abc.company.com). -
Indiquez un motif si nécessaire.
note note NOTE Tous les caractères ASCII compris entre 32 et 126 sont autorisés dans le champ Motif. La liste complète se trouve sur cette page par exemple. -
Cliquez sur Envoyer.
Ajout d’entités à l’aide d’un appel API api-call-allowed-list
Pour renseigner la liste autorisée, vous pouvez également appeler l’API de suppression avec la valeur ALLOWED pour l’attribut listType. Par exemple :
Vous pouvez effectuer les opérations Ajouter, Supprimer et Obtenir.
En savoir plus sur les appels API dans la documentation de référence Adobe Experience Platform API.
Télécharger la liste autorisée download-allowed-list
Pour exporter la liste autorisée au format CSV, suivez les étapes ci-dessous :
-
Sélectionnez le bouton Téléchargement le CSV.
-
Patientez jusqu’à ce que le fichier soit généré.
note note NOTE Le temps de téléchargement dépend de la taille du fichier, c’est-à-dire du nombre d’adresses qui se trouvent sur la liste autorisée. Une seule demande de téléchargement peut être traitée à la fois pour un sandbox donnée. -
Une fois le fichier généré, vous recevez une notification. Cliquez sur l’icône représentant une cloche en haut à droite de l’écran pour l’afficher.
-
Cliquez sur la notification elle-même pour télécharger le fichier.
note note NOTE Le lien est valide pendant 24 heures.
Logique de liste autorisée logic
Lorsque la liste autorisée est active, la logique suivante s’applique :
-
Si la liste autorisée est vide, aucun e-mail ne sera envoyé.
-
Si une entité est sur la liste autorisée et non sur la liste de suppression, l’e-mail peut être envoyé au(x) destinataire(s) correspondant(s). Cependant, si l'entité figure également sur la liste de suppression, le destinataire correspondant ne recevra pas l’e-mail, la raison étant Supprimé.
-
Si une entité n’est pas sur la liste autorisée (et pas sur la liste de suppression), le destinataire correspondant ne recevra pas l’e-mail, la raison étant Non autorisé.
Lorsque la liste autorisée est désactivée, tous les e-mails que vous envoyez à partir du sandbox actuel sont envoyés à tous les destinataires (à condition qu’ils ne figurent pas dans la liste de suppression), y compris les adresses réelles des clients.
Rapport d’exclusion reporting
Lorsque la liste autorisée est active, vous pouvez récupérer les adresses e-mail ou les domaines qui ont été exclus d’un envoi, car ils ne figuraient pas sur la liste autorisée. Pour ce faire, vous pouvez utiliser le service de requête Adobe Experience Platform pour effectuer les appels API ci-dessous.
Pour obtenir le nombre d’e-mails qui n’ont pas été envoyés car les destinataires n’étaient pas sur la liste autorisée, utilisez la requête suivante :
SELECT count(distinct _id) from cjm_message_feedback_event_dataset WHERE
_experience.customerJourneyManagement.messageExecution.messageExecutionID = '<MESSAGE_EXECUTION_ID>' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'
Pour obtenir la liste des adresses e-mail qui n’ont pas été envoyées car les destinataires n’étaient pas sur la liste autorisée, utilisez la requête suivante :
SELECT distinct(_experience.customerJourneyManagement.emailChannelContext.address) from cjm_message_feedback_event_dataset WHERE
_experience.customerJourneyManagement.messageExecution.messageExecutionID IS NOT NULL AND
_experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'