Solução de problemas de ações de entrada na jornada troubleshooting-inbound-actions
Inbound actions, such as In-app, web, and code-based experiences, are critical components of Journey Optimizer as they enable personalized engagement with users during their journey. However, unexpected behavior, such as missing inbound content, or continued delivery after a profile exits the journey, can occur.
This guide provides a step-by-step process to debug issues related to inbound actions in a journey, in order to help you identify and resolve them independently before reaching out to support.
Pré-requisitos prerequisites
Before you can start troubleshooting, ensure the following:
-
Set up an Assurance session. Learn how in the Adobe Experience Platform Assurance documentation.
-
Navigate to the journey containing the inbound action to retrieve the journey name and version ID.
note NOTE The journey version ID can be found in the URL after 'journey/' (for example: 86232fb1-2932-4036-8198-55dfec606fd7).
-
Click the inbound action to view its details. Retrieve the inbound action label and ID.
-
Get the profile namespace and ID to identify the profile encountering issues. Based on your configuration, the namespace can be ECID, email, or customer ID for example. Learn how to look up a profile in the Experience Platform documentation.
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: verificar se o dispositivo/cliente está recebendo o conteúdo da rede de borda 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.
{width="80%"}
-
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: verificar se a rede de borda 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 Para encontrar sua atividade do Edge na sessão Assurance, procure a atividade em que audienceNamespace é joai e o audienceSegmentId é <JourneyVersionID>_<JourneyActionID> (por exemplo: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c). {width="70%"}
-
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 rede de borda 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.
{width="80%"}
-
Vá para o atributo
segmentMembershipe verifique se a ID de segmento <JourneyVersionID>_<JourneyActionID> está presente no namespace joai e se está no status realizado . {width="90%"}
-
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.