Central de ajuda

TrackProps no Checkout (Parâmetros de Rastreamento)

Atualizado em 14 de fevereiro de 2026

O que são TrackProps?

TrackProps são os parâmetros de rastreamento capturados automaticamente quando uma venda é originada a partir de anúncios ou campanhas externas.

Esses parâmetros são enviados na URL do checkout e ficam vinculados à transação, permitindo:

  • Identificar origem da venda

  • Medir performance de campanhas

  • Rastrear afiliados

  • Integrar com ferramentas externas

  • Manter consistência de atribuição

Como funciona na prática

Quando o cliente acessa o checkout por meio de um link que contém parâmetros de rastreamento, a plataforma:

  1. Lê os parâmetros presentes na URL

  2. Armazena os valores como trackProps da transação

  3. Associa esses dados permanentemente à venda

Exemplo de URL válida:

https://app.meugateway.com/checkout/123?offer=1&utm_source=google&utm_campaign=lancamento

O parâmetro offer é sempre obrigatório no checkout e identifica a oferta utilizada.

Parâmetros suportados

A plataforma reconhece os seguintes parâmetros como TrackProps:

  • external_id

  • utm_id

  • utm_source

  • utm_medium

  • utm_campaign

  • utm_content

  • utm_term

  • fbc

  • fbp

  • src

  • sck

  • affiliate_code

  • ip

  • user_agent

  • zip_code

  • country

  • city

  • state

Somente esses parâmetros são capturados automaticamente como trackProps.

Onde esses dados ficam disponíveis

1️⃣ Nos detalhes da venda (Painel)

Quando o produtor acessa os detalhes de uma transação no painel, os TrackProps aparecem vinculados à venda.

Isso permite:

  • Identificar exatamente qual campanha gerou aquela conversão

  • Verificar afiliado responsável

  • Conferir dados de origem do tráfego

Essas informações ficam salvas permanentemente junto à transação.

2️⃣ Nos Webhooks da transação

Os TrackProps também são enviados no webhook da venda.

No payload do webhook, eles aparecem no objeto:

trackProps

Exemplo simplificado:

{
  "id": "txn_123",
  "amount": 10000,
  "status": "paid",
  "trackProps": {
    "utm_source": "google",
    "utm_campaign": "blackfriday",
    "affiliate_code": "AF123"
  }
}

Os dados são retornados exatamente como chave e valor, conforme recebidos na URL do checkout.

Isso permite:

  • Integração com ferramentas externas

  • Armazenamento em CRM

  • Sincronização com plataformas de tracking

  • Auditoria de campanhas

Estrutura correta da URL

Uma URL só pode conter um “?”.

Exemplo correto:

https://app.meugateway.com/checkout/123?offer=1&utm_source=facebook&utm_campaign=launch

Erro comum:

https://app.meugateway.com/checkout/123?offer=1?utm_source=facebook

Após o primeiro “?”, todos os parâmetros adicionais devem ser adicionados com “&”.

Boas práticas

  • Sempre validar se a URL já contém “?” antes de adicionar parâmetros

  • Não duplicar o parâmetro offer

  • Utilizar apenas parâmetros suportados

  • Garantir que o redirecionamento preserve os parâmetros até o checkout

Resumo

  • TrackProps são capturados a partir da URL do checkout

  • São armazenados permanentemente na transação

  • Aparecem nos detalhes da venda no painel

  • São enviados no webhook dentro do objeto trackProps

  • Mantêm exatamente a estrutura chave → valor

A correta utilização dos TrackProps garante rastreamento consistente e integrações mais precisas com ferramentas externas.