Para que serve
O Google Search Console é de onde o ClickHunt tira as consultas, os cliques, as impressões e a posição média do seu site no Google. Para conectar, o Google exige que a sua conta seja dona verificada do site lá dentro. Esse passo se chama verificar a propriedade, e é feito uma única vez, no Search Console.
Se a sua conta Google enxerga o site mas não está verificada para ele, o ClickHunt não consegue ler os dados e o site nem aparece na lista na hora de conectar.
Antes de começar: o seu blog está no ClickHunt?
- Blog no endereço
.clickhunt.blog. Você não precisa fazer nada. O ClickHunt já é dono dessa propriedade no Google, envia o sitemap e lê os dados sozinho. No painel aparece o aviso "Você está usando o Search Console do ClickHunt". Os dados podem levar até 14 dias para começar a aparecer. - Blog do ClickHunt no seu domínio próprio (ex.:
blog.suaempresa.com). O ClickHunt também se verifica sozinho nesse endereço, assim que o domínio é conectado e verificado em Hospedagem › Domínio. Se quiser ver os dados também na sua conta Google, siga este artigo. - Blog no seu próprio site (WordPress, Wix, Shopify, etc.). Aí a verificação é com você. Siga os passos abaixo.
Passo 1: adicione o site no Search Console
- Entre em search.google.com/search-console com a conta Google que vai ficar dona do site. Use a mesma conta que você vai conectar no ClickHunt.
- Abra o seletor de propriedades, no canto superior esquerdo, e clique em Adicionar propriedade.
- Escolha um dos dois tipos:
| Tipo | O que cobre | Como verifica |
|---|---|---|
| Domínio (recomendado) | O domínio inteiro: com e sem www, http e https e todos os subdomínios, como blog.suaempresa.com |
Só por registro TXT no DNS |
| Prefixo do URL | Só o endereço exato digitado, ex.: https://www.suaempresa.com/ |
Tag HTML, arquivo HTML, Google Analytics, Tag Manager ou DNS |
A propriedade de Domínio é a melhor escolha: ela cobre o blog mesmo que ele esteja num subdomínio, e o ClickHunt troca para ela sozinho quando ela existe na sua conta.
Passo 2A: verificar uma propriedade de Domínio (registro TXT)
- Digite só o domínio, sem
https://e semwww. Ex.:suaempresa.com. Clique em Continuar. - O Google mostra um registro TXT parecido com
google-site-verification=AbCdEf123.... Clique em Copiar. - Em outra aba, entre no painel onde o seu domínio está registrado ou onde o DNS é gerenciado (Registro.br, GoDaddy, Hostinger, Locaweb, HostGator, Cloudflare, etc.) e abra a zona de DNS.
- Crie um registro novo:
- Tipo: TXT
- Nome / Host:
@(ou deixe vazio, conforme o painel) - Valor / Conteúdo: cole o texto copiado do Google
- TTL: pode deixar o padrão
- Salve, volte ao Search Console e clique em Verificar.
Se aparecer "Falha na verificação", espere um pouco e tente de novo: a propagação do DNS pode levar de alguns minutos a algumas horas. Não apague o registro TXT depois de verificar. Se ele sumir, o Google tira a verificação.
Passo 2B: verificar uma propriedade de Prefixo do URL
- Digite o endereço completo, exatamente como o site abre no navegador, com
https://e com ou semwww. Ex.:https://www.suaempresa.com/. Clique em Continuar. - Escolha o método mais fácil para o seu caso:
- Google Analytics. Se o site já tem o Google Analytics instalado e a sua conta é administradora dele, a verificação é automática. Basta clicar em Verificar.
- Tag HTML. O Google mostra uma tag
<meta name="google-site-verification" ...>. Ela precisa ir dentro do<head>da página inicial.- WordPress: plugins de SEO como Yoast, Rank Math ou All in One SEO têm um campo próprio para o código de verificação do Google. Cole só o valor de
content. - Shopify: em Loja virtual › Temas › Editar código, abra
theme.liquide cole a tag logo depois de<head>. - Wix: use a conexão do próprio Wix em Marketing e SEO › Ferramentas de SEO › Google Search Console, que verifica o site sem você colar nada.
- WordPress: plugins de SEO como Yoast, Rank Math ou All in One SEO têm um campo próprio para o código de verificação do Google. Cole só o valor de
- Clique em Verificar. Mantenha a tag ou o arquivo no site depois disso.
Se o site já está verificado por outra pessoa
Às vezes a agência, o desenvolvedor ou um ex-funcionário verificou o site com a conta dele. Não precisa verificar de novo: peça para essa pessoa abrir Configurações › Usuários e permissões › Adicionar usuário no Search Console e adicionar o seu Gmail com permissão Proprietário ou Completo.
Depois que a pessoa adicionar, o site aparece na sua conta e você já pode seguir para o passo 3.
Passo 3: conecte no ClickHunt
- No projeto, abra Configurações › Integrações, seção Integração de dados.
- No card Google Search Console, clique em Conectar.
- Entre com a mesma conta Google que é dona da propriedade e permita o acesso. O acesso é somente leitura: o ClickHunt nunca publica nem altera nada no seu Search Console.
- O ClickHunt procura sozinho a propriedade que bate com o site do projeto. Se houver mais de uma possível, aparece "Escolha qual propriedade conectar a este projeto." Selecione no campo Propriedade.
- Pronto. Ao conectar, o ClickHunt importa até cerca de 16 meses de histórico.
Na tela de conexão, deixe todas as permissões marcadas. Se você desmarcar alguma, o Google não entrega um acesso durável e a conexão cai.
Mensagens que podem aparecer
| Mensagem | O que fazer |
|---|---|
| Nenhuma propriedade encontrada | A conta Google que você usou não tem nenhum site verificado. Faça os passos 1 e 2 com essa conta, ou clique em Conectar outra conta e use a conta que é dona. |
| Conecte seu domínio primeiro | O seu blog está no ClickHunt sem domínio próprio, ou a integração com a plataforma do blog ainda não terminou. Conclua o que a tela pede e volte aqui. |
| Sua conta Google enxerga esta propriedade, mas não está verificada para ela | Peça ao dono para te adicionar como Proprietário ou Completo, ou verifique o site com a sua conta. |
| O blog está em um domínio que não faz parte desta propriedade | O blog está num subdomínio que a propriedade de prefixo não cobre. Crie uma propriedade de Domínio (passo 2A): o ClickHunt troca para ela sozinho. |
| Seu acesso do Google expirou ou foi revogado | Clique em Reconectar e autorize de novo. |
| O Google não retornou um token durável | Reconecte e deixe marcadas as permissões na tela do Google. |
Perguntas frequentes
Quanto tempo leva para os dados aparecerem? A importação começa assim que você conecta. Num site novo no Search Console, o próprio Google pode levar alguns dias para começar a registrar dados.
Posso trocar a propriedade depois? Sim, no próprio painel do Search Console em Integrações. Ao trocar, o histórico guardado é apagado e importado de novo a partir da propriedade nova.
Preciso enviar o sitemap? Se o blog é do ClickHunt, ele já envia e mantém o sitemap sozinho. Se o blog está no seu site, envie o sitemap no Search Console em Sitemaps › Adicionar novo sitemap.