# Conversões e receita

> Ligue track_conversions no link e registre vendas e cadastros por postback servidor a servidor ou pixel, com receita por moeda.

Fonte: https://curtei.com/docs/api/conversoes

Endpoint: `POST https://api.curtei.com/v1/conversions`
Escopo: `conversions:write`

1. Crie o link com `"track_conversions": true`. O redirecionamento passa a anexar `wsc_id=<id do clique>` ao destino.
2. No seu site, guarde o `wsc_id` (cookie, sessão ou junto do pedido).
3. Quando a venda ou o cadastro acontecer, devolva esse id por postback ou pixel.

## Postback (recomendado)

```bash
curl -X POST https://api.curtei.com/v1/conversions \
  -H "Authorization: Bearer $CURTEI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"click_id": "WSC_ID", "event": "purchase", "order_id": "PED-1", "value": "199.90", "currency": "BRL"}'
```

Só `click_id` é obrigatório (`event` padrão: `conversion`; `currency` obrigatória com `value`). `201` gravou; `200` com `"duplicate": true` quando o mesmo `click_id` + `event` + `order_id` já existe; `202` quando o clique tem menos de 10 minutos e ainda está sendo gravado.

## Pixel

```html
<img src="https://api.curtei.com/v1/conversions/pixel.gif?click_id=WSC_ID&event=signup" width="1" height="1" alt="">
```

O pixel não usa token, então os valores podem ser forjados por quem tem o `click_id`. Para receita, prefira o postback.

## Relatórios

`GET /links/{id}/conversions/stats` e `GET /stats/conversions` (escopo `analytics:read`) devolvem total, taxa de conversão (conversões ÷ cliques únicos) e receita por moeda, com `dimension` = `event`, `rule`, `country`, `device_type`, `referer_channel` ou `source`.