Liste autorisée allow-list
Il est possible de définir une liste de sécurité d’envoi spécifique au niveau du sandbox.
La liste autorisée vous permet de spécifier des adresses e-mail ou des domaines individuels qui seront les seuls destinataires ou domaines autorisés à recevoir les e-mails que vous envoyez à partir d’un sandbox spécifique.
Par exemple, sur une instance hors production, où des erreurs peuvent se produire, la liste autorisée garantit que vous ne risquez pas d’envoyer des messages indésirables à de vraies adresses client et fournit donc un environnement sécurisé à des fins de test.
De plus, lorsque la liste autorisée est active mais vide, aucun e-mail ne sera envoyé. Par conséquent, si vous rencontrez un problème majeur, vous pouvez utiliser cette fonctionnalité pour arrêter toutes les communications sortantes depuis Journey Optimizer jusqu’à ce que vous résolviez le problème. En savoir plus sur la logique de liste autorisée.
En outre, vous pouvez tirer parti de l’API REST de suppression Journey Optimizer pour contrôler vos messages sortants à l’aide des listes de suppression et des 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.
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 Une fois la liste autorisée activée, une latence de 5 minutes est nécessaire pour qu’elle prenne effet dans vos parcours et vos campagnes.
La logique de liste autorisée s’applique lorsque la fonctionnalité est activée. 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, une latence de 5 minutes est nécessaire pour qu’elle prenne effet dans vos parcours et vos campagnes.
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.
Pour en savoir plus sur l’émission d’appels d’API, consultez la documentation de référence des API Adobe Experience Platform.
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 activée, 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 Query Service d’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'