Monitorar canais personalizados monitor-custom-channel

Nesta página: saiba como gerenciar o ciclo de vida de seus canais personalizados e monitorar o desempenho da entrega por meio dos relatórios prontos para uso da Adobe Journey Optimizer, incluindo métricas como entregas bem-sucedidas, erros e cliques em links.

Depois que um canal personalizado é criado e ativado, você pode gerenciar seu ciclo de vida e monitorar o desempenho da entrega por meio da interface Journey Optimizer.

Aproveitar os relatórios de campanha e jornada reporting

O Journey Optimizer fornece relatórios prontos para uso para canais personalizados.

O relatório Campanha de canal personalizado está detalhado em esta seção.

As métricas a seguir estão disponíveis para canais personalizados em relatórios ao vivo (24 horas) e global (CJA).

Métrica
Descrição
Tentativas de entrega
Número total de mensagens enviadas para o ponto de extremidade externo.
Entregas bem-sucedidas
Mensagens para as quais o ponto de extremidade retornou uma resposta HTTP 2xx.
Perfis direcionados
Número de perfis únicos atingidos.
Cliques
Número de cliques em links rastreados na carga. Requer um subdomínio delegado para canais personalizados.
Erros/Falhas
Número de tentativas de entrega com falha, com detalhamento por motivo de erro.

Saiba mais sobre relatórios ao vivo e relatórios globais. Para obter detalhes sobre as funcionalidades de relatórios, consulte esta documentação.

Monitorar desempenho da entrega monitoring

Além dos relatórios de campanha e jornada, o Journey Optimizer fornece um painel de monitoramento de canal personalizado dedicado. Acesse-o em Administração > Canais > Construtor de Canais > Monitoramento de canais personalizados.

Painel de monitoramento de canal personalizado {width="100%"}

Este painel permite monitorar a confiabilidade e o desempenho das chamadas de API que Journey Optimizer faz aos seus pontos de extremidade externos ao entregar mensagens de canal personalizadas. Use-o para detectar rapidamente problemas de integração, latência e limites de limitação.

O painel Monitoramento de canais personalizados funciona como outros relatórios de todos os tempos em Journey Optimizer. Você pode selecionar um intervalo de tempo, filtrar por canal ou endpoint e detalhar para ver as campanhas e jornadas que dependem de cada canal personalizado. Saiba mais

Métricas de canal personalizadas monitoring-kpis

A seção Métricas de canal personalizadas fornece uma exibição consolidada da integridade operacional e da confiabilidade das suas chamadas de canal personalizadas.

Métricas de canal personalizadas {width="100%"}

Saiba mais sobre métricas de canal personalizadas
  • Chamadas com êxito: número total de chamadas HTTP que retornaram uma resposta válida sem erro.

  • 4xx/5xx errors: número de chamadas com falha devido a erros do lado do cliente (4xx) ou do lado do servidor (5xx), destacando problemas de configuração ou falhas de ponto de extremidade.

  • Chamadas de tempo limite: número de chamadas que falharam porque excederam o tempo máximo de resposta. Isso ajuda a exibir problemas de latência ou desempenho com pontos de extremidade externos.

  • Falhas de pré-chamada: Número de envios de canais personalizados que falharam antes da chamada HTTP ter sido feita ao ponto de extremidade externo. Essas falhas ocorrem na própria camada de infraestrutura do Journey Optimizer, não no seu sistema externo. Existem três categorias:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Categoria Descrição
    Falhas de autenticação (AUTH_*) Journey Optimizer não pôde obter ou atualizar o token OAuth ou as credenciais necessárias para chamar o ponto de extremidade. Verifique se as credenciais de API vinculadas à configuração do canal são válidas e se não expiraram.
    Solicitar erros de geração (REQUEST_GENERATION_ERROR) Journey Optimizer não pôde construir uma solicitação HTTP válida — por exemplo, porque um modelo de URL não pôde ser resolvido ou um campo de personalização obrigatório estava ausente.
    Erros de análise de HTTP (HTTP_PARSE_ERROR) Journey Optimizer recebeu uma resposta do ponto de extremidade, mas não pôde analisá-la em uma estrutura utilizável.
    note tip
    TIP
    As falhas antes da chamada indicam um problema no lado do Journey Optimizer ou na configuração do canal, em vez de um problema com o ponto de extremidade externo. Comece a solução de problemas revisando as credenciais da API e os campos de carga necessários.
  • Latência média: tempo médio de resposta de ponta a ponta (em milissegundos) para todas as chamadas HTTP, incluindo chamadas bem-sucedidas, erros e tempos limite.

