DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Solucionar problemas de execução de jornada em tempo real troubleshooting-execution

Last update: Tue Nov 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Journey Orchestration
  • Tópicos:

Criado para:

  • Intermediário
  • Usuário

Nesta seção, saiba como solucionar problemas de eventos de jornada, verificar se os perfis inseriram sua jornada, como eles navegam por ela e se as mensagens são enviadas.

Você também pode solucionar problemas de erros antes de testar ou publicar uma jornada. Saiba mais sobre nesta página.

Se você estiver usando ações de entrada, saiba como solucionar problemas deles nesta página.

Verifique se os eventos foram enviados corretamente checking-that-events-are-properly-sent

O ponto de partida de uma jornada é sempre um evento. Você pode fazer testes usando ferramentas como o Postman.

Você pode verificar se a chamada à API enviada por meio dessas ferramentas foi corretamente enviada. Se ocorrer um erro, significa que a chamada tem um problema. Verifique novamente o payload, o cabeçalho (e principalmente a ID da organização) e o URL de destino. Você pode perguntar ao administrador qual é o URL correto para a ocorrência.

Eventos não são levados diretamente da origem para jornadas. Na verdade, o jornada depende das APIs de assimilação de streaming do Adobe Experience Platform. Como resultado, no caso de problemas relacionados ao evento, consulte a documentação do Adobe Experience Platform para obter a solução de problemas de APIs de assimilação de streaming.

Se a jornada não conseguir habilitar o modo de teste com erro ERR_MODEL_RULES_16, verifique se o evento usado inclui um namespace de identidade ao usar uma ação de canal.

O namespace de identidade é usado para identificar exclusivamente os perfis de teste. Por exemplo, se o email for usado para identificar os perfis de teste, o namespace de identidade Email deverá ser selecionado. Se o identificador exclusivo for o número de telefone, o namespace de identidade Telefone deverá ser selecionado.

Verificar se as pessoas entram na jornada checking-if-people-enter-the-journey

O relatório de Jornada mede a entrada das pessoas em uma jornada em tempo real.

Se você enviar o evento com êxito, mas não vir nenhuma entrada na jornada, significa que há algo de errado entre o envio do evento e a recepção do evento na jornada.

Você pode começar a solucionar problemas com as perguntas abaixo:

  • Você tem certeza de que a jornada em que você espera o evento de entrada está no modo de teste ou ativa?

  • Você salvou o evento antes de copiar o payload da pré-visualização de payload?

  • O payload do evento contém uma ID do evento?

  • Você digitou o URL correto?

  • Você seguiu a estrutura de payload das APIs de ingestão de transmissão usando a pré-visualização da estrutura de payload no painel de configuração do evento? Consulte esta página.

  • Você usou os pares de valor chave corretos no cabeçalho do evento?

    code language-none 
    X-gw-ims-org-id - your organization's ID
Content-type - application/json

Verificar como as pessoas navegam pela jornada checking-how-people-navigate-through-the-journey

O relatório de jornada mede o progresso das pessoas físicas dentro de uma jornada. É fácil identificar onde e por que uma pessoa foi parada.

Veja algumas coisas que devem ser verificadas:

  • A interrupção se deve a uma condição que exclui a pessoa? Por exemplo, a condição é "gênero = homem" e a pessoa é uma mulher. Essa verificação pode ser feita por um usuário empresarial se a condição não for muito complexa.
  • A interrupção se deve a uma chamada a uma fonte de dados que não está respondendo? Quando a jornada está em teste, essas informações podem ser vistas nos registros do modo de teste. Quando a jornada é em tempo real, um administrador pode testar chamadas diretas para a fonte de dados e verificar a resposta recebida. Um administrador também pode duplicar a jornada e testá-la.

Verificar se as mensagens foram enviadas com êxito checking-that-messages-are-sent-successfully

Se as pessoas físicas continuarem percorrendo o caminho certo na jornada, mas não receberem as mensagens esperadas, você poderá verificar se:

  • Journey Optimizer levou em consideração corretamente a solicitação para enviar a mensagem. Os usuários empresariais podem acessar a mensagem que deve ser enviada e verificar se a hora da execução mais recente corresponde ao tempo de execução da sua jornada. Eles também podem verificar as chamadas/eventos de API mais recentes recebidos.
  • Journey Optimizer enviou a mensagem com êxito. Verifique os relatórios do jornada para garantir que não haja erros.

No caso de uma mensagem enviada por meio de uma ação personalizada, a única coisa que pode ser verificada durante o teste de jornada é o fato de a chamada do sistema da ação personalizada causar ou não um erro. Se a chamada para o sistema externo associada à ação personalizada não causar um erro, mas não enviar a mensagem, algumas investigações devem ser feitas por parte do sistema externo.

