Receber alertas quando ocorrerem falhas

Sobre alertas de delivery

O recurso Alerting do Delivery é 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 seus delivery.

As notificações enviadas contêm um relatório com base, por padrão, nos seguintes critérios:

  • Delivery com falha
  • Delivery com falha na preparação
  • Delivery com uma taxa de erro de rejeição suave incorreta
  • Delivery com uma taxa de erro de rejeição em disco rígido
  • Delivery com status pendente maior que o normal
  • Delivery com baixa throughput
  • Delivery em andamento

Os recipient dos alertas podem monitorar os delivery que estão sendo processados pela Adobe Campaign e tomar as medidas apropriadas quando houver problemas na execução.

Essas notificações de alerta podem ser personalizadas dependendo de critérios de alerta específicos definidos por meio de um painel na interface do Adobe Campaign.

OBSERVAÇÃO

As notificações de alerta são entregues somente por email.

As notificações enviadas contêm:

  • Um Summary exibindo o número de delivery que atendem aos critérios definidos e o rótulo/cor escolhido para cada critério.
  • Uma seção Details que lista todos os critérios de delivery definidos para o painel correspondente e todos os delivery para cada critério.

Painéis de alerta de delivery

Sobre painéis de alerta de delivery

Para gerenciar os recipient das notificações, definir os critérios de alerta e acessar o histórico dos alertas, é necessário usar painéis.

OBSERVAÇÃO

Para acessar e configurar os painéis e os critérios de alerta, você deve ter direitos administrativos ou aparecer no grupo de segurança Supervisores do Delivery. Os usuários padrão não podem acessar os painéis na interface do Adobe Campaign. Eles só podem receber as notificações de alerta. Para obter mais informações sobre usuários e segurança no Adobe Campaign, consulte Tipos de usuários e Sobre grupos de segurança.

Na interface do Adobe Campaign, é possível:

  • Crie e gerencie painéis de alertas de delivery. Consulte Criação de um painel de alerta de delivery.

  • Defina e gerencie os critérios de alerta do delivery para cada painel. Por exemplo, você pode criar alertas com base em delivery com problemas de preparação ou delivery com baixa taxa de transferência. 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 recipient para cada painel.

    Por exemplo, você deseja informar os usuários com direitos administrativos somente dos delivery que falharam. No entanto, você deseja que os usuários de marketing recebam informações sobre os delivery com uma taxa de erro de rejeição suave. Portanto, é necessário criar dois painéis diferentes e definir os critérios desejados para cada grupo de recipient.

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

Criando um painel de alerta de delivery

Se desejar enviar notificações com base em critérios específicos para grupos diferentes de usuários, será necessário usar vários painéis. Para criar um novo painel:

  1. Acesse Administration > Channels > Delivery alerting.

  2. Selecione Delivery alerting dashboards e clique em Create.

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

  4. Selecione o grupo de recipient que deseja notificar na lista suspensa Alert group. Para modificar ou criar um grupo, consulte Criar um grupo de segurança e atribuir usuários.

  5. Na seção Delivery alerting criteria, clique em Create element para adicionar critérios. Consulte Sobre os critérios de alerta.

  6. Selecione o botão Edit properties. Na guia Criteria parameters, defina como os critérios serão aplicados. Consulte Parâmetros de critérios.

  7. Clique em Create para salvar o painel.

Agora, cada vez 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 alerta do delivery

Sobre os critérios de alerta

Para acessar os critérios de alerta do delivery, vá até Administration > Channels > Delivery alerting e selecione Delivery alerting criteria.

