Configurar uma lista de permissões allow-list
A lista de permissões é uma lista de segurança de envio que você pode definir no nível sandbox. Ele restringe o envio de emails para endereços ou domínios específicos, garantindo que somente os recipients explicitamente listados possam receber mensagens de uma determinada sandbox.
Em sandboxes de não produção, em que podem ocorrer envios acidentais, a lista de permissões impede que mensagens indesejadas cheguem a endereços reais de clientes, fornecendo um ambiente seguro para fins de teste.
Quando a lista de permissões está ativa, mas vazia, nenhum email é enviado. Isso faz dele um freio de emergência útil: se ocorrer um problema crítico, você pode ativar uma lista de permissões vazia para interromper todas as comunicações de saída de Journey Optimizer até que o problema seja resolvido. Saiba mais sobre a lógica de lista de permissões.
Você também pode usar a API REST de Supressão do Journey Optimizer para gerenciar mensagens de saída de forma programática por meio de supressão e listas de permissões. Saiba como 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ções 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 Depois de ativar a lista de permissões, há um atraso de 10 minutos antes de ela entrar em vigor em suas jornadas e campanhas. Da mesma forma, as atualizações nas listas de lista de permissões e supressão podem levar até 10 minutos para serem refletidas.
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á um atraso de 10 minutos antes de ela entrar em vigor em suas jornadas e campanhas. Da mesma forma, as atualizações nas listas de lista de permissões e supressão podem levar até 10 minutos para serem refletidas.
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 no intervalo de 32 a 126 são permitidos no campo Motivo. Para referência, consulte a lista completa 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 do 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'