Noções básicas sobre entradas duplicadas em Eventos de etapa de Jornada duplicate-step-events

Por que vejo várias entradas com a mesma instância, perfil, nó e IDs de solicitação do jornada?

Ao consultar os dados de Eventos de etapa de Jornada, você pode observar ocasionalmente o que parece ser entradas de log duplicadas para a mesma execução de jornada. Essas entradas compartilham valores idênticos para:

  • profileID - A identidade do perfil
  • instanceID - O identificador de instância do jornada
  • nodeID - O nó de jornada específico
  • requestID - O identificador da solicitação

No entanto, essas entradas têm valores _id diferentes, que é o indicador principal que distingue este cenário da duplicação de dados real.

O que causa esse comportamento?

Isso ocorre devido às operações de dimensionamento automático de back-end (também chamadas de "rebalanceamento") na arquitetura de microsserviços da Adobe Journey Optimizer. Durante períodos de alta carga ou otimização do sistema:

  1. Um evento de etapa de jornada começa a ser processado e é registrado no conjunto de dados de Eventos de etapa de Jornada
  2. Uma operação de dimensionamento automático redistribui a carga de trabalho entre instâncias de serviço
  3. O mesmo evento pode ser reprocessado por outra instância de serviço, criando uma segunda entrada de log com um _id diferente

Este é um comportamento de sistema esperado e está funcionando como projetado.

Há algum impacto na execução da jornada ou na entrega de mensagens?

Não. O impacto está limitado apenas ao registro em log. A Adobe Journey Optimizer tem mecanismos integrados de desduplicação na camada de execução de mensagens que garantem:

  • Somente uma mensagem (email, SMS, notificação por push etc.) é enviada para cada perfil
  • As ações são executadas apenas uma vez
  • A execução da jornada continua corretamente

Você pode verificar isso consultando o ajo_message_feedback_event_dataset ou verificando os logs de execução da ação. Você verá que apenas uma mensagem foi realmente enviada, apesar das entradas de evento de etapa de jornada duplicadas.

Como posso identificar esses casos em minhas consultas?

Ao analisar os dados de Eventos de etapa do Jornada:

  1. Verifique o campo _id: duplicatas reais no nível do sistema teriam o mesmo _id. Valores _id diferentes indicam entradas de log separadas do cenário de rebalanceamento descrito acima.

  2. Verificar entrega de mensagem: cruzar referência com dados de feedback da mensagem para confirmar se apenas uma mensagem foi enviada:

    code language-sql 
    SELECT
  timestamp,
  _experience.customerJourneyManagement.messageExecution.messageExecutionID,
  _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus
FROM ajo_message_feedback_event_dataset
WHERE
  _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>'
  AND TO_JSON(identityMap) like '%<profileID>%'
ORDER BY timestamp DESC;

  3. Agrupar por identificadores exclusivos: ao contar execuções, use _id para obter contagens precisas:

    code language-sql 
    SELECT
  COUNT(DISTINCT _id) as unique_executions
FROM journey_step_events
WHERE
  _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>'
  AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'

O que devo fazer se eu observar isso?

Este é um comportamento normal do sistema e nenhuma ação é necessária. O registro em log duplicado não indica um problema com a configuração da jornada ou com o delivery da mensagem.

Se você estiver criando relatórios ou análises com base nos Eventos de etapa do Jornada:

  • Use _id como chave primária para contar eventos únicos
  • Referência cruzada com conjuntos de dados de feedback de mensagem ao analisar a entrega de mensagens
  • Esteja ciente de que a análise de tempo pode mostrar entradas agrupadas em poucos segundos

Para obter mais informações sobre a consulta de Eventos de Etapa de Jornada, consulte Exemplos de consultas.

Solução de problemas de discrepâncias de métricas do painel dashboard-metrics

Se as métricas exibidas no painel Visão geral não corresponderem ao número real de jornadas na guia Procurar, verifique o seguinte:

  • Verifique se as jornadas em questão tiveram tráfego nas últimas 24 horas, pois as jornadas sem atividade recente são excluídas do painel.
  • Verifique se você tem as permissões de acesso apropriadas para exibir todas as jornadas na organização.
  • Aguarde até 30 minutos para que as métricas sejam atualizadas depois de fazer alterações nas jornadas.

Se as discrepâncias persistirem, entre em contato com o Suporte da Adobe com capturas de tela das guias Visão geral e Procurar para investigação.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76