> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalação no site

> Cole o script do Metrito no seu site para rastrear visitantes, sessões e conversões.

## Antes de começar

A primeira tela do tracking é a **Configure seu Tracking**. Nela você escolhe onde quer rastrear seus leads: no **Site / Landing Page**, no **WhatsApp Business**, ou nos dois. Esta página cobre a instalação no site.

Você vai precisar de:

1. Acesso à [plataforma](https://app.metrito.com) com o projeto já criado
2. Acesso para editar o HTML do seu site (ou ao gerenciador de tags)

## Passo 1 — Adicione o script no site

No card **Adicione o script no site**, copie o código do tracking e cole **dentro da tag `<head>`** de todas as páginas. O script já vem com o ID do seu container (`MTC-XXXXXXX`) preenchido.

```html theme={null}
<!-- Metrito Tracking Code -->
<script>
  !(function(t,r,a,c,k,i,n,g){
  a="mtrt";c="script";k=window;i=document;n=new URL(location);g=n.searchParams;
  if(k[a])return;t="/"+a+"tag.js?id="+(g.get(a+"id")||t);n.host="sst."+n.host.replace(/^w{3}\./i,"");
  [g.get(a+"url")||n.origin].concat(r).reduce(function(w,x){return w.catch(x?new Promise(function(y,z){
  n=i.createElement(c);n.src=x+t;n.async=!0;n.onload=y;n.onerror=z;
  g=i.getElementsByTagName(c)[0];g.parentNode.insertBefore(n,g)}):
  Promise.reject())},Promise.reject());a=k[a]=function(){a.track?
  a.track.apply(a,arguments):a.queue.push(arguments)};a.ver=1;a.queue=[];
  k.metrito||(k.metrito=a)})(
  "MTC-XXXXXXX",["https://api.metrito.com/v2"]);
</script>
<!-- End Metrito Tracking Code -->
```

A tela oferece dois botões para facilitar:

<CardGroup cols={2}>
  <Card title="Copiar script" icon="copy">
    Copia o código pronto para colar manualmente no `<head>`.
  </Card>

  <Card title="Copiar prompt" icon="robot">
    Copia o código **já embrulhado em um prompt** para colar em ferramentas de IA e *builders* como Lovable, v0, Cursor, Claude Code e similares — a IA instala o script para você.
  </Card>
</CardGroup>

<Warning>
  **Não instale o script direto no tema da Shopify.** A Shopify trata scripts de terceiros de forma diferente e a instalação manual no `<head>` pode não funcionar como esperado. Para Shopify, fale com o time do Metrito para usar o caminho de integração dedicado.
</Warning>

<Note>
  O script deve carregar em **todas** as páginas que você quer rastrear — inclusive páginas de obrigado, checkout e landing pages. Quanto mais cedo no `<head>`, melhor a captura.
</Note>

## Passo 2 — Verifique a instalação

Depois de publicar o site com o script, volte à tela e use o botão de **verificação de instalação**. O Metrito acessa o seu site e confirma se o script está presente. Quando encontra, o card fica verde com o selo **Verificado** e mostra em quantas páginas o script foi detectado.

Você também pode confirmar em tempo real com a extensão **Metrito Pixel Helper** — veja [Testes e diagnóstico](/tracking/testing).

## Passo 3 — Ative o bypass (recomendado)

Logo abaixo da instalação fica o passo **Bypass IOS / Ad Blockers**. Ele faz o script rodar no **seu próprio domínio** (first-party), evitando bloqueios de navegadores como Safari/iOS e de extensões de bloqueio de anúncios — o que aumenta bastante a taxa de captura de dados.

É opcional, mas altamente recomendado. A configuração é feita na seção de [Domínios](/tracking/dominios).

## O que o script captura automaticamente

Assim que carrega, o script dispara um evento de **PageView** a cada página e coleta, sem nenhum código a mais:

| Dado                                                | De onde vem         |
| --------------------------------------------------- | ------------------- |
| URL, título e referenciador da página               | Navegador           |
| Parâmetros UTM (`utm_source`, `utm_campaign`, etc.) | Query string da URL |
| IDs de clique (`fbclid`, `gclid`, `ttclid`)         | Query string da URL |
| Parâmetro de identificação (`src` / `sck`)          | Query string da URL |
| Cookies de primeira parte (`_fbp`, `_ga`)           | Navegador           |
| Dispositivo, navegador e idioma                     | User-Agent          |
| Geolocalização (país, cidade, região)               | IP do visitante     |

Os UTMs da entrada são guardados em cookie e se mantêm pela sessão inteira, então todos os eventos seguintes carregam a atribuição original.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Domínios e bypass" icon="globe" href="/tracking/dominios">
    Rode o tracking no seu domínio e fuja dos bloqueios.
  </Card>

  <Card title="Parâmetros e UTMs" icon="ampersand" href="/tracking/utm-configuration">
    Configure os UTMs dos anúncios para atribuir as campanhas.
  </Card>
</CardGroup>