Resultados dos canais personalizados ao longo do tempo outcomes-overtime

Resultados do canal personalizado ao longo do tempo {width="100%"}

O gráfico Resultados dos canais personalizados ao longo do tempo mostra a tendência do KPI de chamadas HTTP ao longo do período selecionado. A granularidade da série temporal depende do intervalo de tempo selecionado:

  • Para um relatório de 7 dias, cada ponto de dados mostra os KPIs para um dia.
  • Para um intervalo de tempo de 1 dia, o gráfico mostra os KPIs por hora.
  • Para um intervalo de tempo de 1 hora, o gráfico mostra os KPIs por minuto.

Latência ao longo do tempo latency-overtime

Latência de canal personalizada ao longo do tempo {width="100%"}

O gráfico Latência ao longo do tempo visualiza a tendência das métricas de latência ao longo do período selecionado. Essa visualização de série temporal permite rastrear padrões de desempenho, identificar períodos de latência de pico e monitorar o impacto de otimizações ou alterações do sistema ao longo do tempo.

Detalhamento do resultado do canal personalizado outcome-breakdown

Detalhamento personalizado do resultado do canal {width="100%"}

A tabela Detalhamento personalizado dos resultados do canal fornece um detalhamento hierárquico das métricas de chamada HTTP — desde as métricas gerais por ponto de extremidade no nível superior até as métricas por canal personalizado usando esse ponto de extremidade, passando pelas campanhas e jornadas que dependem delas no nível inferior.

Detalhamento de latência latency-breakdown

A tabela Detalhamento de latência fornece um detalhamento das métricas de latência em seus canais personalizados. Essa visualização ajuda a identificar quais endpoints ou canais específicos estão tendo problemas de desempenho, permitindo que você identifique e resolva gargalos de latência de maneira eficaz.

Insight Builder insight-builder

Use o Insight Builder para criar visualizações e painéis personalizados com base nas métricas de canal personalizadas. Essa ferramenta permite combinar vários KPIs, aplicar filtros e criar exibições personalizadas que se alinhem às suas necessidades de monitoramento e relatórios. Saiba mais

Solução de problemas troubleshooting

Se você encontrar problemas com seu canal personalizado, a tabela a seguir lista sintomas comuns, possíveis causas e resoluções recomendadas.

Sintoma
Causa possível
Resolução
HTTP 401 / 403 erros
Falha de autenticação — credenciais expiradas ou incorretas.
Atualize as credenciais em Administração > Canais > Credenciais de API.
HTTP 429 erros
O ponto de extremidade externo está limitando as solicitações de Journey Optimizer.
Revise os limites de taxa do seu ponto de extremidade. Reduza a configuração de limitação na configuração de política do Channel Builder.
HTTP 5xx errors
O sistema externo está inativo ou retorna erros do servidor.
Verifique o painel de integridade do sistema externo. Configure caminhos de erro na atividade de ação de jornada para lidar com falhas transitórias normalmente.
Tokens de personalização não resolvidos
A expressão faz referência a um atributo que não está presente no perfil.
Verifique se o caminho do atributo XDM está correto. Adicionar um valor padrão de fallback: {{profile.person.name.firstName | default("Valued Customer")}}.
Erro de validação de campo obrigatório
Um campo de conteúdo obrigatório não tem valor no momento da criação.
Verifique se todos os campos obrigatórios estão preenchidos no editor de conteúdo. Como alternativa, remova a restrição necessária no Construtor de canais se o campo for realmente opcional.
recommendation-more-help
journey-optimizer-help