Solução de problemas de ações de entrada na jornada troubleshooting-inbound-actions
Ações de entrada, como experiências no aplicativo, Web e baseadas em código, são componentes críticos do Journey Optimizer, pois permitem o engajamento personalizado com os usuários durante a jornada. No entanto, pode ocorrer um comportamento inesperado, como ausência de conteúdo de entrada ou entrega contínua após um perfil sair da jornada.
Este guia fornece um processo passo a passo para depurar problemas relacionados a ações de entrada em uma jornada, a fim de ajudar você a identificá-los e resolvê-los de forma independente antes de entrar em contato com o suporte do.
Pré-requisitos prerequisites
Antes de começar a solução de problemas, verifique o seguinte:
-
Configure uma sessão Assurance. Saiba mais na documentação do Adobe Experience Platform Assurance.
-
Navegue até a jornada que contém a ação de entrada para recuperar o nome da jornada e a ID da versão.
note note NOTE A ID da versão do jornada pode ser encontrada na URL após 'jornada/' (por exemplo: 86232fb1-2932-4036-8198-55dfec606fd7). 
-
Clique na ação de entrada para exibir seus detalhes. Recupere o rótulo e a ID da ação de entrada.
-
Obtenha o namespace e a ID do perfil para identificar o perfil que está encontrando problemas. Com base na sua configuração, o namespace pode ser ECID, email ou ID do cliente, por exemplo. Saiba como pesquisar um perfil na documentação do Experience Platform.
Cenário 1: o usuário não recebeu o conteúdo de entrada scenario-1
Nesse cenário, um perfil inseriu a ação de entrada na jornada, mas mesmo depois de 30 minutos, o conteúdo de entrada correspondente não é exibido no dispositivo/cliente na etapa de acionamento da configuração.
Pré-verificações pre-checks
-
O conjunto de dados de Entrada do Jornada está habilitado para assimilação de perfil
A ação de entrada usa o conjunto de dados Entrada de Jornada para as atualizações de perfil durante a execução. Verifique se o conjunto de dados está ativado para Perfis na sandbox atual. Saiba mais sobre conjuntos de dados
-
identidade 'joai' definida nas identidades da plataforma
A ação de entrada usa o namespace joai no perfil
segmentMembershippara ativar o perfil para a etapa de entrada. Verifique se ele foi definido nas Identidades da plataforma para a sandbox. Saiba mais sobre o Experience Platform Identity Service
Etapas de depuração debugging-steps
O gráfico abaixo mostra a sequência de etapas de depuração que você pode seguir:
Etapa 1: verifique se o dispositivo/cliente está recebendo o conteúdo do Edge Network step-1
Comece verificando se o dispositivo/cliente está obtendo o conteúdo esperado.
-
Vá para a sessão Assurance e selecione a seção Mensagens no Aplicativo no painel esquerdo.
-
Na guia Mensagens no Dispositivo, clique na lista suspensa Mensagens.
-
Procure uma mensagem com o nome da jornada seguido por "- Mensagem no aplicativo". Se presente, significa que a mensagem no aplicativo está presente no dispositivo/cliente e o problema pode estar relacionado ao acionador no aplicativo.
-
Se a mensagem não for encontrada, a mensagem no aplicativo não foi recebida pelo dispositivo/cliente.
Etapa 2: verifique se o Edge Network está retornando o conteúdo step-2
Essa etapa é para garantir que o Edge Network retorne o conteúdo de entrada esperado para ser renderizado no dispositivo/cliente.
Quando um perfil entra em uma ação de entrada em uma jornada, ele é automaticamente qualificado em um segmento de público-alvo especial (no namespace joai) correspondente à ação de jornada de entrada.
Quando um cliente faz uma solicitação à Edge Network para um determinado perfil e superfície, o perfil se qualifica para receber conteúdo para as ações de jornada de entrada direcionadas a essa superfície, somente se o perfil for um membro do segmento joai correspondente.
Para depurar o comportamento do Edge Network, siga as etapas abaixo.
-
Abra a exibição Edge Delivery na sessão do Assurance. Esta visualização fornece informações sobre a execução da ação de entrada no servidor do Edge Network. Saiba mais na documentação da Experience Platform.
-
Verifique se a atividade de Edge correspondente à ação de entrada está listada nas seções Atividades Qualificadas ou Atividades Não Qualificadas.
- Se estiver na seção Atividades qualificadas, o perfil se qualificará para a ação de jornada de entrada, e o conteúdo deverá ser retornado.
- Se estiver na seção Atividades não qualificadas, o perfil não se qualificou para a ação de jornada de entrada. Consulte os motivos de exclusão para obter mais detalhes.
- Se em nenhuma seção, houve um problema com a publicação da ação de jornada de entrada na Edge Network ou o URI de superfície solicitado não correspondeu às definições de configuração de canal da ação de entrada.
note note NOTE Para encontrar sua atividade do Edge na sessão Assurance, procure a atividade em que o audienceNamespace é joai e o audienceSegmentId é <JourneyVersionID>_<JourneyActionID> (por exemplo: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c). 
-
Se sua atividade estiver na seção Atividades Não Qualificadas e o motivo da exclusão for 'O segmento não está ativo', significa que o servidor de entrega do Edge Network não acha que o perfil faz parte do segmento de público-alvo joai relevante.
Você pode verificar novamente se o segmento joai está presente na exibição do perfil do servidor de entrega do Edge Network, abrindo o elemento segmentsMap da seção Perfil e procurando a presença da ID de segmento joai.
-
Se o servidor de entrega do Edge Network não exibir o perfil como estando no segmento joai relevante, vá para a próxima etapa.
Etapa 3: verifique se a associação de público-alvo "joai" se propagou para a Edge Network step-3
Esta etapa é para verificar se o perfil do Edge foi atualizado corretamente quando o perfil entrou na ação de jornada de entrada e o perfil foi qualificado no segmento joai correspondente.
Quando um perfil é qualificado em um segmento joai, ele é atualizado primeiro no Hub e, em seguida, a associação do segmento é projetada para o Perfil do Edge para uso pelo servidor de entrega do Edge Network.
Para verificar a presença do segmento joai no atributo segmentMembership do perfil do Edge, siga as etapas abaixo.
-
Navegue até o menu Cliente > Perfis no painel de navegação esquerdo Journey Optimizer e navegue até o perfil usando o namespace e a ID. Saiba mais sobre Perfis de clientes em tempo real
-
Selecione a guia Atributos e escolha a exibição Edge.
-
Clique em Exibir JSON para abrir a exibição JSON do perfil.
-
Vá para o atributo
segmentMembershipe verifique se a ID de segmento <JourneyVersionID>_<JourneyActionID> está presente no namespace joai e se no se realizou o status.
-
Se presente, o segmento joai correspondente à ação de jornada de entrada foi propagado corretamente para o perfil do Edge.
-
Se não for exibido na visualização do perfil do servidor de entrega do Edge Network, pode haver um problema com o modo como o servidor de entrega está carregando o perfil do Edge.
-
-
Se a ID de segmento joai não estiver presente ou estiver no estado encerrado, significa que ela (ainda) não foi propagada para o Edge.
Aguarde de 15 a 30 minutos para que os valores de
segmentMembershipsejam propagados do Hub para a Edge. Se ainda não estiver presente, vá para a próxima etapa.
Etapa 4: verifique se a associação de público-alvo "joai" está presente no perfil no Hub step-4
Esta etapa é para verificar se o perfil de Hub foi atualizado corretamente quando o perfil entrou na ação de jornada de entrada e o perfil foi qualificado no segmento joai correspondente.
Para verificar a presença do segmento joai no atributo segmentMembership do perfil de Hub, siga as etapas abaixo.
-
Navegue até o menu Cliente > Perfis no painel de navegação esquerdo Journey Optimizer e navegue até o perfil usando o namespace e a ID. Saiba mais sobre Perfis de clientes em tempo real
-
Selecione a guia Atributos e escolha a exibição Hub.
-
Clique em Exibir JSON para abrir a exibição JSON do perfil.
-
Vá para o atributo segmentMembership e verifique se a ID do segmento <JourneyVersionID>_<JourneyActionID> está presente no namespace joai e se está no status realizado .
-
Se presente, o segmento joai correspondente à ação de jornada de entrada foi assimilado corretamente no perfil de Hub.
-
Se não for encontrado no perfil do Edge após pelo menos 30 minutos, talvez haja um problema com o sistema de projeção do Edge.
-
-
Se a ID de segmento joai não estiver presente ou estiver no estado encerrado, significa que o perfil (ainda) não foi qualificado corretamente no segmento de público-alvo joai especial ao entrar na ação de jornada de entrada correspondente.
Aguarde de 15 a 30 minutos para que os valores
segmentMembershipsejam assimilados no perfil no Hub. Se ainda não estiver presente, vá para a próxima etapa.
Etapa 5: se o cliente/dispositivo ainda não estiver obtendo o conteúdo esperado step-5
Se você tiver passado por todas as etapas acima e não estiver vendo o comportamento esperado após esperar de 30 a 60 minutos pela propagação da associação do segmento para a Edge Network, entre em contato com o Atendimento ao cliente da Adobe ou com seu representante da Adobe.
Inclua o máximo de detalhes possível das etapas de depuração, como:
- a etapa em que você vê o comportamento inesperado;
- a ID da versão do jornada;
- a ID da ação de jornada;
- o rastreamento completo do Assurance;
- a visualização JSON do perfil do Edge;
- a visualização JSON do perfil do Hub;
- etc.
Cenário 2: o usuário ainda está recebendo o conteúdo de entrada scenario-2
Este cenário é o inverso do Cenário 1: o perfil saiu da jornada, mas o usuário ainda está recebendo o conteúdo de entrada.
No entanto, quando um perfil sai de uma jornada, ele não deve mais se qualificar para os segmentos de público-alvo joai correspondentes às ações de entrada na jornada.
Siga as mesmas etapas de depuração do Cenário 1 para verificar se o perfil do Hub, o perfil do Edge e o servidor de entrega do Edge Network refletem corretamente o status de associação do segmento relevante joai e se o cliente não está mais recebendo o conteúdo de entrada.