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.
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
- Abra GeralConversõesAjustes.
- Em Script de UTMs para a sua página de vendas, clique no botão de copiar ao lado do código.

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
- Abra a página de vendas com UTMs no endereço, como
?utm_source=teste&utm_campaign=script. - 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), osrce osck. 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.
Botões que não são links
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.

- Escolha o período: Últimos 7 dias, 30 ou 90 dias.
- Em Agrupar por, escolha a dimensão.
- Se quiser, filtre por um produto e clique em Filtrar.

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 tem | Canal |
|---|---|
fbclid ou o cookie _fbc | Meta Ads |
gclid, gbraid ou wbraid | Google Ads |
ttclid | TikTok Ads |
epik | Pinterest Ads |
tblci | Taboola |
ob_click_id | Outbrain |
msclkid | Microsoft Ads |
utm_source, sem identificador de clique | Outras campanhas (UTM) |
| Só um site de origem | Sites de referência |
| Nada disso | Direto / 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
- Escolha o que cada plataforma recebe em o que enviar.
- Configure o consentimento de cookies do checkout.
O que enviar: eventos, valor e dados
Escolha os eventos de cada conta de rastreamento, o valor e a moeda das conversões, os dados de correspondência e as exceções por produto.
Consentimento de cookies e verificação de domínio
Decida se os pixels do checkout esperam o aceite do comprador e verifique o seu domínio na Meta, no Pinterest e no Google pela metatag.