> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Entender o rastreamento de marketing

> Veja como uma campanha atravessa o Payment Link, vira uma Checkout Session e chega aos relatórios e destinos de conversão.

O rastreamento começa na URL que você distribui e termina na **Checkout
Session** criada para aquela compra. É a sessão — não o Payment Link — que
guarda a primeira origem da campanha, acompanha o pagamento e alimenta os
relatórios.

```mermaid theme={"theme":"css-variables"}
flowchart LR
  A["Anúncio, e-mail ou QR code"] --> B["Payment Link com UTMs"]
  B --> C["Nova Checkout Session"]
  C --> D["Atribuição first-touch"]
  C --> E["Checkout e pagamento"]
  D --> F["Relatório de aquisição"]
  E --> G["Pixel e API de conversões"]
```

## O papel de cada objeto

| Objeto               | O que representa                    | Como participa do rastreamento                                                 |
| -------------------- | ----------------------------------- | ------------------------------------------------------------------------------ |
| **Payment Link**     | Uma oferta pública e reutilizável.  | Recebe UTMs e identificadores de clique na URL distribuída.                    |
| **Checkout Session** | Uma tentativa individual de compra. | Guarda o primeiro contexto de aquisição e todos os eventos daquele checkout.   |
| **Payment Intent**   | A tentativa financeira da cobrança. | Confirma se o valor virou pagamento, mas não substitui a atribuição da sessão. |

Quando alguém abre um Payment Link, a Chargefy cria uma Checkout Session nova,
copia a configuração atual da oferta e registra a campanha recebida naquele
acesso. Duas pessoas clicando na mesma URL geram duas sessões independentes,
cada uma com sua própria atribuição e seu próprio resultado.

<Info>
  O Payment Link não fica “pago” e não identifica uma venda individual. Para
  saber qual campanha gerou uma compra, acompanhe a Checkout Session criada por
  aquele acesso.
</Info>

## Os três caminhos de entrada

| Como a venda começa                         | Onde colocar a atribuição       | Caminho recomendado                                                    |
| ------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------- |
| Campanha aponta direto para a Chargefy      | Na query string do Payment Link | Acrescente as UTMs à URL compartilhada.                                |
| Campanha entra primeiro na sua landing page | Na URL da landing page          | Use Chargefy.js para transportar a atribuição até o botão de checkout. |
| Seu backend cria uma sessão por pedido      | No body da criação              | Envie o objeto tipado `marketing_attribution`.                         |

O primeiro caminho é o mais simples:

```text theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=meta&utm_medium=paid_social&utm_campaign=lancamento
```

A Chargefy captura esses parâmetros antes de redirecionar o comprador. Por isso,
eles não precisam continuar visíveis na URL final da Checkout Session para já
estarem associados à compra.

## O que acontece em cada etapa

<Steps>
  <Step title="A campanha leva o comprador até uma URL rastreada">
    A URL pode ser um Payment Link, uma Checkout Session direta ou uma landing
    page que preserva a atribuição com Chargefy.js.
  </Step>

  <Step title="A Chargefy registra o primeiro contexto">
    A sessão ganha um snapshot `first_touch` com UTMs, identificadores de clique,
    landing page e referrer disponíveis naquele momento.
  </Step>

  <Step title="O checkout produz eventos">
    Abertura, envio dos dados de pagamento, aprovação, recusa e expiração viram
    marcos do funil. Quando um destino da Meta está ativo, esses marcos também
    podem ser enviados pelo navegador e pelo servidor.
  </Step>

  <Step title="O resultado volta para a origem da campanha">
    O relatório de aquisição agrupa sessões, pagamentos e receita pela origem,
    mídia e campanha capturadas no começo da compra.
  </Step>
</Steps>

## O que não acontece automaticamente

* A Chargefy não inventa UTMs para uma campanha sem parâmetros;
* `metadata` não vira atribuição de marketing;
* um link copiado do Dashboard não ganha uma campanha específica sozinho;
* um QR code gerado com a URL-base não diferencia anúncio, peça ou canal;
* parâmetros de Google, TikTok e Microsoft são capturados, mas o destino de
  conversão automatizado disponível hoje é a Meta.

## Escolha o próximo artigo

<CardGroup cols={2}>
  <Card title="Adicionar UTMs ao link" icon="link" href="/payments/add-utms-to-payment-links">
    Monte a URL que será distribuída em campanhas e QR codes.
  </Card>

  <Card title="Preservar atribuição em landing pages" icon="window" href="/payments/configure-landing-page">
    Transporte a campanha até o checkout com Chargefy.js.
  </Card>

  <Card title="Enviar atribuição pela API" icon="code" href="/payments/create-checkout-session-with-utms">
    Crie uma Checkout Session já vinculada à campanha.
  </Card>

  <Card title="Conectar o pixel da Meta" icon="chart-line" href="/payments/configure-meta-pixel">
    Envie os eventos do checkout para a Meta.
  </Card>
</CardGroup>