Visão geral

O Troubleshooter permite inspecionar todos os detalhes do seu conteúdo na UserGuiding e identificar rapidamente a raiz de um problema para que você possa fazer com que as coisas voltem a funcionar rapidamente.

Se não conseguir ver um Guia ou um Hotspot que publicou na página de destino, abra o Troubleshooter para ele e analise todas as variáveis de configuração que o conteúdo tem para detectar a origem do problema.

Importante: se não for possível abrir e executar o Troubleshooter em uma página, isso significa que a UserGuiding não está instalada na página. Esse é o motivo mais provável pelo qual você não consegue ver seu conteúdo publicado. Saiba mais aqui.

Abrindo o Troubleshooter a partir do painel

1. Abra o Troubleshooter visitando a página de configurações de Guias, Hotspots, Checklists e Pesquisas.
2. O Content Status deve estar ativo e a instalação deve estar concluída para que seu ícone seja exibido.
3. Clique no ícone do Troubleshooter para abri-lo na URL de redirecionamento (inicial) do conteúdo atual (ex.: Guide ID: 25937).

Ao seguir esse método, o Troubleshooter será aberto, mostrando os detalhes do conteúdo. Talvez seja necessário rolar a tela para baixo para ver essa seção específica.

Importante: Se estiver na página de configurações de Pesquisas ou Checklist, como não há URL de redirecionamento (inicial) para entrar, é necessário digitar a URL da página da Web em que deseja executar o Troubleshooter.

Abrir o Troubleshooter a partir da extensão do Chrome

Se estiver em uma URL em que seus Guias ou Hotspots devem ser exibidos, você já fez o download da extensão do Chrome e incorporou com êxito o código do container; clique com o botão direito do mouse no ícone da extensão UserGuiding para o Chrome e clique em Run Troubleshooter on this page.

Como o Troubleshooter funciona

Há seis seções principais no Troubleshooter, começando pelas Informações do container. Se a seção estiver mostrando um ícone de sinal de mais [➕], você poderá clicar nela para revelar as subseções. Quando a seção principal for aberta, seu ícone será um sinal de menos [➖].

Informações sobre containers

Aqui, você pode encontrar detalhes sobre o código JS programado na página atual.

• Container Embed Status: Espera-se que seja exibido ✅.
• Container Name: Nome do código JS na página atual.
• Last Update Date: Data e hora em que você clicou pela última vez no botão Publish Changes.

Dica💡: Se você não conseguir ver as últimas alterações feitas em um Guia ou em outro conteúdo, certifique-se de clicar em Publish Changes para atualizar a versão ativa do seu conteúdo.

Informações atuais do usuário

Aqui, você pode encontrar detalhes sobre o usuário atual e determinar em quais segmentos de usuários ele atende às condições.

Se você ativar a identificação do usuário, verá três linhas adicionais:

1. User Identification Enabled: Ativado quando você adiciona com êxito o código de identificação do usuário no seu código-fonte. Saiba mais aqui.
2. User Identification Completed: Ativado quando você atribui corretamente um ID único ao usuário que está visitando sua página no momento.
3. User ID: Se você integrou os IDs de usuário na UserGuiding, verá o ID designado do usuário atual.

• User Segments: O usuário atual está incluído em quais segmentos de usuários.
• User Attributes: O usuário atual tem qual dos valores de atributo personalizado.
• Você também pode ver os IDs dos Guias para os Guias vistos e concluídos pelo usuário atual nessa sessão do navegador.

Como revelar detalhes da seção no Troubleshooter:

Se a subseção estiver mostrando o ícone ►, clique nele para revelar mais informações e detalhes de configuração. Quando uma subseção já estiver aberta, seu ícone será ▼.

► Segmentos de usuários:

1. Nessa seção, você vê todos os segmentos de usuários (grupos de usuários) criados e verifica se o usuário atual está incluído nesses segmentos ou não.

Abaixo, por exemplo, o usuário atual é incluído no segmento New Users. ✅

2. Se você clicar no nome de qualquer segmento (ex.: “French Speaking Users”), verá se os dados do usuário atual correspondem à condição de segmentação definida para o segmento.

