Ao divulgar seus produtos em diferentes canais, é fundamental saber de onde vêm os pedidos e quais campanhas realmente trazem resultados. Para isso, a Yampi permite o uso de Metadata e UTMs, recursos que ajudam a personalizar links de compra e rastrear informações importantes sobre cada pedido.
Neste artigo, você vai aprender o que são Metadata e UTMs, como utilizá-los no checkout da sua loja e de que forma essas informações podem apoiar suas estratégias de marketing e gestão de vendas. Neste artigo, vamos explicar:
O que são Metadatas e UTMs?
Metadatas
Pequenos parâmetros que você adiciona ao link de compra.
Servem para incluir informações personalizadas em cada pedido (ex: afiliado, cupom, canal de vendas).
Ficam salvos junto ao pedido e podem ser consultados depois via API ou webhooks.
✅Exemplo de URL com metadata
https://seguro.sualoja.com.br/r/66BOKUNV0N?metadata[afiliado]=123&metadata[cupom]=VIP10
⚠️ Atenção: metadata não é meta tag.
Metadata → é aplicada no link de checkout/produto e fica salva dentro do pedido na Yampi. Informação personalizada enviada no Checkout.
Meta tag → código HTML no site (SEO/validação). Ficam no link da loja/site e são capturados pelo Google Analytics (ou outra ferramenta de análise).
👉 Ou seja: UTMs ajudam no tracking de tráfego e campanhas, enquanto Metadata ajuda no registro personalizado dentro do pedido.
UTMs
São parâmetros usados no link da loja para rastrear campanhas de marketing.
Permitem identificar de onde veio o cliente (origem, canal, campanha etc.)
Elas são amplamente usadas em anúncios pagos, redes sociais, e-mails e outros canais.
As 5 tags UTM disponíveis são:
Parâmetro | Descrição | Exemplo |
| Nome da campanha | blackfriday2025 |
| Origem do tráfego | |
| Meio ou canal | story, email |
| Conteúdo específico do anúncio | banner1 |
| Palavra-chave | tenis+masculino |
❌Por exemplo, um link sem UTM:
<https://loja.com/produto-x>
✅Esse mesmo link com UTMs:
<https://loja.com/produto-x?utm_source=facebook&utm_medium=cpc&utm_campaign=promocao_verao>
Nesse caso, sabemos que o visitante veio do Facebook, por meio de anúncio pago (cpc), dentro da campanha promoção_verao.
Exemplos práticos de uso
Campanhas de marketing: identificar quais anúncios geram mais vendas;
Programa de afiliados: rastrear quem indicou cada compra;
Cupons e promoções: verificar quais códigos e cupons estão sendo usados.
Como gerar URL com metadata?
O Metadata permite que você adicione informações extras ao link de checkout ou produto. Essas informações ficam registradas no pedido, ajudando a identificar a origem da compra, campanhas ou afiliados.
1. Gerando o link de compra
Você pode gerar o link de compra diretamente pelo painel da Yampi:
Acesse o painel da Yampi.
Clique em Produtos → selecione o produto desejado.
Em Resumo, copie o 🔗Link de compra do produto.
Exemplo de link padrão copiado:
seguro.seudominio.com.br/r/AABBJJ
AABBJJ é o token de compra do seu produto e aparece quando você copia o link.
2. Adicionando parâmetros metadata
Para registrar informações extras no pedido, adicione os parâmetros metadata ao final da URL.
Permitem incluir informações personalizadas em cada pedido, como:
Afiliado;
Cupom;
Canal de vendas.
Formato do parâmetro:
?metadata[campo1]=valor1&metadata[campo2]=valor2
Exemplo 1: Identificando a origem da venda
Se você quiser registrar que a venda veio de uma campanha no Instagram:
seguro.seudominio.com.br/r/AABBJJ?metadata[afiliado]=instagram
Exemplo 2: Múltiplos parâmetros
Para adicionar mais de um parâmetro, separe por &:
seguro.seudominio.com.br/r/AABBJJ?metadata[afiliado]=instagram&metadata[campanha]=blackfriday
✅ Toda vez que alguém comprar usando esse link, os metadados configurados serão gravados no pedido e poderão ser consultados no painel ou via API.
Onde consultar as informações de Metadata?
Os dados enviados via metadata:
São incluídos automaticamente em qualquer webhook do tipo order.*
Podem ser consultados via API, incluindo metadata no parâmetro include
Exemplo de consulta via API:
GET | https://{alias}.dooki.com.br/api/orders/{id}?include=metadata
O atributo metadata retornará os dados personalizados enviados no momento do checkout.
Como usar UTMs nos links da sua loja?
As UTMs são parâmetros adicionados ao link da sua loja para rastrear a performance das campanhas de marketing.
Estrutura básica de UTMs
?utm_source=origem&utm_medium=meio&utm_campaign=campanha&utm_content=conteudo&utm_term=palavra
utm_source→ Origem do tráfego (ex.: instagram, google, email)utm_medium→ Meio ou canal (ex.: cpc, story, newsletter)utm_campaign→ Nome da campanha (ex.: blackfriday2025)utm_content→ Variação do anúncio (ex.: banner1, videoA)utm_term→ Palavra-chave (usado em campanhas pagas)
Exemplo prático
Campanha de setembro vinda do Google Ads (CPC):
https://sualoja.com/?utm_source=google&utm_medium=cpc&utm_campaign=promo_setembro&utm_content=banner1
Esses parâmetros também podem ser consultados da mesma forma que os valores de metadata.
Onde consultar as informações das UTMS?
No painel da administrativo, ao consultar os pedidos, somente utm_source e utm_campaign são exibidos e podem ser filtrados através das opções "Origem" e "Campanha", respectivamente.
Os demais parâmetros (utm_medium, utm_term e utm_content) também são capturados, mas não ficam visíveis no painel. Eles somente podem ser acessados por meio de:
Exportação de planilha de pedidos (que inclui todas as cinco UTMs),
API,
Webhook.
Portanto, análises envolvendo esses parâmetros exigem o uso dessas alternativas (planilha, sistema integrado ou API) em vez do painel visual.
Preservação dos dados UTM
A Yampi mantém os parâmetros UTM exatamente como foram recebidos até o fechamento da compra, sem alterações. Se um lojista identifica alguma modificação nos dados registrados, a origem mais provável está na construção da URL ou na forma como ela foi gerada — pois a plataforma não altera esses dados internamente
Integrações disponíveis para análise de UTMs
A Yampi permite o envio dos dados de UTM para diversas ferramentas através de integrações nativas ou via API. Entre as principais estão:
💡Dica: Quer saber mais sobre Metadata e UTMS? Acesse nossa documentação aqui.
Dúvidas frequentes 🤔
▶️Clique na setinha de cada um para abrir o conteúdo*
Posso preencher dados pessoais via UTM?
Posso preencher dados pessoais via UTM?
Não. Isso pode violar a LGPD e expor dados sensíveis.
UTMs do WooCommerce e Shopify são importadas?
UTMs do WooCommerce e Shopify são importadas?
Sim, desde que as integrações estejam ativas e os parâmetros presentes na URL.
Como adicionar uma UTM em um link de compra?
Como adicionar uma UTM em um link de compra?
Basta inserir ?utm_source=...&utm_medium=...&utm_campaign=... ao final da URL.
Como filtrar pedidos por UTM no painel Yampi?
Como filtrar pedidos por UTM no painel Yampi?
Use os filtros de “Origem” para filtrar as tags de utm_source e/ou “Campanha” para tags de utm_campaign na listagem de pedidos.
Onde configurar UTMs em campanhas de anúncios?
Onde configurar UTMs em campanhas de anúncios?
Diretamente no gerenciador de anúncios da plataforma (Meta Ads, Google Ads etc.).
Links encurtados perdem UTMs?
Links encurtados perdem UTMs?
Não, desde que o encurtador mantenha o redirecionamento com parâmetros.
Posso inserir UTMs em landing pages?
Posso inserir UTMs em landing pages?
Sim, inclusive para rastrear origem de leads.
Em caso de dúvidas, clique no balãozinho de atendimento em seu painel ou nos encaminhe pelo e-mail para [email protected] 😉