Lista de permissões allow-list
É possível definir uma lista específica de segurança de envio no nível da sandbox.
Essa lista de permissões permite especificar endereços de email ou domínios individuais que serão os únicos destinatários ou domínios autorizados a receber os emails enviados de uma sandbox específica.
Por exemplo, em uma instância de não produção, em que podem ocorrer erros, a lista de permissões garante que você não tenha risco de enviar mensagens indesejadas para endereços reais de clientes e, portanto, fornece um ambiente seguro para fins de teste.
Além disso, quando a lista de permissões estiver ativa, mas vazia, nenhum email será enviado. Portanto, se você encontrar algum problema grave, poderá usar este recurso para interromper todas as comunicações de saída de Journey Optimizer até que corrija o problema. Saiba mais sobre a lógica de lista de permissões.
Além disso, é possível aproveitar a API REST de supressão do Journey Optimizer para controlar as mensagens enviadas usando listas de supressão e de permissões. Aprenda a trabalhar com a API REST de supressão
Acessar a lista de permissões access-allowed-list
Para acessar a lista detalhada de domínios e endereços de email permitidos, vá para Administração > Canais > Configuração de email e selecione Lista de permissões.
Para exportar a lista de permissões como um arquivo CSV, selecione o botão Baixar CSV.
Use o botão Excluir para remover permanentemente uma entrada.
Você pode pesquisar endereços de email ou domínios e filtrar por Tipo de endereço. Depois de selecionado, é possível limpar o filtro exibido na parte superior da lista.
Ativar a lista de permissões enable-allow-list
Para ativar a lista de permissões, siga as etapas abaixo.
-
Acesse o menu Canais > Configuração de email > Lista de permissões.
-
Selecione o botão de alternância.
-
Selecione Ativar lista de permissões. A lista de permissões agora está ativa.
note note NOTE Após ativar a lista de permissões, há uma latência de 5 minutos para que ela entre em vigor em suas jornadas e campanhas.
A lógica de lista de permissões se aplica quando o recurso está ativo. Saiba mais nesta seção.
Desativar a lista de permissões deactivate-allow-list
Para desativar a lista de permissões, siga as etapas abaixo.
-
Acesse o menu Canais > Configuração de email > Lista de permissões.
-
Selecione o botão de alternância.
-
Selecione Desativar lista de permissões. A lista de permissões não está mais ativa.
note note NOTE Depois de desativar a lista de permissões, há uma latência de 5 minutos para que ela entre em vigor em suas jornadas e campanhas.
A lógica de lista de permissões não se aplica quando o recurso é desativado. Saiba mais nesta seção.
Adicionar entidades à lista de permissões add-entities
Para adicionar novos domínios ou endereços de email à lista de permissões para uma sandbox específica, você pode preencher manualmente a lista ou usar uma chamada de API.
Preencher manualmente a lista de permissões manually-populate-list
Você pode preencher manualmente a lista de permissões Journey Optimizer adicionando um endereço de email ou um domínio por meio da interface do usuário.
Para fazer isso, siga as etapas abaixo.
-
Selecione o botão Adicionar email ou domínio.
-
Escolha o tipo de endereço: Endereço de email ou Endereço de domínio.
-
Insira o endereço de email ou domínio para o qual deseja enviar emails.
note note NOTE Certifique-se de inserir um endereço de email (como abc@empresa.com) ou de domínio (como abc.empresa.com) válido. -
Especifique um motivo, se necessário.
note note NOTE Todos os caracteres ASCII entre 32 e 126 são permitidos no campo Motivo. Para referência, a lista completa pode ser encontrada nesta página. -
Clique em Enviar.
Adicionar entidades usando uma chamada de API api-call-allowed-list
Para preencher a lista de permissões, você também pode chamar a API de supressão com o valor ALLOWED para o atributo listType. Por exemplo:
Você pode executar as operações Adicionar, Excluir e Obter.
Saiba mais sobre como fazer chamadas de API na documentação de referência das APIs do Adobe Experience Platform.
Baixar a lista de permissões download-allowed-list
Para exportar a lista de permissões como um arquivo CSV, siga as etapas abaixo:
-
Selecione o botão Baixar CSV.
-
Espere até que o arquivo seja gerado.
note note NOTE O tempo de download depende do tamanho do arquivo, o que significa o número de endereços na lista de permissões. Uma solicitação de download pode ser processada de cada vez para uma determinada sandbox. -
Depois que o arquivo for gerado, você receberá uma notificação. Clique no ícone de sino na parte superior direita da tela para exibi-lo.
-
Clique na própria notificação para baixar o arquivo.
note note NOTE O link é válido por 24 horas.
Lógica de lista de permissões logic
Quando a lista de permissões está ativa, a seguinte lógica é aplicada:
-
Se a lista de permissões estiver vazia, nenhum email será enviado.
-
Se uma entidade estiver na lista de permissões, e não na lista de supressão, o email será enviado ao(s) destinatário(s) correspondente(s). No entanto, se a entidade também estiver na lista de supressão, os destinatários correspondentes não receberão o email, o motivo será Suprimido.
-
Se uma entidade não estiver na lista de permissões (e não na lista de supressão), os destinatários correspondentes não receberão o email, o motivo será Não permitido.
Quando a lista de permissões é desativada, todos os emails que você está enviando da sandbox atual são enviados para todos os destinatários (desde que não estejam na lista de supressão), incluindo endereços reais de clientes.
Relatório de exclusão reporting
Quando a lista de permissões está ativa, é possível recuperar endereços de email ou domínios que foram excluídos de um envio porque não estavam na lista de permissões. Para fazer isso, você pode usar o Serviço de consulta Adobe Experience Platform para fazer as chamadas de API abaixo.
Para obter o número de emails que não foram enviados porque os destinatários não estavam na lista de permissões, use a seguinte consulta:
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'
Para obter a lista de endereços de email que não foram enviados porque os destinatários não estavam na lista de permissões, use a seguinte consulta:
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'