Skip to main content
Estes indicadores cruzam três rotas pelo campaignId: o cadastro em Campanhas, o funil de envio em Estatísticas de campanha e as vendas atribuídas em Conversões. Veja Como as rotas se relacionam para o mapa completo desses elos.

​
Funil: contatos → engajados → compradores

Pergunta: quantos contatos avançam de “na base” para “engajado” até “comprador” no período?
contatos vem de /customers, que não aceita from/to — é sempre a base inteira. Só engajados e compradores respeitam o período filtrado. Isso é esperado: o funil compara “toda a base” com “quem se moveu neste período”.

​
ROI de campanha

Pergunta: quanto de retorno cada real investido em campanha trouxe, no total ou por campanha?
Requisição
Quando totalCost vem zerado (canal sem custo cadastrado), calcule uma estimativa com costPerSend de Campanhas × sent de campaign-stats. Se nenhum dos dois existir, mostre ”—” em vez de dividir por zero.

​
Conversão histórica por campanha

Pergunta: qual campanha converte melhor, olhando todo o histórico dela (não só este período)?
Requisição
Resposta
Esta métrica não aceita from/to — o percentual é sobre o histórico completo da campanha. Não misture esse número com o funil do mês: são janelas de tempo diferentes por design.

​
Mensagens enviadas (total e por campanha)

Pergunta: quantas mensagens de campanha foram enviadas no período — no total e por campanha?
Requisição
Resposta
Para o mesmo número quebrado por campanha, use Mensagens por campanha (metrics/send-message-per-campaign), que devolve items: [{ campaignId, campaignName, value }].
O mesmo total também pode ser obtido somando sent de todos os itens de campaign-stats no período — os dois caminhos são equivalentes. Prefira a métrica pronta quando não precisar do detalhe diário.