Nesta página: Aprenda a depurar e resolver problemas comuns com ações de entrada (como experiências no aplicativo, na Web e baseadas em código) em uma jornada antes de entrar em contato com o suporte.
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 Adobe Experience Platform documentação do 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 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: 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.
-
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 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 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.
-
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.
Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.
Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.
- TL;DR: esta página fornece um guia de depuração de autoatendimento passo a passo para dois cenários de ação de entrada no Adobe Journey Optimizer jornada: um perfil entrando em uma etapa de entrada, mas não recebendo o conteúdo, e um perfil que continua recebendo conteúdo depois de sair da jornada.
Intenções:
- Configure uma sessão do Assurance como pré-requisito antes de depurar problemas de ação de entrada
- Verifique se o dispositivo ou cliente está recebendo conteúdo de entrada da Edge Network usando o Assurance
- Verifique as atividades qualificadas e não qualificadas do Edge Network para determinar se um perfil está qualificado para uma ação de jornada de entrada
- Confirme se a associação do segmento de público-alvo joai se propagou do perfil do Hub para o perfil do Edge
- Diagnosticar atrasos na assimilação de segmentos de joia no perfil de Hub depois que um perfil insere uma ação de entrada
- Entre em contato com o Atendimento ao cliente da Adobe com as informações de diagnóstico corretas quando as etapas de autoatendimento não resolverem o problema
Glossário:
- Ações de entrada: atividades de Jornada que fornecem conteúdo personalizado para o dispositivo ou navegador de um usuário, incluindo os canais de experiência no aplicativo, na Web e baseados em código (específico do produto)
- namespace de jornada: um namespace de identidade especial usado no perfil
segmentMembershippara ativar um perfil para uma etapa de ação de entrada (específico do produto) - segmento joai: um segmento de público-alvo criado automaticamente no namespace joai correspondente a uma ação de jornada de entrada específica; o perfil deve estar em um estado realizado neste segmento para receber o conteúdo (específico do produto)
- Conjunto de dados de Entrada do Jornada: o conjunto de dados do AEP usado para armazenar atualizações de perfil feitas quando um perfil insere uma ação de jornada de entrada (específico do produto)
- Perfil de hub: o repositório de perfis central no Adobe Experience Platform usado como fonte da verdade para atributos de perfil e associação de segmento
- Perfil do Edge: a cópia projetada do perfil de Hub usada pelo servidor de entrega do Edge Network para avaliar a qualificação de conteúdo em tempo real
- Assurance: uma ferramenta do Adobe Experience Platform para depuração em tempo real do comportamento do SDK no lado do cliente e respostas do Edge Network
Medidas de Proteção:
- O conjunto de dados de Entrada do Jornada deve ser ativado para assimilação de perfis na sandbox atual antes que as ações de entrada funcionem corretamente
- O namespace joai deve ser definido em Identidades da plataforma para a sandbox
- A propagação da associação do segmento joai do Hub para o Edge pode levar de 15 a 30 minutos
- A assimilação de associação de segmento joai no perfil de Hub pode levar de 15 a 30 minutos depois que o perfil entra na ação de entrada
- Se o conteúdo ainda estiver ausente após 30-60 minutos, encaminhe para o Atendimento ao cliente da Adobe com ID de versão do jornada, ID de ação, rastreamento do Assurance e exibições JSON de perfil do Edge e Hub
Terminologia:
- Nome canônico: namespace joai — Acrônimo: joai — variantes: identidade joai, namespace de segmento joai
- Nome canônico: Ações de entrada — Acrônimo: none — variantes: canais de entrada, conteúdo de entrada
- Sinônimos: “Perfil de hub” = “perfil central” (AEP); “Perfil do Edge” = “perfil projetado” (usado pelo Edge Network)
- Não confunda: “Atividades qualificadas” ≠ “Atividades não qualificadas” na visualização Edge Delivery — qualificado significa que o perfil recebeu conteúdo; não qualificado significa que não recebeu, com uma razão de exclusão mostrada
Perguntas frequentes:
- P: Quais são os dois cenários de falha de ação de entrada principais abordados por este guia? — Cenário 1: um perfil entrou na etapa de entrada, mas o usuário nunca vê o conteúdo. Cenário 2: um perfil saiu da jornada, mas o usuário ainda recebe o conteúdo de entrada.
- P: Qual ferramenta devo usar para depurar a entrega de ações de entrada? — Adobe Experience Platform Assurance. Primeiro, configure uma sessão do Assurance e, em seguida, use as exibições de Mensagens no aplicativo e Edge Delivery para inspecionar a entrega de conteúdo e as respostas do Edge Network.
- P: Qual é o segmento joai e por que ele é importante? — Quando um perfil entra em uma ação de entrada, ele é automaticamente qualificado em um segmento de público-alvo conjunto com escopo para essa ação específica. O Edge Network só entrega o conteúdo de entrada se o perfil estiver em um estado realizado nesse segmento joai.
- P: Quanto tempo leva para que a associação ao segmento joai apareça no perfil do Edge? — Até 15-30 minutos para propagação do Hub para o Edge depois que o perfil do Hub for atualizado.
- P: O que devo fazer se a ID do segmento de joai estiver em um estado encerrado no perfil do Edge? — O perfil saiu do segmento joai, o que significa que ele saiu da ação de jornada de entrada. Se isso for inesperado, rastreie pela assimilação de perfil de hub e verifique se o perfil entrou corretamente na etapa de ação de entrada.
- P: Quais informações devo fornecer ao encaminhar para o Atendimento ao cliente da Adobe? — A ID da versão do jornada, a ID da ação do jornada, a etapa em que ocorre um comportamento inesperado, o rastreamento completo do Assurance e as visualizações JSON dos perfis do Edge e do Hub.