Como puxar o gasto do Meta Ads por dia com a API de Insights

Resposta curta: a API de Insights da Meta (Marketing API) devolve o gasto e as ações por campanha e por dia. Para o afiliado, que não tem pixel na página do marketplace, os campos úteis são spend e as métricas de tráfego, como cliques no link e visualizações da página de destino.

Requisição básica

GET https://graph.facebook.com/{versão}/{campaign_id}/insights
  ?fields=campaign_name,spend,actions,inline_link_clicks
  &time_increment=1
  &time_range={"since":"2026-10-01","until":"2026-10-15"}
  &access_token={TOKEN}

• fields: spend (gasto), actions (lista de ações por tipo, como link_click e landing_page_view) e inline_link_clicks.
• time_increment=1: uma linha por dia, o que o histórico diário do kanban precisa.
• time_range ou date_preset: janela de datas do relatório.
• level: consulte no nível da campanha, do conjunto ou do anúncio, conforme o seu SubID.

Alinhando campanha e SubID

Dê à campanha (ou ao anúncio) o mesmo nome do SubID do link de afiliado. Assim o gasto da API cruza com a comissão do relatório sem tabela de correspondência.

Cliques no link x visitas à página

Cliques no link e visitas à página (landing_page_view) são métricas diferentes. A visita só conta quando a página carrega; o clique conta ao tocar. Escolha uma métrica por campanha e identifique qual usou no custo unitário.

Cuidados

• Token e permissões: o acesso exige token de uma conta com permissão no gerenciador de anúncios, e tokens expiram.
• Versão da API: a versão faz parte do endereço e muda com o tempo; atualize periodicamente.
• Limites de uso: há limite de chamadas; consulte em lote e não a cada minuto.
• Sem programar: exporte o relatório do gerenciador (CSV) com repartição por dia e envie para a plataforma.