Configurare un elenco Consentiti allow-list

L'elenco Consentiti è un elenco sicuro per l'invio che puoi definire a livello di sandbox. Limita l’invio di e-mail a indirizzi o domini specifici, garantendo che solo i destinatari elencati in modo esplicito possano ricevere messaggi da una determinata sandbox.

CAUTION
Questa funzione si applica solo al canale e-mail. È disponibile su sandbox di produzione e non di produzione.

Nelle sandbox non di produzione, in cui possono verificarsi invii accidentali, l’elenco Consentiti impedisce che i messaggi indesiderati raggiungano gli indirizzi reali dei clienti, fornendo un ambiente sicuro a scopo di test.

Quando l’elenco Consentiti è attivo ma vuoto, non vengono inviate e-mail. Questo lo rende un utile freno di emergenza: se si verifica un problema critico, è possibile attivare un elenco Consentiti vuoto per interrompere tutte le comunicazioni in uscita da Journey Optimizer fino a quando il problema non viene risolto. Ulteriori informazioni sulla logica elenco Consentiti.

È inoltre possibile utilizzare l'API REST Soppressione di Journey Optimizer per gestire i messaggi in uscita a livello di programmazione tramite soppressione e elenchi consentiti. Scopri come utilizzare l’API REST di soppressione

Accedere all’elenco Consentiti access-allowed-list

Per accedere all'elenco dettagliato degli indirizzi e dei domini e-mail consentiti, vai a Amministrazione > Canali > Impostazioni e-mail e seleziona Elenco Consentiti.

Pagina di Elenco Consentiti che mostra lelenco degli indirizzi e-mail e dei domini consentiti

CAUTION
Le autorizzazioni per visualizzare, esportare e gestire l'elenco Consentiti sono limitate a amministratori di Percorso. Ulteriori informazioni sulla gestione dei diritti di accesso degli utenti Journey Optimizer in questa sezione.

Per esportare l'elenco Consentiti come file CSV, selezionare il pulsante Scarica CSV.

Utilizza il pulsante Elimina per rimuovere definitivamente una voce.

Puoi eseguire ricerche negli indirizzi e-mail o nei domini e filtrare in base al tipo di indirizzo. Una volta selezionato, puoi cancellare il filtro visualizzato sopra l’elenco.

Elenco Consentiti filtrato per tipo di indirizzo

Attiva l’elenco Consentiti enable-allow-list

Per attivare l’elenco Consentiti, segui la procedura riportata di seguito.

  1. Accedi al menu Canali > Configurazione e-mail > Elenco consentiti.

  2. Seleziona l’interruttore.

    Pulsante per attivare lelenco Consentiti

  3. Selezionare Attiva elenco Consentiti. L’elenco Consentiti è ora attivo.

    Conferma che lelenco Consentiti è ora attivo

    note note
    NOTE
    Dopo l’attivazione dell’elenco Consentiti, trascorrono 10 minuti prima che diventi effettivo nei percorsi e nelle campagne. Analogamente, la visualizzazione degli aggiornamenti sia dell’elenco di elenco Consentiti che di eliminazione può richiedere fino a 10 minuti.

La logica di elenco Consentiti si applica quando la funzione è attiva. Ulteriori informazioni in questa sezione.

NOTE
Quando è attivata, la funzione di elenco Consentiti viene rispettata durante l'esecuzione di percorsi, ma anche durante il test di messaggi con bozze e il test di percorsi utilizzando la modalità di test.

Disattivare l'elenco Consentiti deactivate-allow-list

Per disattivare l’elenco Consentiti, segui la procedura indicata di seguito.

  1. Accedi al menu Canali > Configurazione e-mail > Elenco consentiti.

  2. Seleziona l’interruttore.

    Pulsante per disattivare lelenco Consentiti

  3. Selezionare Disattiva elenco Consentiti. L’elenco Consentiti non è più attivo.

    Conferma dellinattività dellelenco Consentiti

    note note
    NOTE
    Dopo aver disattivato l’elenco Consentiti, trascorrono 10 minuti prima che diventi effettivo nei percorsi e nelle campagne. Analogamente, la visualizzazione degli aggiornamenti sia dell’elenco di elenco Consentiti che di eliminazione può richiedere fino a 10 minuti.

La logica di elenco Consentiti non si applica quando la funzione viene disattivata. 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.

NOTE
L’elenco Consentiti può contenere fino a 1.000 voci.

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.

NOTE
Puoi aggiungere un solo indirizzo e-mail o dominio alla volta.

Per farlo, segui la procedura indicata di seguito.

  1. Selezionare il pulsante Aggiungi e-mail o dominio.

    Pulsante Aggiungi e-mail o dominio nella pagina di elenco Consentiti

  2. Scegli il tipo di indirizzo: Indirizzo e-mail o Indirizzo di dominio.

  3. Immetti l’indirizzo e-mail o il dominio a cui desideri inviare le e-mail.

    note note
    NOTE
    Assicurati di inserire un indirizzo e-mail valido (ad esempio abc@company.com) o un dominio (ad esempio abc.company.com).
  4. Se necessario, specifica un motivo.

    Modulo per aggiungere un indirizzo e-mail o un dominio allelenco Consentiti, con un campo motivo facoltativo

    note 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.
  5. 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:

Chiamata API di esempio per aggiungere una voce allelenco Consentiti utilizzando lAPI di soppressione

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:

  1. Selezionare il pulsante Scarica CSV.

    Pulsante Scarica CSV nella pagina di elenco Consentiti

  2. Attendi che il file venga generato.

    Notifica che indica che il file CSV è in fase di generazione

    note 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.
  3. Una volta generato il file, riceverai una notifica. Fai clic sull’icona a forma di campana in alto a destra dello schermo per visualizzarla.

  4. Fai clic sulla notifica stessa per scaricare il file.

    Notifica con un collegamento di download per il file CSV generato

    note 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.

NOTE
I profili con stato Non consentito sono esclusi durante il processo di invio dei messaggi. Pertanto, mentre nei report Percorso questi profili vengono visualizzati come spostati nel percorso (Attività Read Audience e attività messaggio), i report e-mail non li includono nelle metriche Inviati in quanto vengono filtrati prima dell'invio di e-mail.
Ulteriori informazioni sul report live e sul report Customer Journey Analytics.

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'
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76