Skip to main content

​
Pré-requisitos

Antes de instalar o pixel, certifique-se de ter:
  1. Uma conta Metrito com acesso à Plataforma
  2. Um Contêiner de Rastreamento criado para o seu domínio (você vai precisar do ID no formato MTC-XXXXXXX)
  3. Acesso para editar o HTML do seu site (ou acesso ao gerenciador de tags)

​
Instalar o Script de Rastreamento

Adicione o snippet abaixo em todas as páginas do seu site, preferencialmente dentro da tag <head>: 
<!-- Metrito Tracking Code -->
<script>
  !(function (m, e, T, r, i, t, o) {
    o || (o = "mtrt");
    if (m[o]) return;
    t || (T.host = "sst." + T.host);
    i = `/${o}tag.js?id=` + (T.searchParams.get(o + "id") || i);
    [T.searchParams.get(o + "url") || t || T.origin, r].reduce(
      (a, b) =>
        a.catch(
          () =>
            new Promise((y, n) => {
              t = e.createElement("script");
              t.src = b + i;
              t.async = !0;
              t.onload = y;
              t.onerror = n;
              e.body.appendChild(t);
            }),
        ),
      Promise.reject(),
    );
    o = m[o] = function () {
      o.track ? o.track.apply(o, arguments) : o.queue.push(arguments);
    };
    o.ver = 1;
    o.queue = [];
  })(window, document, new URL(location), "https://api.metrito.com/v2", "MTC-XXXXXXX", "https://sst.seudominio.com.br");
</script>
<!-- End Metrito Tracking Code -->
Substitua estes valores:
PlaceholderSubstituir por
MTC-XXXXXXXO ID do projeto da plataforma Metrito
sst.seudominio.com.brSeu subdomínio de rastreamento (fornecido pelo time Metrito)
O subdomínio dedicado é a configuração recomendada. Ele roteia os eventos de rastreamento por um subdomínio do seu próprio domínio (ex: sst.seudominio.com.br), o que evita bloqueios por extensões de anúncio e melhora a confiabilidade dos cookies. O time Metrito configura esse subdomínio para você durante o onboarding.

​
O que o Pixel Captura Automaticamente

Após a instalação, o script coleta os seguintes dados em cada carregamento de página — sem nenhum código adicional:
DadoComo é capturado
URL e título da páginawindow.location e document.title
Referenciadordocument.referrer
Parâmetros UTMQuery string da URL, armazenados em cookie para persistência na sessão
IDs de clique (fbclid, gclid, ttclid)Query string da URL
Parâmetros personalizados (src, sck)Query string da URL
Cookies do navegador (_fbp, _ga)document.cookie
Idiomanavigator.language
Dispositivo e navegadorUser-Agent
GeolocalizaçãoIP do usuário (país, cidade, região, CEP)
Os parâmetros UTM são automaticamente salvos em cookie para persistir entre páginas. Todos os eventos subsequentes na mesma sessão incluem os UTMs da entrada original.

​
Rastreando Eventos

​
Visualizações de Página Automáticas

O pixel dispara um evento de PageView automaticamente a cada carregamento de página. Nenhum código adicional é necessário.

​
Eventos Personalizados

Use a função mtrt() para rastrear eventos personalizados. Os campos mínimos obrigatórios são domain e config.name: 
mtrt("send", {
  domain: "sujaloja.com.br",
  config: {
    name: "Lead",
  },
  lead: {
    name: "João Silva",
    email: "joao@exemplo.com",
    phone: "+5511999999999",
  },
});

​
Identificação de Leads

Quando um usuário preencher um formulário, identifique-o passando os dados de lead: 
mtrt("send", {
  domain: "sujaloja.com.br",
  config: {
    name: "FormularioEnviado",
  },
  lead: {
    name: "Maria Santos",
    email: "maria@exemplo.com",
    phone: "+5511888888888",
  },
});
O objeto lead aceita os seguintes campos:
CampoTipoDescrição
idstringID explícito do lead (gerado automaticamente se omitido)
namestringNome completo
emailstringEndereço de e-mail
phonestringTelefone no formato E.164 (ex: +5511999999999)
Você não precisa enviar lead.id — o Metrito gera um ID único automaticamente quando um novo lead é detectado.

​
Eventos de Compra

Rastreie compras com dados de receita. Inclua config.facebook para encaminhar o evento para a API de Conversões da Meta: 
mtrt("send", {
  domain: "sujaloja.com.br",
  config: {
    name: "Compra",
    facebook: {
      name: "Purchase",
    },
  },
  data: {
    value: 299.9,
    currency: "BRL",
  },
  lead: {
    email: "cliente@exemplo.com",
    phone: "+5511999999999",
  },
});

​
config.name vs config.facebook.name

Esses campos têm funções diferentes:
CampoUtilizado porFinalidade
config.nameMetritoNome interno do evento para dashboards e relatórios. Use qualquer nome que faça sentido para você.
config.facebook.nameMeta (Facebook/Instagram)Nome do evento enviado para a API de Conversões da Meta. Deve seguir os eventos padrão da Meta.
Nomes de eventos Meta mais comuns: PageView, Lead, Purchase, AddToCart, InitiateCheckout, AddPaymentInfo, CompleteRegistration.
Se você omitir config.facebook, o evento é registrado no Metrito mas não é enviado para a Meta. Sempre inclua-o nos eventos que você quer otimizar no Meta Ads.

​
Instalação por Plataforma

Adicione o script no arquivo header.php do seu tema, ou use um plugin como Insert Headers and Footers para incluí-lo na seção <head> de todas as páginas.
Acesse Loja virtual > Temas > Editar código > theme.liquid. Cole o snippet dentro da tag <head>.Para rastreamento de eventos do checkout do Shopify, o Metrito oferece uma integração dedicada — entre em contato com o time Metrito para configurar.
Crie uma tag de HTML personalizado no GTM, cole o snippet do Metrito e configure-a para disparar em Todas as Páginas. Certifique-se de que a opção “Support document.write” está desmarcada.
Use o recurso de injeção de script personalizado da plataforma. Adicione o snippet do Metrito como um script no head que carrega em todas as páginas.

​
Próximos Passos

Configurar UTMs

Configure os parâmetros das plataformas de anúncios para atribuição de campanhas.

Testar a Instalação

Verifique se o pixel está funcionando e os eventos estão sendo capturados.