VipterCentral de Ajuda
Integrações

Script de UTM e origem das vendas

Leve as UTMs e os identificadores de clique da sua página de vendas até o checkout e veja em Origem das vendas de onde vieram as vendas pagas.

Admin ou DonoTodos os planosVerificado em 28 de set. de 2026

Quando o anúncio leva direto ao checkout, o Vipter já lê as UTMs e os identificadores de clique do link. Quando o anúncio leva a uma página de vendas no seu site, esses dados ficam na página e se perdem no clique para o checkout. O script de UTMs resolve isso. Depois, a aba Origem das vendas mostra de onde vieram as vendas.

Antes de começar

  • Papel Admin ou Dono no projeto do Vipter.
  • Acesso para editar o HTML da sua página de vendas, ou um campo de "código no rodapé" no construtor de páginas.

Passo 1: copiar o script

  1. Abra GeralConversõesAjustes.
  2. Em Script de UTMs para a sua página de vendas, clique no botão de copiar ao lado do código.
Cartão Script de UTMs com o código para copiar

O código é uma linha só:

<script src="https://pay.vipter.com/t.js" async></script>

Com um domínio próprio ativo, o código copiado já vem com data-hosts="seu-dominio", como data-hosts="checkout.sualoja.com.br".

Passo 2: colar na página de vendas

Cole o código em todas as páginas de onde o visitante pode ir para o checkout, no fim da página, antes do fechamento da tag </body>. Em construtores como WordPress, Elementor ou similares, use o campo de scripts do rodapé.

O script não altera a aparência da página.

Passo 3: conferir

  1. Abra a página de vendas com UTMs no endereço, como ?utm_source=teste&utm_campaign=script.
  2. Clique no botão de compra.

Deu certo se

O endereço do checkout abre com utm_source=teste e utm_campaign=script. Depois de uma compra de teste, o pedido mostra essa origem no cartão Origem e conversões e a venda entra em Origem das vendas.

O que o script faz

  • Guarda no navegador do visitante, por 30 dias, as UTMs (utm_source, utm_medium, utm_campaign, utm_content, utm_term, utm_id), o src e o sck. Vale a primeira origem: se o visitante volta depois sem UTMs, ou por outra campanha, a origem guardada continua a primeira.
  • Guarda os identificadores de clique dos anúncios (fbclid, gclid, gbraid, wbraid, ttclid, epik, tblci, ob_click_id, msclkid). Para eles vale o clique mais recente.
  • No clique num link para o checkout, acrescenta esses dados ao link, junto com os cookies da Meta (_fbp, _fbc), do TikTok (_ttp) e do Google Analytics (_ga) da sua página. Isso melhora a correspondência dos eventos enviados pelo servidor.
  • Nunca troca um parâmetro que o link já tem.
  • Leva também o código de vendedor (?v=), se o visitante chegou por um link de vendedor. Nesse caso vale o último.

O atributo data-hosts

O script só mexe em links que apontam para o checkout do Vipter (pay.vipter.com). data-hosts acrescenta outros endereços, separados por vírgula:

<script src="https://pay.vipter.com/t.js" data-hosts="checkout.sualoja.com.br,pagamento.sualoja.com.br" async></script>

Use quando os botões da página levam ao seu domínio próprio de checkout. Se você ativar um domínio depois de colar o script, copie o código de novo ou acrescente o domínio em data-hosts.

O script age em links (<a href="…">). Se o botão de compra abre o checkout por JavaScript, peça a quem mantém a página para passar o endereço por window.vipterDecorate:

window.location.href = window.vipterDecorate('https://checkout.sualoja.com.br/sua-oferta');

A origem das vendas

Abra GeralConversõesOrigem das vendas. De onde vêm as vendas pagas: UTMs, src/sck e IDs de clique capturados no checkout.

Filtros de Origem das vendas: período, agrupar por e produto
  1. Escolha o período: Últimos 7 dias, 30 ou 90 dias.
  2. Em Agrupar por, escolha a dimensão.
  3. Se quiser, filtre por um produto e clique em Filtrar.
Tabela Vendas por Canal com pedidos, divisão entre cartão e PIX e receita de cada canal

No topo, Pedidos pagos e Com origem identificada (Pedidos com UTM, src/sck, ID de clique de anúncio ou site de origem.). A tabela mostra, por linha, os pedidos, a divisão Cartão / PIX e a receita.

Como o canal é decidido

Com Canal, cada venda entra num canal, nesta ordem:

Se a venda temCanal
fbclid ou o cookie _fbcMeta Ads
gclid, gbraid ou wbraidGoogle Ads
ttclidTikTok Ads
epikPinterest Ads
tblciTaboola
ob_click_idOutbrain
msclkidMicrosoft Ads
utm_source, sem identificador de cliqueOutras campanhas (UTM)
Só um site de origemSites de referência
Nada dissoDireto / sem origem

O identificador de clique vence a UTM. Uma venda de um anúncio da Meta com utm_source=instagram entra em Meta Ads. Para ver a UTM, agrupe por utm_source.

As outras dimensões (utm_source, utm_campaign, utm_medium, utm_content, src, sck) agrupam pelo valor exato. Vendas sem o parâmetro aparecem como (não informado).

O que entra na conta

  • Só pedidos pagos no período. Pedidos reembolsados por inteiro saem; nos reembolsos parciais, a receita já vem descontada.
  • Só a primeira compra de cada pedido. Renovações de assinatura não entram.
  • Cada moeda tem a sua linha. Um canal com vendas em reais e em dólares aparece duas vezes.
  • A divisão Cartão / PIX conta como cartão tudo o que não é PIX.
  • O filtro de produto também encontra o produto quando ele foi vendido como order bump.
  • Mostrando os 5.000 pedidos mais recentes do período. aparece quando o período tem mais de 5.000 pedidos.

Problemas comuns

  • As vendas da página de vendas aparecem como Direto / sem origem

    O script não está na página, ou os botões levam a um domínio que não está em data-hosts. Confira o Passo 3.

  • O link do checkout abre sem UTMs

    O botão não é um link comum. Use window.vipterDecorate, como em "Botões que não são links".

  • A campanha da venda é de uma visita antiga

    É o comportamento esperado: vale a primeira origem dos últimos 30 dias no mesmo navegador.

O que fazer a seguir

Nesta página