Os seguintes critérios podem ser usados nos painéis de alerta do delivery:

  • Deliveries failed: Qualquer delivery programado em um intervalo definido, com um status incorreto.
  • Deliveries with preparation failed: Qualquer delivery modificado em um intervalo definido, para o qual a etapa de preparação (cálculo do público alvo e geração de conteúdo) falhou. Para obter mais informações, consulte Preparando o send.
  • Delivery with bad error ratio for soft bounces: Qualquer delivery programado em um intervalo definido, com um status pelo menos In progress, com uma relação de erro de rejeição suave maior que uma porcentagem definida.
  • Delivery with bad error ratio for hard bounces: Qualquer delivery agendado dentro de um intervalo definido, com um status pelo menos In progress, com uma taxa de erro de rejeição em massa superior a uma porcentagem definida.
  • Deliveries with long start pending: Qualquer delivery agendado dentro de um intervalo definido, com um Start pending status maior que uma duração definida, Start pending status que significa que as mensagens ainda não foram levadas em conta pelo sistema.
  • Deliveries with low throughput: Qualquer delivery iniciado por mais tempo do que uma duração definida, com menos de uma porcentagem definida de mensagens processadas, com uma saída menor do que um valor definido.
  • Deliveries in progress: Qualquer delivery programado dentro de um intervalo definido, com o In progress status.
OBSERVAÇÃO

Todos os parâmetros que se aplicam aos critérios acima têm valores padrão. Esses valores podem ser alterados na guia Criteria parameters dos painéis de alerta do delivery. Consulte Parâmetros de critérios.

Você pode selecionar qualquer item da lista Delivery alerting criteria para acessar seus detalhes.

Para cada critério, é possível definir as seguintes configurações:

  • Indicators to add in alerts, ou seja, as colunas que aparecerão na Details seção da notificação para os delivery correspondentes ao critério selecionado.

  • Alert type, ou seja, o rótulo e a cor que aparecerão ao lado do critério do delivery no resumo da notificação.

  • Criteria frequency: Se um critério for cumprido para um delivery, repete-se em cada notificação enviada durante o período de monitorização. Caso contrário, apenas 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 como uma vez por dia para todos os critérios.

Tópicos relacionados:

Criando um critério de alerta de delivery

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 permitindo o envio de uma notificação listando todos os delivery com um status Finished.

Para fazer isso, é necessário estender o recurso Delivery e adicionar um novo filtro que permita selecionar apenas os delivery com um status Finished.

  1. Vá para Adobe Campaign > Administração > Desenvolvimento > Recursos personalizados e clique em Create.

  2. 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 como estender um recurso existente, consulte Definir o recurso.

  3. No recurso Delivery, vá para a guia Filter definition e clique em Add an element para criar um filtro.

  4. 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 a condição de filtro.

    Para obter mais informações sobre como criar e editar filtros personalizados, consulte Definir filtros.

  5. Salve as alterações e publique os recursos. Para obter mais informações, consulte Publicar um recurso personalizado.

    O filtro é criado e agora pode ser selecionado em um novo critério de alerta de delivery.

  6. Vá para Administration > Channels > Delivery alerting, selecione Delivery alerting criteria e clique em Create.

  7. Na lista suspensa Delivery filter applied by this criterion, selecione o filtro que você acabou de criar.

    Você pode definir as configurações do seu critério da mesma forma que para 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 alerta de delivery.

Tópicos relacionados:

Adicionar ou estender um recurso

Parâmetros de alerta do delivery

Parâmetros de critérios

Na guia Criteria parameters de um painel de alerta delivery, é possível definir as configurações que se aplicam aos critérios selecionados nesse painel.

  • Delivery target minimum size: Por exemplo, se você digitar 100 nesse campo, uma notificação será enviada somente para delivery com um público alvo igual ou superior a 100 recipient. 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 delivery com data de contato neste 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 do contato, consulte Sobre o agendamento.

  • Maximum ratio of soft bounce errors: Uma notificação é enviada para todos os delivery com uma taxa de erro de rejeição suave 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 em modo suave, consulte Rejeitar qualificação de mensagens e Lista de tipos de falhas de delivery.

  • Maximum ratio of hard bounce errors: Uma notificação é enviada para todos os delivery com uma taxa de erro de rejeição em disco 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, consulte Rejeitar qualificação de mensagens e Lista de tipos de falhas de delivery.

  • Minimum time threshold for delivery in ‘Start pending’ status (in minutes): Uma notificação é enviada para todos os delivery com um Start pending status por mais tempo do que a duração especificada neste campo, Start pending status que significa que as mensagens ainda não foram levadas em conta pelo sistema.

  • Minimum time required for the computation of the throughput (in minutes): Somente delivery iniciados (com In progress status) por mais do que a duração especificada são considerados para o Deliveries with low throughput critério.

  • Maximum percentage of processed messages for the computation of the throughput: Somente delivery com uma porcentagem de mensagens processadas inferior à porcentagem especificada são considerados para o Deliveries with low throughput critério.

  • Minimum expected throughput (in sent messages per hour): Somente os delivery com um rendimento inferior ao valor especificado são considerados para o Deliveries with low throughput critério.

  • Minimum processed ratio required for ‘Deliveries in progress’ criterion: Somente delivery com uma porcentagem de mensagens processadas superior à porcentagem especificada são considerados.

