Conversões e receita

POSThttps://api.curtei.com/v1/conversions

Ligue track_conversions no link e registre vendas e cadastros por postback servidor a servidor ou pixel, com receita por moeda. Escopo: conversions:write.

Abrir no ChatGPT Abrir no Claude

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

Postback (recomendado)

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

<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.