Recebimento de alertas quando ocorrerem falhas receiving-alerts-when-failures-happen
Sobre alertas de delivery about-delivery-alerting
O recurso Alerta de entrega é um sistema de gerenciamento de alertas que permite que um grupo de usuários receba automaticamente notificações contendo informações sobre a execução de suas entregas.
As notificações enviadas contêm um relatório com base nos seguintes critérios por padrão:
- Entregas com falha
- Entregas com falha na preparação
- Entregas com uma taxa de erro de rejeição temporária incorreta
- Entregas com uma taxa de erro de rejeição permanente ruim
- Entregas com um status pendente mais longo que o normal
- Deliveries com baixo throughput
- Entregas em andamento
Os recipients dos alertas podem monitorar os deliveries que estão sendo processados pelo Adobe Campaign e tomar as medidas apropriadas quando houver problemas em sua execução.
Essas notificações de alerta podem ser personalizadas dependendo de critérios de alerta específicos que são definidos por meio de um painel na interface do Adobe Campaign.
As notificações enviadas contêm:
- Uma Summary que exibe o número de entregas que atendem aos critérios definidos e o rótulo/cor escolhido para cada critério.
- Uma seção Details listando todos os critérios de entrega definidos para o painel correspondente e todas as entregas para cada critério.
Painéis de alertas de entrega delivery-alerting-dashboards
Sobre os painéis de alerta do delivery about-delivery-alerting-dashboards
Para gerenciar os destinatários das notificações, definir os critérios de alerta e acessar o histórico dos alertas, é necessário usar painéis.
Na interface do Adobe Campaign, é possível:
-
Crie e gerencie painéis de alerta de delivery. Consulte Criando um painel de alertas de entrega.
-
Defina e gerencie os critérios de alerta de delivery para cada painel. Por exemplo, você pode criar alertas com base em deliveries com falha de preparação ou deliveries com baixa taxa de transferência apenas. Consulte Sobre os critérios de alerta.
-
Modifique os parâmetros de critérios para cada painel. Consulte Parâmetros de critérios.
-
Defina um grupo de recipients para cada painel.
Por exemplo, você deseja informar os usuários com direitos administrativos somente sobre os deliveries com falha. No entanto, você deseja que os usuários de marketing recebam informações sobre os deliveries com uma taxa de erro leve de rejeição. Portanto, é necessário criar dois painéis diferentes e definir os critérios que deseja para cada grupo de recipients.
-
Acesse o histórico de todos os alertas enviados para cada painel.
Ao selecionar um painel, o último alerta enviado para esse painel é exibido por padrão. Todos os alertas enviados são listados à esquerda da tela. Clique em um item na lista History para acessar os alertas correspondentes.
Criação de um painel de alerta de delivery creating-a-delivery-alerting-dashboard
Para enviar notificações com base em critérios específicos para diferentes grupos de usuários, é necessário usar vários painéis. Para criar um novo painel:
-
Vá para Administration > Channels > Delivery alerting.
-
Selecione Delivery alerting dashboards e clique em Create.
-
Marque a caixa Enabled para ativar o painel atual.
Se essa opção estiver desativada, as notificações vinculadas a esse painel não serão mais enviadas. Essa opção está desabilitada por padrão.
-
Selecione o grupo de destinatários que deseja notificar na lista suspensa Alert group. Para modificar ou criar um grupo, consulte Criação de um grupo de segurança e atribuição de usuários.
-
Na seção Delivery alerting criteria, clique em Create element para adicionar critérios. Consulte Sobre os critérios de alerta.
-
Selecione o botão Edit properties. Na guia Criteria parameters, defina como os critérios serão aplicados. Consulte Parâmetros de critérios.
-
Clique em Create para salvar o painel.
Agora, sempre que um delivery atender aos critérios definidos nesse painel, uma notificação de alerta será enviada para o grupo especificado de usuários.
Critérios de alertas de entrega delivery-alerting-criteria
Sobre os critérios de alerta about-alerting-criteria
Para acessar os critérios de alerta de entrega, vá para Administration > Channels > Delivery alerting e selecione Delivery alerting criteria.
Os seguintes critérios podem ser usados nos painéis de alerta de delivery:
- Deliveries failed: Qualquer entrega agendada dentro de um intervalo definido, com status incorreto.
- Deliveries with preparation failed: Qualquer entrega modificada dentro de um intervalo definido, para a qual a etapa de preparação (cálculo de destino e geração de conteúdo) falhou. Para obter mais informações, consulte Preparação do envio.
- Delivery with bad error ratio for soft bounces: Qualquer entrega agendada dentro de um intervalo definido, com um status de pelo menos In progress, com uma taxa de erro de rejeição temporária maior que uma porcentagem definida.
- Delivery with bad error ratio for hard bounces: Qualquer entrega agendada dentro de um intervalo definido, com um status de pelo menos In progress, com uma taxa de erro de rejeição permanente maior que uma porcentagem definida.
- Deliveries with long start pending: Qualquer entrega agendada dentro de um intervalo definido, com um status Start pending por mais tempo do que uma duração definida, status Start pending significando que as mensagens ainda não foram consideradas pelo sistema.
- Deliveries with low throughput: Qualquer entrega iniciada por mais de uma duração definida, com menos de uma porcentagem definida de mensagens processadas, com uma taxa de transferência inferior a um valor definido.
- Deliveries in progress: Qualquer entrega agendada dentro de um intervalo definido, com o status In progress.
Você pode selecionar qualquer item da lista Delivery alerting criteria para acessar seus detalhes.
Para cada critério, você pode definir as seguintes configurações:
-
Indicators to add in alerts, o que significa que as colunas que aparecerão na seção Details da notificação para as entregas correspondentes ao critério selecionado.
-
Alert type, que significa o rótulo e a cor que aparecerão ao lado do critério de entrega no resumo da notificação.
-
Criteria frequency: se um critério for atendido para uma entrega, ele será repetido em cada notificação enviada dentro do período de monitoramento. Caso contrário, somente um alerta será enviado por dia (na primeira ocorrência) por critério de alerta para um delivery.
Por padrão, essa opção é definida para uma vez por dia para todos os critérios.
Tópicos relacionados:
Criação de um critério de alerta de delivery creating-a-delivery-alerting-criterion
Você pode criar novos critérios de alerta de delivery para melhor atender às suas necessidades.
Por exemplo, você pode criar um novo critério que permita enviar uma notificação listando todos os deliveries com um status Finished.
Para fazer isso, primeiro é necessário estender o recurso Delivery e adicionar um novo filtro que permita selecionar apenas as entregas com status Finished.
-
Vá para Adobe Campaign > Administração > Desenvolvimento > Recursos personalizados e clique em Create.
-
Selecione Extend an existing resource, selecione o recurso Delivery na lista suspensa e clique em Create para editá-lo.
Para obter mais informações sobre a extensão de um recurso existente, consulte Definir o recurso.
-
No recurso Delivery, vá para a guia Filter definition e clique em Add an element para criar um filtro.
-
Edite a nova definição de filtro: na janela Filter definition, arraste e solte o item Status no espaço de trabalho e selecione Finished como condição de filtro.
Para obter mais informações sobre como criar e editar filtros personalizados, consulte Definir filtros.
-
Salve as alterações e publique os recursos. Para obter mais informações, consulte Publicação de um recurso personalizado.
O filtro é criado e agora pode ser selecionado em um novo critério de alerta de delivery.
-
Vá para Administration > Channels > Delivery alerting, selecione Delivery alerting criteria e clique em Create.
-
Na lista suspensa Delivery filter applied by this criterion, selecione o filtro que você acabou de criar.
Você pode definir as configurações dos seus critérios da mesma forma que os critérios padrão. Consulte Sobre os critérios de alerta.
Depois de criados, esses critérios podem ser adicionados a um painel de alerta de delivery, bem como a outros critérios. Consulte Sobre painéis de alertas de entrega.
Tópicos relacionados:
Parâmetros de alerta de entrega delivery-alerting-parameters
Parâmetros de critérios criteria-parameters
Na guia Criteria parameters de um painel de alertas de entrega, você pode definir as configurações que se aplicam aos critérios selecionados neste painel.
-
Delivery target minimum size: por exemplo, se você inserir 100 neste campo, uma notificação será enviada somente para deliveries com um público alvo igual ou maior que 100 recipients. Esse parâmetro se aplica a todos os critérios.
-
Monitoring period before and after the contact date (in hours): Número de horas antes e depois da hora atual. Somente os deliveries com uma data de contato nesse intervalo de tempo são considerados. Esse parâmetro se aplica a todos os critérios. Por padrão, o valor desse campo é definido como 24 horas.
Para obter mais informações sobre a data de contato, consulte Sobre o agendamento.
-
Maximum ratio of soft bounce errors: uma notificação é enviada para todas as entregas com uma taxa de erro de rejeição temporária maior que o valor especificado. Por padrão, o valor desse campo é definido como 0,05 (5%).
Para obter mais informações sobre erros de rejeição temporária, consulte Qualificação de email de rejeição e Lista de tipos de falha de entrega.
-
Maximum ratio of hard bounce errors: uma notificação é enviada para todas as entregas com uma taxa de erro de rejeição permanente maior que o valor especificado. Por padrão, o valor desse campo é definido como 0,05 (5%).
Para obter mais informações sobre erros de rejeição permanente, consulte Qualificação de email de rejeição e Lista de tipos de falha de entrega.
-
Minimum time threshold for delivery in ‘Start pending’ status (in minutes): uma notificação é enviada para todas as entregas com status Start pending por mais tempo do que a duração especificada neste campo, status Start pending significando que as mensagens ainda não foram consideradas pelo sistema.
-
Minimum time required for the computation of the throughput (in minutes): Somente entregas iniciadas (com status In progress) por mais tempo do que a duração especificada são consideradas para o critério Deliveries with low throughput.
-
Maximum percentage of processed messages for the computation of the throughput: Somente entregas com uma porcentagem de mensagens processadas inferior à porcentagem especificada são consideradas para o critério Deliveries with low throughput.
-
Minimum expected throughput (in sent messages per hour): Somente entregas com uma taxa de transferência menor que o valor especificado são consideradas para o critério Deliveries with low throughput.
-
Minimum processed ratio required for ‘Deliveries in progress’ criterion: Somente entregas com uma porcentagem de mensagens processadas maior que a porcentagem especificada são consideradas.
Frequência de alerta alerting-frequency
A opção Frequency of delivery alerting permite definir o atraso entre dois envios de alerta. Por padrão, é definido como 10 minutos.
Você pode alterar essa configuração no menu Administration > Application settings > Options.
Motivos de alerta de delivery delivery-alerting-reasons
O recurso Alertas de entrega mantém todos os usuários do Adobe Campaign envolvidos informados automaticamente sobre o status de execução da entrega, por email e pelo painel.
Agora, quando você receber uma notificação de alerta de delivery, veja algumas dicas sobre o que você pode fazer.
Primeiro, verifique a guia Log do delivery para exibir todas as informações relacionadas ao delivery e às provas. Os ícones vermelho e amarelo permitem identificar erros ou avisos. O ícone vermelho indica um erro crítico que impede que o delivery seja iniciado.
Para exibir o histórico de cada ocorrência de uma entrega, selecione a guia Sending logs. Ela contém a lista de mensagens enviadas e seus status. Você pode verificar o status de entrega de cada destinatário ( Sent, Pending, Failed etc.). Para obter mais informações, consulte Enviar logs.
Estes são alguns motivos possíveis para receber notificações de alerta de acordo com os critérios que são atendidos para um delivery.
-
Deliveries failed: este critério informa sobre todas as entregas com status incorreto. Pode ser devido a:
- Um problema com o servidor de entrega (MTA, Agente de transferência de mensagem)
- Um tempo limite de conexão entre o servidor de entrega do Adobe Campaign e o servidor de recebimento
- Um problema da capacidade de entrega
- Um workflow incorreto
Se o delivery for acionado com um workflow, verifique se esse workflow foi iniciado corretamente. Para obter mais informações, consulte Executando um fluxo de trabalho. Caso contrário, entre em contato com o administrador do Adobe Campaign para resolver o problema.
-
Deliveries with preparation failed: um erro pode ocorrer durante a preparação da entrega nos seguintes casos:
- Falta um assunto na entrega.
- Há uma sintaxe incorreta nos campos de personalização.
- O destino está ausente.
- A entrega excede o limite de tamanho.
Para obter mais informações, consulte Preparação do envio. No entanto, esses erros geralmente são identificados durante a análise da mensagem. Consulte Regras de controle.
-
As possíveis causas para um alerta Delivery with bad error ratio for soft bounces podem ser:
- O servidor do destinatário está inativo.
- A caixa de correio do destinatário está cheia.
Para obter mais informações, verifique as guias Exclusion logs e Exclusion causes dos logs de entrega. Consulte Logs de exclusão.
As possíveis causas para um alerta Delivery with bad error ratio for hard bounces podem ser:
- O recipient é adicionado ao incluo na lista de bloqueios, o que significa que ele não deseja mais ser contatado.
- O endereço de email do destinatário não existe.
- O domínio do destinatário não existe.
- O servidor do destinatário está bloqueando a entrega.
Para evitar erros de devolução temporária e permanente, siga as práticas recomendadas abaixo:
- Crie regras de tipologia de filtragem para excluir uma parte do público-alvo da mensagem durante a análise de entrega, como destinatários em quarentena. Consulte Criando uma regra de filtragem.
- Atualize regularmente o banco de dados do cliente para manter bons processos de gerenciamento de quarentena. Consulte Sobre quarentenas.
- De modo geral, melhore a capacidade de delivery da melhor maneira possível. Consulte a documentação detalhada da Capacidade de entrega do Adobe Campaign e entre em contato com o administrador do Adobe Campaign para obter assistência.
-
Deliveries with long start pending: Geralmente significa que há um problema no nível do MTA (Agente de Transferência de Mensagem). O processo de execução está aguardando a disponibilidade de alguns recursos. O MTA pode não ter sido iniciado.
Deliveries with low throughput: Novamente, esse é um problema de capacidade de entrega, o que significa que o MTA é muito lento.
Para obter mais informações sobre esses problemas, entre em contato com o administrador do Adobe Campaign.
Tópicos relacionados: