Visão geral

Existem vários motivos pelos quais uma pesquisa pode não ser exibida na página ativa da sua plataforma — os mais comuns são problemas de segmentação, direcionamento, configuração do contêiner, configurações de gatilho ou instalação.

Siga os passos abaixo para localizar e corrigir o problema.

Executar a ferramenta de solução de problemas

Antes de consultar a lista de verificação, a maneira mais rápida de encontrar o problema é executar o Troubleshooter do UserGuiding na página onde você espera que a pesquisa apareça. A ferramenta inspeciona todas as configurações da pesquisa diretamente na página ativa e sinaliza o que está bloqueando seu funcionamento.

Importante: Se você não conseguir abrir a ferramenta de solução de problemas em uma página, o UserGuiding não está instalado nessa página. Essa é a causa mais provável — saiba como incorporar o código do contêiner aqui .

Lista de verificação

Segue uma breve lista de itens para verificar:

• Verifique o status da pesquisa (Ativa / Inativa)
• Clique em Publicar alterações.
• A pesquisa foi atribuída ao contêiner correto?
• As configurações de segmentação estão corretas?
• O código do contêiner está incorporado corretamente?
• As configurações de segmentação de público estão corretas?
• As configurações de gatilho (Gatilho automático, Frequência de aparição, Parar gatilho) estão corretas?
• Existe algum bloqueador de anúncios ativo no navegador?
• Buffers de cache
• Verifique a cota de usuários ativos mensais (se excedida, as pesquisas não serão exibidas).
• Outros possíveis problemas que podem causar o problema

Verifique o status da pesquisa.

Se a pesquisa estiver inativa , ela não ficará visível em sua página da web ou aplicativo.

Como ativar sua pesquisa:

1. Acesse seu Painel e abra Pesquisas .
2. Clique na pesquisa que deseja ativar.
3. Abra a página de Configuração.
4. Defina o status como Ativo .
5. Salvar.

Clique em Publicar alterações.

Após criar, editar ou ativar uma pesquisa, clique sempre em "Publicar alterações" no painel. Isso atualiza o código do seu contêiner e as alterações serão refletidas na sua página da web ou aplicativo. Edições não publicadas não serão exibidas para os usuários finais.

A pesquisa foi atribuída ao contêiner correto?

Se a Pesquisa não estiver no contêiner incorporado ao ambiente que você está testando, ela não aparecerá. Abra a Pesquisa → Configurar → confirme se ela está atribuída ao contêiner correto.

Lembrete: se você estiver realizando testes em um ambiente de homologação e esse ambiente usar um contêiner diferente do ambiente de produção, a pesquisa deverá estar no contêiner correspondente a esse ambiente. Consulte Movendo conteúdo entre diferentes ambientes .

As configurações de segmentação estão corretas?

Se as configurações de segmentação não corresponderem ao URL que você está testando, a pesquisa não será exibida.

Exemplos:

• Para exibir em produção: URL contém yourdomain.com/
• Para exibir em ambiente de teste: a URL contém staging.yourdomain.com/

Verifique novamente o operador (contém, é igual a, começa com, expressão regular) e certifique-se de que não há erros de digitação.

O código do contêiner está incorporado corretamente?

Se o código do contêiner UserGuiding não estiver incorporado na página, nenhum conteúdo — incluindo sua pesquisa — será carregado.

• Se você usar vários contêineres , certifique-se de que o contêiner correto esteja incorporado nesse ambiente e que a pesquisa esteja atribuída a esse mesmo contêiner.
• Cada contêiner possui um ID exclusivo no final do trecho de código JS.
• Use o console do seu navegador para confirmar se o contêiner correto está sendo carregado. Um colega desenvolvedor pode ajudar nesse processo.
• Se mais de um contêiner estiver incorporado na mesma página, nenhum dos seus materiais de integração será exibido. Mantenha apenas um contêiner por ambiente.