Frequência de alerta

A opção Frequency of delivery alerting permite definir o atraso entre dois envios de alerta. Por padrão, é definido como 10 minutos.

É possível alterar essa configuração usando o menu Administration > Application settings > Options.

OBSERVAÇÃO

Essa opção se aplica a todos os painéis definidos no Adobe Campaign. Não é possível definir uma frequência específica para cada painel.

Delivery alertando motivos

O recurso de alerta de Delivery mantém todos os usuários envolvidos do Adobe Campaign informados automaticamente sobre o status de execução do delivery, por email e painel.

Agora, quando você recebe uma notificação de alerta de delivery, veja algumas dicas sobre o que você pode fazer.

Primeiro, verifique a guia delivery Log para visualização de todas as informações relacionadas ao delivery e 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 visualização do histórico de cada ocorrência de um delivery, selecione a guia Sending logs. Ele contém a lista de mensagens enviadas e seus status. Lá, você pode verificar o status de cada recipient ( Sent, Pending, Failed, etc.). Para obter mais informações, consulte Enviando 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 todos os delivery com um status incorreto. Pode ser devido a:

    • Um problema com o servidor de delivery (MTA, Agente de Transferência de Mensagens)
    • Tempo limite de conexão entre o servidor do delivery Adobe Campaign e o servidor receptor
    • Um problema de entrega
    • Um fluxo de trabalho incorreto

    Se o delivery for acionado com um fluxo de trabalho, verifique se ele foi iniciado corretamente. Para obter mais informações, consulte Executar 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 do delivery nos seguintes casos:

    • Falta um assunto ao delivery.
    • Há uma sintaxe incorreta nos campos de personalização.
    • O público alvo está faltando.
    • O delivery excede o limite de tamanho.

    Para obter mais informações, consulte Preparando o send. No entanto, esses erros geralmente são detectados 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 recipient está inativo.
    • A caixa de correio do recipient está cheia.

    Para obter mais informações, verifique as guias Exclusion logs e Exclusion causes dos logs do delivery. 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 à lista de bloqueios, o que significa que não deseja mais ser contatado.
    • O endereço de email do recipient não existe.
    • O domínio do recipient não existe.
    • O servidor do recipient está bloqueando o delivery.

    Para evitar erros de rejeição em modo suave e rígido, siga as práticas recomendadas abaixo:

    • Crie regras de tipologia de filtragem para excluir uma parte do público alvo de mensagens durante a análise do delivery, como recipient em quarentena. Consulte Criação de uma regra de filtragem.
    • Atualize regularmente o banco de dados do cliente para manter bons processos de gerenciamento de quarentenas. Consulte Sobre quarentenas.
    • Em geral, melhore o melhor possível a capacidade de entrega. Consulte a documentação detalhada do Adobe Campaign Deliverability e entre em contato com o administrador da Adobe Campaign para obter assistência.
  • Deliveries with long start pending: Normalmente, isso significa que há um problema no nível do MTA (Agente de transferência de mensagens). O processo de execução está aguardando a disponibilidade de alguns recursos. O MTA pode não ter sido iniciado.

    Deliveries with low throughput: Mais uma vez, este é um problema de entrega, o que significa que o MTA é muito lento.

    Para obter mais informações sobre esses problemas, entre em contato com o administrador da Adobe Campaign.

Tópicos relacionados:

Nesta página