Exportar dados: CSV, API e logs
As formas de tirar dados do Affilitrack — CSV dos relatórios, endpoints da API para cliques, conversões e logs, e como montar uma base para Looker Studio ou planilha cruzando pelo click_id.
CSV pelo painel
Relatórios › Exportar CSV baixa a tabela do agrupamento e do período selecionados (Cliques, Conversões, CR, Receita, EPC por campanha, fonte, keyword, placement, criativo, país ou device). É a exportação para quem quer um resumo.
API (planos com acesso à API)
Autentique com POST /api/auth/login e use o token JWT em Authorization: Bearer …. Os endpoints de leitura:
| Dados | Endpoint | Filtros |
|---|---|---|
| Cliques | GET /api/clicks | periodo, q (busca), limit |
| Conversões | GET /api/conversions | periodo, limit |
| Logs de postback | GET /api/logs | result, q, limit |
| Conversões órfãs | GET /api/orphans | limit |
| Envios a destinos | GET /api/envio-logs | destino_id, ok, limit |
| Painel | GET /api/dashboard | periodo |
| Relatório agrupado | GET /api/report | group_by, periodo |
| Custos | GET /api/campaign-costs | periodo |
| Bots detectados | GET /api/bots-detectados | dias |
| Auditoria | GET /api/audit-logs | limit |
Períodos: hoje, ontem, 7d, 14d, 30d, mes, mes_passado. A referência completa, com os campos de cada resposta, está em app.affilitrack.com.br/api/docs. Veja API REST.
Montar uma base analítica
O modelo é simples: cliques e conversões se ligam pelo click_id. Um job diário que:
- Busca
GET /api/clicks?periodo=ontem&limit=…e grava numa tabelacliques(camposclick_id,created_at,campaign_*,source_*,ref_id,cid,gid,aid,keyword,placement,country,device,sub1…sub10,is_bot). - Busca
GET /api/conversions?periodo=onteme grava emconversoes(conversion_id,click_id,tipo,status,payout,currency,txid,created_at). - Busca custos e grava em
custos(day,campaign_id,cost).
No Looker Studio ou na planilha, junte por click_id e por campaign_id+day. Com isso você tem qualquer corte — por sub-ID, por hora do dia, por país e criativo ao mesmo tempo — que o painel não oferece pronto.
Retenção
Os dados ficam disponíveis pelo período de retenção do plano (6, 12 ou 24 meses). Para guardar além disso, exporte periodicamente — o job acima resolve.
Payload bruto
O botão payload em Logs › Postbacks S2S e o ver em Cliques mostram o registro completo de um item. Pela API, os mesmos endpoints devolvem esses campos.