• Condição (OR / AND): Quando o segmento de usuário é criado com uma propriedade ou a condição definida entre várias propriedades de segmento é AND, todas as propriedades devem corresponder. Se a condição da propriedade for OR >, qualquer propriedade deverá corresponder.

Para saber mais sobre segmentação, acesse aqui.

▶︎ Propriedades:

1. Essa seção mostra a condição de segmentação definida com a propriedade selecionada e se o usuário atual atende à condição.

• Veja o exemplo abaixo: o idioma do navegador do usuário atual não é o francês (valor esperado), portanto ele não pode ser incluído no segmento. ❌

Guias

Aqui, você pode encontrar detalhes relacionados aos Guias ativos dentro do código do container incorporado na página em que o Troubleshooter é aberto.

Importante: se não for possível ver um Guia publicado na página atual, encontre o nome dele nesta seção para descobrir por que ele não está aparecendo. Saiba mais aqui.

1 - Guia de pré-visualização:

Se houver um Guia sendo reproduzido na página atual, você poderá conhecê-lo pelo seu ID e título. Dentro dessa seção, também é possível ver os detalhes da configuração. Veja o exemplo abaixo:

• Disponibilidade de direcionamento: A URL da página atual corresponde às condições de direcionamento do Guia. ✅
• Disponibilidade de segmentação: O usuário atual corresponde às condições de segmentação do Guia. ✅
• O Guia tem etapas a serem exibidas. ✅

2 - Outros Guias:

Essa seção tem todos os Guias ativos que você colocou no código do container incorporado na página atual, exceto os Guias pré-visualizados.

Se você clicar em qualquer Guia da lista, poderá ver os detalhes da sua configuração e verificar se ele pode ser reproduzido na página atual ou não (consulte a disponibilidade).

Disponibilidade de direcionamento

• Se a URL da página atual corresponde às condições de direcionamento do Guia, mostra ✅.
• Se a URL da página atual não corresponde às condições de direcionamento do Guia, mostra ❌.

Veja o exemplo abaixo: como a URL da página atual está em conformidade com as regras de direcionamento, o Guia está disponível com base no seu redirecionamento de página.

Disponibilidade de segmentação

• Se o usuário atual corresponde às condições de segmentação do Guia, mostra ✅.
• Se O usuário atual não corresponde às condições de segmentação do Guia, mostra ❌.

Veja o exemplo abaixo: o Tipo de segmentação do Guia está definido como All Users, o que significa que todos os usuários finais que visitam a URL da página atual estão em conformidade com a Disponibilidade de Segmentação do Guia.

Hotspots

Aqui, você pode encontrar detalhes relacionados aos Grupos de Hotspots ativos dentro do código do container programado na página em que o Troubleshooter é aberto.

Importante: se não conseguir ver o Hotspot publicado na página atual, localize o nome e os detalhes do grupo nesta seção para descobrir por que ele não está aparecendo. Saiba mais aqui.

1 - Grupos de Hotspots disponíveis:

Se houver um grupo de Hotspot disponível na página atual, você poderá ver os detalhes da configuração nessa seção. Quando não houver nenhum, você verá "There is no available Hotspot Group" (Não há grupo de Hotspot disponível).

• O direcionamento e as condições de segmentação do grupo de Hotspots disponíveis atendidos pelo usuário e pela página atuais. ✅

Importante: Se você não conseguir ver o(s) Hotspot(s) de um Grupo de Hotspot disponível na página atual, certifique-se de que o grupo tenha Hotspots dentro dele para serem mostrados.

► Detalhes do Hotspot

• Se seu grupo tiver Hotspots, clique aqui para ver os detalhes relacionados a cada Hotspot.
• Se os Hotspots tiverem um componente de texto, você poderá detectá-lo no texto escrito. Caso contrário, você verá o número da etapa correspondente.
• Exists on the Current Page: A área que você destacou (elemento HTML) ao criar o Hotspot está presente na página atual, assim como o próprio Hotspot. ✅
• Not Interacted Before: O usuário atual não tomou a ação necessária para exibir o Hotspot (ex.: clicar no Beacon). ❌

2 - Outros grupos de Hotspots:

Esta seção tem todos os grupos de Hotspot ativos que você colocou no código do container incorporado na página atual, exceto os grupos disponíveis.

