Show Menu
TÓPICOS×

Solução de problemas

Nesta seção, você descobrirá como solucionar problemas de jornadas antes de testar ou publicar. Todos os controles enumerados a seguir podem ser efetuados quando a jornada estiver em modo de teste ou mesmo ativa. Recomenda-se que todas as verificações a seguir sejam feitas no modo de teste, para então prosseguir com a publicação. Consulte Testar a jornada .

Verificação de erros antes do teste

Antes de testar e publicar sua jornada, verifique se todas as atividades estão configuradas corretamente. Não é possível executar testes ou publicações se os erros ainda forem detectados pelo sistema.
Os erros são exibidos com um símbolo de aviso na tela. Coloque o cursor no ponto de exclamação para exibir a mensagem de erro. Se você clicar na atividade, verá a linha que contém o erro com um aviso. Por exemplo, se um campo obrigatório estiver vazio, um erro será exibido.
Por exemplo, caso duas atividades estejam desconectadas na tela, um aviso é exibido.
Um sinal de aviso pode ser exibido próximo aos botões Test e Publish . Este sinal de aviso mostra erros detectados pelo sistema e impede a ativação do modo de teste ou a publicação da jornada. Na maioria das vezes, os erros detectados pelo sistema estão vinculados aos erros visíveis nas atividades, mas às vezes estão vinculados a outros problemas. Nesse caso, você pode exibi-los e tentar identificar o problema usando a descrição do erro. Se não conseguir identificar o problema, você pode copiar os detalhes e enviá-los ao administrador ou ao suporte. Observe que os erros que bloqueiam o teste e os erros que bloqueiam a publicação são semelhantes.
O sistema detecta dois tipos de problemas: erros e avisos. Os erros bloqueiam a publicação e a ativação de teste. Os avisos indicam possíveis problemas que não estão bloqueando a ativação de teste ou a publicação. Você verá uma descrição do problema e uma ID de registro de problemas do tipo ERR_XXX_XXX. Essas informações ajudarão o suporte técnico a identificar o problema.
Duas cores diferentes podem ser exibidas no sinal próximo aos botões Test e Publish . Em caso de erro, o sinal é exibido em vermelho. Em caso de aviso, é exibido em laranja.
Erros e avisos globais para a jornada aparecem primeiro na lista. Os erros e avisos relacionados a atividades específicas são listados depois, por ordem de atividade ou aparência na jornada, da esquerda para a direita. O botão Copy details copia informações técnicas sobre a jornada que a equipe de suporte pode usar para a solução de problemas.
Quando ocorre um erro em uma ação ou condição, a jornada de um indivíduo para. A única maneira de continuar é marcar a caixa Add an alternative path in case of a timeout or an error . Consulte O uso de caminhos na tela .

Verificação do envio correto dos eventos

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 ao Journey Orchestration. Indeed, Journey Orchestration relies on Adobe Experience Platform’s streaming ingestion APIs. Como resultado, no caso de problemas relacionados ao evento, consulte esta página para obter a solução de problemas de APIs de assimilação de streaming.

Verificação da entrada de pessoas na jornada

O relatório do Journey Orchestration mede a entrada das pessoas em uma jornada em tempo real.
Se você enviar o evento com sucesso, 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.
Veja alguns itens que o administrador deve verificar:
  • 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 assimilação de streaming usando a pré-visualização da estrutura de payload no painel de configuração do evento? Consulte Visualizar a carga .
  • Você usou os pares de chave/valor corretos no cabeçalho do evento?
    X-gw-ims-org-id - your ORGID
    Content-type - application/json
    
    

Verificação de como as pessoas navegam pela jornada

O relatório do Journey Orchestration 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.

Verificação de mensagens enviadas com êxito

Se as pessoas físicas continuarem percorrendo o caminho certo na jornada, mas não receberem as mensagens esperadas, você pode verificar se:
  • As mensagens transacionais levaram em conta corretamente a solicitação para enviar a mensagem. Um usuário comercial pode acessar a mensagem transacional que deve ser enviada e verificar se a hora da execução mais recente corresponde ao tempo de execução da sua jornada. Ele também pode verificar as chamadas/eventos de API mais recentes recebidos por mensagens transacionais.
  • As mensagens transacionais enviaram a mensagem com êxito. Você pode ver o status de cada execução nos registros de envio da mensagem transacional. Se é verde, vermelho e qual o problema. Um usuário empresarial pode acessar essa tela e enviar os registros a um administrador para fazer mais investigações.
No caso de mensagem enviada através de ação personalizada, a única coisa a ser verificada durante o teste da 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 também não enviar a mensagem, algumas investigações devem ser feitas por parte do sistema externo.