TRACKING & ATTRIBUTION

O pagamento confirmado deve fechar o ciclo de atribuição.

O PiXBrasil transporta metadata de atribuição do checkout até o webhook do merchant. Isso permite ligar conversões confirmadas a UTMify e outras plataformas sem acoplar o Core financeiro a um único tracker.

Arquitetura recomendada

Attribution flowtext

Browser/Funnel
  ↓ captura UTMs e click IDs
Backend do Merchant
  ↓ metadata.attribution
PiXBrasil PaymentIntent
  ↓ provider confirmado
PiXBrasil Merchant Webhook
  ↓ payment.succeeded + metadata.attribution
Seu Tracking Bridge
  ├─ UTMify
  ├─ Meta CAPI
  ├─ TikTok Events API
  ├─ Google Ads / GA4
  └─ CRM / BI

Campos recomendados

Payment metadatajson

{
  "metadata": {
    "orderId": "8472",
    "attribution": {
      "utm_source": "meta",
      "utm_medium": "paid_social",
      "utm_campaign": "signum_launch",
      "utm_content": "creative_03",
      "utm_term": "audience_broad",
      "src": "facebook",
      "sck": "abc123",
      "fbclid": "...",
      "gclid": "...",
      "ttclid": "...",
      "msclkid": "..."
    }
  }
}

Preserve somente identificadores necessários à atribuição. Não envie senha, cartão, documento completo ou secrets em metadata.

UTMify

Integração hoje

Use payment.succeeded como source of truth e faça o postback através do seu backend/Tracking Bridge.

Por que não acoplar diretamente

Credenciais, payloads e regras de terceiros mudam. O Core financeiro não deve depender da disponibilidade do tracker para confirmar um pagamento.

Falha de tracking

Se UTMify estiver indisponível, o pedido continua pago. Grave uma fila/retry independente para analytics.

Native Connector — próximo passo

Podemos adicionar UTMify/Meta/TikTok/Google como connectors nativos com credenciais em Vault, logs, retries e mapping configurável por Store.

Outras plataformas

Meta CAPI

Dispare somente após evento financeiro verificado e aplique dedupe por PaymentIntent.

TikTok Events API

Dispare somente após evento financeiro verificado e aplique dedupe por PaymentIntent.

Google Ads / GA4

Dispare somente após evento financeiro verificado e aplique dedupe por PaymentIntent.

CRM / BI

Dispare somente após evento financeiro verificado e aplique dedupe por PaymentIntent.

Prompt para criar o Tracking Bridge

AI promptprompt

Implemente uma camada de atribuição first-party no meu site. Capture utm_source, utm_medium, utm_campaign, utm_content, utm_term, src, sck, fbclid, gclid, ttclid e msclkid na primeira visita. Preserve os valores por 30 dias em storage/cookie apropriado ao stack e grave também no pedido server-side. Ao criar o PIX PiXBrasil, envie esses campos em metadata.attribution. No webhook payment.succeeded, leia metadata.attribution e encaminhe a conversão para a plataforma de tracking configurada usando exclusivamente a documentação oficial/credenciais da conta. Não invente endpoints. O pagamento confirmado pelo PiXBrasil deve ser a source of truth da conversão. Implemente dedupe para que o mesmo paymentIntentId não gere duas conversões.

Princípios

• PiXBrasil confirma dinheiro; tracker mede aquisição.
• Analytics nunca deve bloquear checkout ou webhook financeiro.
• Use first-party attribution e server-side postback sempre que possível.
• Deduplique por PaymentIntent/evento antes de enviar conversão.
• Guarde tokens de tracking em secret manager/Vault, nunca em metadata.

Precisa integrar agora?

Use o AI Setup Kit e entregue o prompt à IA que já trabalha no seu repositório.

Abrir AI Setup Kits