Documentação

Tudo o que você precisa para colocar o Monoid no ar no seu site.

Quickstart Configuração Eventos Personalizados Privacidade e Dados Referência da API API e Tokens

1. Crie uma conta

Acesse monoid.website, informe e-mail, senha e domínio. Você recebe um link de ativação por e-mail.

2. Adicione o snippet do tracker

Depois da confirmação, cole isto dentro da tag <head> do seu site. Substitua YOUR_SITE_ID pelo ID do seu dashboard.

html

<script async defer
  src="https://api.monoid.website/tracker.min.js"
  data-site-id="YOUR_SITE_ID"
  data-autotrack="true">
</script>

O script carrega de forma assíncrona e não bloqueia a renderização. Os dados começam a aparecer no dashboard em segundos.

3. Verifique a instalação

Abra seu site no navegador e confira o dashboard do Monoid. Uma visualização deve aparecer em tempo real no painel Visitantes Ao Vivo. Se nada aparecer depois de um minuto, veja se o atributo data-site-id bate exatamente com o ID do site.

Next.js / React

No Next.js, adicione o snippet ao seu _document.tsx ou use o componente next/script com strategy="afterInteractive":

tsx

import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://api.monoid.website/tracker.min.js"
          data-site-id="YOUR_SITE_ID"
          strategy="afterInteractive"
        />
      </body>
    </html>
  )
}

WordPress

No functions.php do seu tema, adicione:

php

function monoid_tracker() {
  echo '<script async defer src="https://api.monoid.website/tracker.min.js" data-site-id="YOUR_SITE_ID" data-autotrack="true"></script>';
}
add_action('wp_head', 'monoid_tracker');

Coleta sem JS (pixel)

Se você não pode executar JavaScript — páginas renderizadas no servidor com JS desabilitado, páginas estáticas estritas ou ambientes que bloqueiam scripts — use o pixel de rastreamento. Coloque essa tag <img> onde deseja que o rastreamento ocorra. Substitua YOUR_SITE_ID e defina p como o caminho atual da página.

html

<img src="https://api.monoid.website/pixel.gif?s=YOUR_SITE_ID&p=/your-page-path"
  width="1" height="1" alt=""
  style="display:none"
  referrerpolicy="strict-origin-when-cross-origin" />

O pixel registra os mesmos dados principais de analytics que o tracker JS — caminho, referenciador, país, tipo de dispositivo e hash diário de visitante — mas sem largura de tela (sem JavaScript disponível). O cabeçalho Referer do navegador é usado automaticamente; você pode substituí-lo com um parâmetro &r=dominio-referenciador. Visitantes que enviam DNT: 1 não são registrados.

Faltou algo ou encontrou um erro? Avise-nos