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:

  1. Set up an Assurance session. Learn how in the Adobe Experience Platform Assurance documentation.

  2. 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).

    Journey ID location in journey URL or properties panel

  3. Click the inbound action to view its details. Retrieve the inbound action label and ID.

    Action ID in activity configuration panel code view

  4. 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

  1. 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

  2. identidade ‘joai’ definida nas identidades da plataforma

    A ação de entrada usa o namespace joai no perfil segmentMembership para 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:

Fluxo de trabalho de solução de problemas para mensagem de entrada não sendo exibida: verifique a jornada, a entrega de borda e o perfil {align="center" width="70%"}

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.

Canal no aplicativo
  1. Vá para a sessão Assurance e selecione a seção Mensagens no Aplicativo no painel esquerdo.

  2. Na guia Mensagens no Dispositivo, clique na lista suspensa Mensagens.

    Exibição do Adobe Assurance mostrando eventos e dados de entrega de mensagens no aplicativo {width="80%"}

  3. 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.

  4. Se a mensagem não for encontrada, a mensagem no aplicativo não foi recebida pelo dispositivo/cliente.

Canal da Web
Visite a página e inspecione a guia de rede, ou verifique a carga de resposta do Edge na seção Edge Delivery da sessão Assurance.
Canal de experiência baseado em código
Execute uma solicitação de curl usando a API do Adobe e verifique a carga de resposta do Edge na seção Edge Delivery da sessão Assurance.

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.

  1. 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.

  2. Verifique se a atividade de Edge correspondente à ação de entrada está listada nas seções Atividades Qualificadas ou Atividades Não Qualificadas.

    Logs de entrega do Edge mostrando apresentações de mensagem enviadas ao perfil

    • 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).

    Erro de entrega do Edge mostrando que o perfil não se qualificou para a mensagem {width="70%"}

  3. 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.

  4. 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.

NOTE
A propagação do Hub para o Edge pode levar de 15 a 30 minutos a partir do momento em que o perfil é atualizado no Hub.

Para verificar a presença do segmento joai no atributo segmentMembership do perfil do Edge, siga as etapas abaixo.

  1. 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

  2. Selecione a guia Atributos e escolha a exibição Edge.

  3. Clique em Exibir JSON para abrir a exibição JSON do perfil.

    Exibição dos atributos de perfil em formato JSON mostrando o status de associação do público-alvo {width="80%"}

  4. Vá para o atributo segmentMembership e verifique se a ID de segmento <JourneyVersionID>_<JourneyActionID> está presente no namespace joai e se está no status realizado .

    Perfil JSON mostrando associação realizada de público-alvo com carimbo de data/hora {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.

  5. 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 segmentMembership sejam 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.

NOTE
A assimilação da associação de segmento joai no perfil de Hub pode levar de 15 a 30 minutos a partir do momento em que o perfil entrou na ação de jornada de entrada.

Para verificar a presença do segmento joai no atributo segmentMembership do perfil de Hub, siga as etapas abaixo.

  1. 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

  2. Selecione a guia Atributos e escolha a exibição Hub.

  3. Clique em Exibir JSON para abrir a exibição JSON do perfil.

  4. 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.

  5. 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 segmentMembership sejam 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.

recommendation-more-help
journey-optimizer-help