A pesquisa agrupada da Zendesk permite que os usuários finais vejam, nos resultados de pesquisa da central de ajuda, conteúdo externo à sua central de ajuda, como bases de conhecimento externas, software de gerenciamento de aprendizado, blogs e páginas de seu website. Você pode implementar a pesquisa agrupada pela API de pesquisa agrupada do Zendesk ou pelo rastreador de pesquisa.
Esse rastreador está nas configurações de pesquisa da central de ajuda e permite a implementar a pesquisa agrupada na central de ajuda sem recursos de desenvolvedor (consulte Configuração do rastreador de pesquisa). Use este artigo para solucionar problemas da configuração do rastreador e erros de página que podem acontecer durante a configuração do rastreador de pesquisa de seu aplicativo.
Este artigo contém os seguintes tópicos:
Erros de configuração do rastreador
Os erros de configuração do rastreador são gerados quando o rastreador de pesquisa não é executado com êxito por causa de erros de verificação de responsabilidade pelo domínio ou processamento do mapa do site. Os erros de configuração do rastreador geram uma notificação por e-mail, que é enviada para o responsável pelo rastreador definido na configuração dele.
Não foi possível confirmar a responsabilidade pelo domínio
O rastreador de pesquisa tenta confirmar a responsabilidade pelo domínio sempre que é executado, o que pode demorar até 24 horas. Embora o responsável pelo domínio seja notificado por e-mail quando a confirmação do domínio falha, você pode testar a confirmação de forma instantânea na página de edição do rastreador de pesquisa. Consulte Gerenciamento de rastreadores de pesquisa.
Para solucionar erros de verificação de domínio, veja se:
- A página inicial do seu website (também conhecida como índice ou página-raiz) está funcionando e disponível publicamente. A página não tem nenhuma restrição de acesso, senha e IP de usuário ou outro requisito de autenticação.
- Você implementou a tag correta do rastreador. Ela não deve ter erros de digitação e deve ser implementada na seção <head> da página inicial do site que você deseja rastrear. A tag de verificação de domínio sempre deve ser colocada na página inicial do site, mesmo se o rastreador estiver configurado para rastrear um subconjunto de páginas. Você pode editar o rastreador para visualizar as informações atuais sobre a verificação de domínio. Consulte Gerenciamento de rastreadores de pesquisa.
Observação: é possível ter diversas tags de confirmação para diferentes rastreadores no mesmo domínio.
Exemplo
<html>
<head>
<meta name="zd-site-verification" content="crawler-verification-token">
<title>Title</title>
<style>
<!-- style info here -->
</style>
</head>
<body>
<!-- body of the page here -->
</body>
</html>
Não foi possível processar o mapa do site
O rastreador usa o mapa do site definido na configuração do rastreador sempre que é executado. Se o mapa do site não for processado, o responsável pelo rastreador receberá uma notificação por e-mail e o rastreador não será executado. Caso isso aconteça, verifique o seguinte:
- O rastreador de pesquisa aponta para a URL correta do mapa do site e consegue localizá-la com êxito. Você pode editar o rastreador para visualizar a URL atual do mapa do site. Consulte Gerenciamento de rastreadores de pesquisa.
- O mapa do site funciona e está disponível publicamente. A página não deve ter nenhuma restrição de acesso, senha e IP de usuário ou outra forma de autenticação.
- O mapa do site é um mapa com URL em XML que segue o protocolo XML de mapas do site.
Erros de registro
Os erros de registro ocorrem quando não há erros de configuração, mas o rastreador de pesquisa não consegue extrair e indexar com êxito as páginas definidas no mapa do site do rastreador (consulte Configuração do rastreador de pesquisa). Quando um erro de registro acontece, uma notificação por e-mail é enviada para o responsável pelo rastreador com um link para um arquivo CSV que lista as páginas afetadas e os erros associados.
Localidade não detectada
O erro "Localidade não detectada" indica que o rastreador de pesquisa não detectou nenhuma localidade ou que a localidade detectada não corresponde a uma existente de central de ajuda.
Para determinar a localidade de um registro, o rastreador tenta as seguintes abordagens. A primeira estratégia bem-sucedida determina a localidade dos registros.
- Extração da localidade do atributo lang da tag <html>
- Extração da localidade do cabeçalho Content-Language
- Extração da localidade da tag <meta>
- Análise textual com detecção de idiomas (CLD - Compact Language Detection)
O erro "Localidade não detectada" tem origem em um destes problemas:
- A localidade ou idioma identificado não corresponde à localidade ou ao idioma configurado em nenhuma central de ajuda de sua conta. Para ver quais idiomas estão configurados para cada central de ajuda de sua conta, consulte Configuração da central de ajuda para dar suporte a vários idiomas. Encontre os códigos de localidade dos idiomas configurados em Suporte a idiomas por produto da Zendesk.
- O rastreador de pesquisa não determinou a localidade ou o idioma.
Para solucionar esse problema, verifique se:
- O atributo lang da tag html corresponde à localidade da central de ajuda.
- O cabeçalho HTTP Content-Language corresponde à localidade da central de ajuda.
- O elemento meta com o conjunto Content-Language do atributo http-equiv corresponde à localidade da central de ajuda.
Consulte Noções básicas sobre localidades do rastreador de pesquisa.
Título não detectado
O erro "Título não detectado" indica que o rastreador de pesquisa não detectou o título de um registro. Para determinar o título de um registro, o rastreador tenta as seguintes abordagens:
- Extração do conteúdo da tag <title>
- Extração do conteúdo da tag <h1>
- Extração do conteúdo textual da tag <body>
A primeira estratégia bem-sucedida determina a localidade dos registros. O rastreador indexa os primeiros 255 caracteres do conteúdo extraído como o título do registro, caso uma das duas abordagens iniciais seja bem-sucedida. Caso essas estratégias não determinem um título, o registro não é indexado.
Para solucionar esse problema, certifique-se de que a página afetada tenha uma das tags listadas acima.
Corpo não encontrado
O erro "Corpo não encontrado" indica que o rastreador de pesquisa não detectou o corpo de uma página. Para solucionar esse problema, certifique-se de que a página afetada esteja marcada corretamente com a tag <body>.
HTTP [código do status]
Se o campo de código de erro no CSV de um registro tiver um código HTTP e de status, isso significa que a página não foi indexada porque ela não pode ser acessada. Se a página for indexada com êxito (HTTP 2xx), você não receberá um erro de código de status do HTTP.
Os códigos de erro mais comuns são:
- 404 - Página não encontrada - a página não existe ou foi movida para outra URL. Para solucionar esse problema, certifique-se de que o mapa do site que o rastreador está usando é atual e que todas as URLs do mapa do site apontam para páginas existentes.
-
403 - Proibido - o rastreador não pode acessar a página por causa de um mecanismo de controle de acesso, como restrição de endereço IP ou ele estar subjacente a um registro. Para solucionar esse problema, verifique se:
- Você adicionou Zendesk/External-Content, o agente do usuário do rastreador de pesquisa, à lista de autorização.
- As páginas que você deseja indexar estão disponíveis publicamente, pois o rastreador não consegue agir em páginas com restrição de acesso. Se as páginas que você deseja rastrear e indexar não puderem ser disponibilizadas publicamente, tente indexar as páginas usando a API da pesquisa agrupada (conteúdo externo). Consulte Configuração da API de pesquisa agrupada do Zendesk.
- 5xx - Erro de servidor - a página não pode ser rastreada por causa de um erro de servidor. O site pode estar temporariamente indisponível. Para solucionar esse problema, acesse algumas páginas com esse erro para confirmar se o site está funcionando. Se o site não estiver funcionando, entre em contato com o administrador dele. Quando o erro for corrigido, aguarde o rastreador ser executado novamente no intervalo de sempre (a cada 12-24 horas).
Domínio com URL inválida
O erro "Domínio com URL inválida" indica que a URL da página listada no mapa do site não está no domínio definido na configuração do rastreador.
Para solucionar esse problema, confirme se o domínio da página que acionou o erro está no mesmo domínio definido para o rastreador de pesquisa. Se a página vinculada ao mapa do site apontar para uma página hospedada em um domínio diferente daquele definido na configuração do rastreador, faça o seguinte:
Configure um novo rastreador de pesquisa para a página afetada.
Mova a página do domínio externo para o domínio configurado para o rastreador de pesquisa.
Indeterminado
O erro "Indeterminado" pode ser causado pelo seguinte:
-
Você excedeu o limite de registros externos da instância - o rastreador de pesquisa tem um limite de 50.000 registros externos. Se esse limite for excedido, os registros externos que ultrapassarem esse número não serão indexados nem atualizados. Para visualizar o número de registros externos usados, analise as informações do rastreador de pesquisa. Consulte Gerenciamento de rastreadores de pesquisa. Para solucionar esse problema, faça o seguinte:
- Apague alguns rastreadores, o que remove o registro externo de páginas da instância e permite que as páginas não indexadas anteriormente sejam indexadas. Consulte Gerenciamento de rastreadores de pesquisa.
- Apague registros individuais pela API de pesquisa agrupada. No entanto, se o rastreador que indexa a página ou uma integração de API personalizada que adiciona a página estiverem ativos, a página reaparecerá na próxima vez que o rastreador for executado ou a integração for sincronizada.
- Remova páginas que um ou mais rastreadores usam do mapa do site. Na próxima vez que o rastreador for executado, ele indexará novamente as páginas restantes e apagará aquelas removidas do mapa do site.
- Aponte um ou mais rastreadores para um mapa do site com menos páginas. Na próxima vez que o rastreador for executado, ele indexará novamente as páginas restantes e apagará aquelas removidas do mapa do site.
-
A página usa redirecionamentos de local de JavaScript - o rastreador de pesquisa não observa redirecionamentos de local do JavaScript. Se a página usa redirecionamentos de local do JavaScript, o rastreador não consegue se conectar ao conteúdo da página.
Para solucionar esse problema, faça o seguinte:
- Certifique-se de que o mapa do site aponta diretamente para a página que você deseja indexar.
- Implemente redirecionamentos HTTP.