Set up an allowed list allow-list
The allowed list is a sending-safe list you can define at the sandbox level. It restricts email sending to specific addresses or domains, ensuring that only explicitly listed recipients can receive messages from a given sandbox.
On non-production sandboxes, where accidental sends can occur, the allowed list prevents unwanted messages from reaching real customer addresses, providing a secure environment for testing purposes.
When the allowed list is active but empty, no emails are sent. This makes it a useful emergency brake: if a critical issue arises, you can activate an empty allowed list to halt all outgoing communications from Journey Optimizer until the problem is resolved. Learn more about the allowed list logic.
You can also use the Journey Optimizer Suppression REST API to manage outgoing messages programmatically through suppression and allow lists. Scopri come utilizzare l’API REST di soppressione
Access the allowed list access-allowed-list
To access the detailed list of allowed email addresses and domains, go to Administration > Channels > Email settings, and select Allowed list.
To export the allowed list as a CSV file, select the Download CSV button.
Use the Delete button to permanently remove an entry.
You can search on the email addresses or domains, and filter on the Address type. Once selected, you can clear the filter displayed on top of the list.
Activate the allowed list enable-allow-list
To activate the allowed list, follow the steps below.
-
Access the Channels > Email configuration > Allow list menu.
-
Select the toggle button.
-
Select Activate allowed list. The allowed list is now active.
note NOTE - After activation, there is a 10-minute delay before the allowed list takes effect in journeys and campaigns. Updates to both the allowed list and suppression list can also take up to 10 minutes to reflect.
- When active, the allowed list is enforced not only in live journeys, but also when testing messages with proofs and journeys in test mode.
The allowed list logic applies when the feature is active. Ulteriori informazioni in questa sezione.
Deactivate the allowed list deactivate-allow-list
To deactivate the allowed list, follow the steps below.
-
Access the Channels > Email configuration > Allow list menu.
-
Select the toggle button.
-
Select Deactivate allowed list. The allowed list is no longer active.
note NOTE After you deactivate the allowed list, there is a 10-minute delay before it takes effect in your journeys and campaigns. Similarly, updates to both the allowed list and suppression list can take up to 10 minutes to reflect.
The allowed list logic does not apply when the feature is deactivated. Ulteriori informazioni in questa sezione.
Aggiungere entità all’elenco Consentiti add-entities
Per aggiungere nuovi indirizzi e-mail o domini all’elenco Consentiti per una sandbox specifica, puoi compilare manualmente l’elenco o utilizzare una chiamata API.
Compila manualmente l’elenco Consentiti manually-populate-list
È possibile popolare manualmente l’elenco Consentiti Journey Optimizer aggiungendo un indirizzo e-mail o un dominio tramite l’interfaccia utente.
Per farlo, segui la procedura indicata di seguito.
-
Selezionare il pulsante Aggiungi e-mail o dominio.
-
Scegli il tipo di indirizzo: Indirizzo e-mail o Indirizzo di dominio.
-
Immetti l’indirizzo e-mail o il dominio a cui desideri inviare le e-mail.
note NOTE Assicurati di inserire un indirizzo e-mail valido (ad esempio abc@company.com) o un dominio (ad esempio abc.company.com). -
Se necessario, specifica un motivo.
note NOTE Tutti i caratteri ASCII compresi tra 32 e 126 sono consentiti nel campo Reason. L’elenco completo è disponibile su questa pagina di esempio. -
Fai clic su Invia.
Aggiungere entità utilizzando una chiamata API api-call-allowed-list
Per popolare l’elenco Consentiti, puoi anche chiamare l’API di soppressione con il valore ALLOWED per l’attributo listType. Ad esempio:
Puoi eseguire le operazioni Aggiungi, Elimina e Ottieni.
Per ulteriori informazioni sull’esecuzione di chiamate API, consulta la documentazione di riferimento sulle API Adobe Experience Platform.
Scarica l’elenco Consentiti download-allowed-list
Per esportare l’elenco Consentiti come file CSV, effettua le seguenti operazioni:
-
Selezionare il pulsante Scarica CSV.
-
Attendi che il file venga generato.
note NOTE Il tempo di download dipende dalla dimensione del file, ovvero dal numero di indirizzi presenti nell’elenco Consentiti. È possibile elaborare una richiesta di download alla volta per una determinata sandbox. -
Una volta generato il file, riceverai una notifica. Fai clic sull’icona a forma di campana in alto a destra dello schermo per visualizzarla.
-
Fai clic sulla notifica stessa per scaricare il file.
note NOTE Il collegamento è valido per 24 ore.
Logica dell’elenco Consentiti logic
Quando l’elenco Consentiti è attivo, si applica la logica seguente:
-
Se l’elenco Consentiti è vuoto, non verrà inviata alcuna e-mail.
-
Se un’entità è nell’elenco Consentiti e non nell’elenco di soppressione, l’e-mail viene inviata ai destinatari corrispondenti. Tuttavia, se l’entità è presente anche nell’elenco di soppressione, i destinatari corrispondenti non riceveranno l’e-mail, per il motivo Eliminato.
-
Se un’entità è non presente nell’elenco Consentiti (e non nell’elenco di soppressione), i destinatari corrispondenti non riceveranno l’e-mail. Motivo: Non consentito.
Quando l’elenco Consentiti è disattivato, tutte le e-mail che invii dalla sandbox corrente vengono inviate a tutti i destinatari (purché non siano inclusi nell’elenco di soppressione), inclusi gli indirizzi dei clienti reali.
Generazione di rapporti di esclusione reporting
Quando l’elenco Consentiti è attivo, puoi recuperare gli indirizzi e-mail o i domini esclusi da un invio perché non erano presenti nell’elenco Consentiti. A tale scopo, è possibile utilizzare Adobe Experience Platform Query Service per effettuare le seguenti chiamate API.
Per ottenere il numero di e-mail non inviate perché i destinatari non erano inclusi nell’elenco Consentiti, utilizzare la query seguente:
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'
Per ottenere l’elenco di indirizzi di posta elettronica non inviati perché i destinatari non erano inclusi nell’elenco Consentiti, utilizzare la query seguente:
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'