Se você clicar em qualquer grupo de Hotspot na lista, poderá ver os detalhes da sua configuração e entender por que eles não podem ser reproduzidos na página atual (consulte a disponibilidade).

O direcionamento de página do grupo de Hotspot não corresponde à URL da página atual no exemplo abaixo, portanto, não está disponível. Saiba mais aqui.

Checklists

Aqui, você pode encontrar detalhes relacionados aos Checklists ativos dentro do código do container incorporado na página em que o Troubleshooter é aberto.

Importante: Se não conseguir ver o Checklist publicado na página atual, clique no seu nome para descobrir por que ele não está aparecendo.

1 - Checklists disponíveis:

Se houver um Checklist disponível na página atual, você poderá ver os detalhes da configuração nessa seção. Quando não houver nenhum, você lerá: "There is no available Checklist" (Não há Checklist disponível)

• O usuário e a página atuais atendem às condições de direcionamento, segmentação e aparência do Checklist disponível. ✅
• O formato deve mostrar Checklist.
• Taxa de conclusão do Checklist: A taxa de conclusão da barra de progresso do Checklist com cada Guia concluído.

► Guias de Checklist:

Aqui, você pode encontrar a lista de Guias dentro do Checklist ativo.

• Clique em qualquer Guia da lista para ver os detalhes relacionados à sua conclusão. Lembre-se de que os Guias de Checklist são marcados com marcas de verificação quando os usuários finais os concluem.

• Veja o exemplo abaixo; o Checklist disponível na página atual é mostrado no Troubleshooter. A taxa de conclusão do Checklist é de 100%.

2 - Outros Checklists:

Essa seção tem todos os Checklists ativos que você colocou no código do container incorporado na página atual, exceto os disponíveis.

Se você clicar em qualquer Checklist da lista, poderá ver os detalhes da sua configuração e entender por que ele não pode ser reproduzido na página atual (consulte a disponibilidade).

O direcionamento da página do Checklist não corresponde à URL da página atual no exemplo abaixo, portanto, ele não está disponível. Saiba mais aqui.

Pesquisas

Aqui, você pode encontrar detalhes relacionados às Pesquisas ativas dentro do código do container incorporado na página em que o Troubleshooter é aberto.

1 - Pesquisas disponíveis:

Se houver uma Pesquisa ativa sendo exibida na página atual, será possível ver os detalhes da configuração nessa seção. Quando não houver nenhuma, você lerá: "There is no available Survey" (Não há Pesquisa disponível)

• O direcionamento e as condições de segmentação da Pesquisa disponível atendidas pelo usuário e pela página atuais. ✅

Appearance Settings > Display Conditions

• User Last Seen the Survey: A data será escrita se o usuário atual tiver concluído a interação com a Pesquisa.
• Enough Days Passed After Last Seen: Já se passaram dias suficientes desde a última vez que foi visto. ✅
• Will be Available to User on: A data em que o usuário atual o verá novamente depois de ver essa Pesquisa.
• Enough Page Visited: Antes de o usuário atual ver a Pesquisa. ✅
• Sampling: A porcentagem dos usuários que serão amostrados e o usuário atual dentro dessa amostra. ✅
• Showed Less Than 2 Times: Mostrado menos de 2 vezes na sessão atual do navegador. ✅

2- Outras Pesquisas:

Se houver uma Pesquisa ativa que não esteja sendo exibida, mas que tenha sido colocada no código do container incorporado na página atual, será possível ver os detalhes da sua programação nessa seção. Quando não houver nenhuma, você lerá "There is no Other Survey" (Não há outra Pesquisa).

Clique em Pesquisa para entender por que ela não pode ser reproduzida na página atual (consulte a disponibilidade).

• No exemplo abaixo, a Pesquisa tem um direcionamento de página que não corresponde à URL da página atual, portanto não está disponível. Saiba mais aqui.
• Além disso, não se passaram dias suficientes após o usuário atual ter visto a Pesquisa pela última vez.
• Por fim, como eles viram a Pesquisa pelo menos uma vez em uma única sessão, a Pesquisa não será exibida em prol de uma experiência do usuário melhor.