Documentação

Instalar a tag

A instalação padrão é um único script assíncrono antes da tag de fechamento do body em cada página que você quer medir. Substitua XXXX pelo site_id mostrado na sua página Gerenciar sites.

<script async src="https://9ping.dev/hm.min.js" data-sid="XXXX"></script>

Se você usa o GTM, crie uma nova tag HTML Personalizada, cole o mesmo snippet e configure o gatilho para Todas as Páginas.

Para visitantes com JavaScript desativado ou para contextos de e-mail e AMP, adicione um fallback de imagem de um pixel dentro de uma tag noscript — você ao menos vai capturar PV.

<noscript><img src="https://9ping.dev/collect.php?sid=XXXX&type=pv" width="1" height="1" alt=""></noscript>

Para aplicativos de página única (React, Vue, Next, Nuxt e afins), injete o script uma vez na inicialização — a tag conta automaticamente um PV virtual a cada mudança de rota no cliente.

(function(){var s=document.createElement('script');s.async=true;s.src='https://9ping.dev/hm.min.js';s.dataset.sid='XXXX';document.head.appendChild(s);})();

Eventos personalizados

Depois que a tag carregar, a função global window.tj fica disponível para eventos avulsos como cliques de botão, envios de formulário e downloads. A assinatura é categoria, ação, rótulo.

tj('event', 'button', 'click', 'download_whitepaper');

Para roteadores que você mesmo controla, é possível disparar um PV explícito chamando tj('pv'). Para cliques anteriores ao carregamento da tag, o stub inicial enfileira as chamadas e as reexecuta assim que o script carrega, então você não precisa envolver seus handlers em setTimeout.

Verificar a propriedade do site

A verificação é recomendada antes de ativar relatórios avançados. A página Gerenciar sites lista quatro métodos intercambiáveis para cada site — escolha o que for mais fácil.

Método um — arquivo HTML. Baixe tj-verify-TOKEN.html do painel e suba para a raiz do seu site.

Método dois — meta tag. Cole uma única meta tag no head da sua página inicial.

<meta name="tj-site-verification" content="YOUR_TOKEN">

Método três — código de rastreamento. Se a página inicial já roda nossa tag e recebeu pelo menos uma visita, ela é verificada automaticamente. Método quatro — TXT de DNS. Adicione tj-site-verification=YOUR_TOKEN como registro TXT no domínio apex.

API Aberta e implantação em lote

Cada conta vem com uma chave de API pessoal (prefixo tjk_) que permite listar sites, criar sites, obter snippets de tag e ler estatísticas via HTTPS. Autentique enviando um cabeçalho X-API-Key.

curl -H "X-API-Key: $TJ_KEY" "https://9ping.dev/openapi.php?action=sites"

Para distribuir a tag por um grupo inteiro de sites a partir de uma única máquina Linux, baixe tj-deploy.sh em Gerenciar sites. Ele registra cada domínio via API, gera o snippet da tag e pode opcionalmente injetá-lo nos seus templates.

A API Aberta suporta criação de sites em lote a partir de um arquivo de texto, em que cada linha é um domínio simples ou domínio|nome. Você encontra a lista completa de ações na referência da API.

Segurança: verificação em duas etapas e códigos de recuperação

Todas as contas do painel têm verificação em duas etapas obrigatória com Google Authenticator (TOTP, RFC 6238). No cadastro você recebe dez códigos de recuperação de uso único — guarde-os em local seguro; se perder o celular, eles são a sua única forma de voltar.

Os códigos de recuperação são de uso único e armazenados como hashes no servidor. Para se recuperar, use o link Recuperar com código de recuperação na página de login; o fluxo de recuperação permite definir uma nova senha e revincular o autenticador.

Migrar do GA4 ou Baidu Tongji

Você não precisa remover sua tag existente para testar o 9ping Analytics — as duas tags podem rodar lado a lado e reportar de forma independente, que é a maneira mais segura de comparar números por uma semana antes de migrar.

Para migrar, adicione seu domínio em Gerenciar sites, cole a tag de uma linha antes da tag de fechamento do body (ou envie via GTM), veja o painel em tempo real se acender e remova a tag antiga quando estiver pronto.

Eventos personalizados se traduzem de forma limpa: um evento do GA4 chamado, por exemplo, signup, com parâmetros method e plan, vira tj('event', 'signup', method, plan). Metas e funis no 9ping são tratados marcando os eventos relevantes; não há configuração de meta separada para manter.