Veja também: Aviso de status de incorporação de código de contêiner .

As configurações de segmentação de público estão corretas?

Se você configurou um Segmento Personalizado na Pesquisa e o usuário de teste não corresponder a ele, a Pesquisa não será exibida.

Veja também:

• Atributos personalizados — se o segmento for baseado em atributos personalizados, confirme se esses atributos estão sendo realmente enviados para o usuário de teste (um colega desenvolvedor pode verificar isso).
• Para exibir a pesquisa para todos, altere o público-alvo para Todos os usuários .

As configurações do gatilho estão corretas?

O comportamento das pesquisas varia de acordo com a forma como são acionadas. Consulte as Configurações de Acionamento de Pesquisa Personalizadas :

• Acionamento automático ATIVADO — a pesquisa é acionada automaticamente quando o usuário acessa o URL de destino (desde que as condições de segmento e página correspondam).
• Acionamento automático DESATIVADO — a pesquisa só será acionada por meio de um acionador personalizado (API JavaScript, hiperlink da pesquisa ou Central de Recursos). Se o acionamento automático estiver desativado e nenhum acionador personalizado for acionado, a pesquisa nunca será exibida automaticamente.
• Frequência de exibição (Apenas uma vez / Uma vez a cada 7 dias / Sempre, etc.) — se o usuário já tiver visualizado a pesquisa na janela configurada, ela não será exibida novamente. Teste no modo anônimo ou com um usuário diferente para confirmar.
• Gatilho de parada — a pesquisa pode ser configurada para parar após N visualizações, após uma resposta ou quando uma meta for atingida. Assim que a condição de parada for atendida, ela não será exibida novamente para esse usuário.

Observação: se a Identificação do Usuário não estiver ativada, os usuários que estiverem no modo anônimo, em um novo navegador ou após a limpeza do cache serão considerados novos usuários e poderão ver a pesquisa novamente, mesmo que esteja configurada para "Apenas uma vez".

Existe algum bloqueador de anúncios ativo no navegador?

Os bloqueadores de anúncios podem bloquear trechos de código do UserGuiding. Desative qualquer bloqueador de anúncios ativo durante os testes. Consulte a solução para o problema de bloqueadores de anúncios que afetam o UserGuiding .

Buffers de cache

O cache também pode causar esse problema. Limpe o cache do navegador e atualize a página completamente. Se isso não resolver o problema, reinicie o navegador.

Verifique a cota de MAU

Se sua conta ultrapassou a cota de Usuários Ativos Mensais, as pesquisas (e outros conteúdos ao vivo) não serão exibidas. Verifique seu plano e o uso de Usuários Ativos Mensais no Painel.

Outros possíveis problemas que podem causar o problema

• Vários materiais com acionamento automático na mesma página — se dois ou mais materiais estiverem configurados para serem acionados automaticamente no mesmo URL, eles podem entrar em conflito. A Prioridade de Exibição decide qual deles prevalece, e o de menor prioridade não será exibido. Você pode ajustar a prioridade de menor prioridade ou converter um deles em um acionador personalizado. Exemplo:
• • A pesquisa A é acionada automaticamente quando a URL contém /home
  • O Guia B é acionado automaticamente quando a URL contém userguiding
  • Em userguiding.com/home , ambos tentam ser acionados ao mesmo tempo — defina a Prioridade de Exibição ou remova um deles.
• iFrames — O conteúdo do UserGuiding não é renderizado dentro de iFrames. Se a página ou o elemento de destino estiver dentro de um iFrame, a pesquisa não será exibida.
• Incompatibilidade na identificação do usuário — se a identificação do usuário estiver habilitada, mas o usuário não estiver sendo identificado no ambiente de teste (ou estiver identificado com um ID diferente do ambiente de produção), a pesquisa poderá ser ignorada. Confirme se o método userGuiding.identify() é acionado com um ID de usuário válido no ambiente de teste.