Instalação e sonda
A instalação do GoLoop é uma tag de HTML colada antes do `</head>`. A sonda é o que responde a pergunta seguinte: está funcionando?
Ela vai até a sua página, procura a tag, confere a chave e diz o que encontrou — em vez de deixar você navegando pelo site na esperança de ver um número mudar.
Em que estado a minha instalação pode estar?
São sete, e cada um vem com o próximo passo. Estado sem ação recomendada não ajuda quem acabou de instalar:
- Não configurado — a chave ainda não foi criada.
- Aguardando primeira detecção — a tag foi gerada e nenhum evento chegou ainda.
- Ativo — recebendo normalmente.
- Ativo com alertas — funcionando, mas com algo digno de nota.
- Sem dado recente — recebia e parou. É o estado que exige olhar.
- Erro de configuração — a tag existe e algo nela está errado.
- Desativado — parado por decisão sua.
O que a sonda consegue ver — e o que não vê?
Ela busca o HTML da página a partir do servidor e procura a tag ali. É rápido e não exige nada de você além da URL.
O limite é honesto: ela não vê o que só existe depois do JavaScript rodar. Num site feito em React sem renderização no servidor, o HTML inicial é quase vazio e a leitura vem pobre. Por isso existe também o modo de apontar, que abre a sua página de verdade e enxerga o que o JavaScript montou. Os dois se completam.
Nada chega. Por onde começo?
Quase sempre é uma destas três, nesta ordem:
- A tag não está na página que você abriu — foi colada em outro template. Procure `Goloop tag` no código-fonte da página.
- A chave está trocada — o script carrega e não envia nada, sem erro no console. É deliberado: erro visível no site do cliente é pior que evento perdido.
- Um bloqueador de anúncios — confira numa aba anônima, sem extensões.
Fluxos comuns
- Conferir a instalação logo depois de colar a tag, sem esperar tráfego.
- Descobrir que uma publicação do site derrubou a tag de metade das páginas.
- Provar para o time de desenvolvimento onde exatamente a tag está faltando.
- Ser avisado quando o rastreamento parar de receber dado.
Perguntas frequentes
O script atrasa o meu site?
Ele é carregado de forma assíncrona: não bloqueia a renderização da página. É por isso que o atributo `async` faz parte do que se cola.
Preciso colar em todas as páginas?
Sim. Se o site usa um cabeçalho compartilhado, colar nele uma vez cobre tudo.
Posso testar antes de publicar no site de produção?
Pode, em ambiente de homologação. Vale usar uma chave separada para o dado de teste não se misturar ao real.
A sonda acessa o meu site de onde?
Do servidor da plataforma, e só endereços públicos. Buscar endereços internos é bloqueado de propósito.
Relacionados
Use instalação e sonda no seu site
Crie uma conta, cole o script no site e acompanhe a jornada dos seus visitantes.