Cards de resumo de lucratividade

Receita bruta total no período

Investimento total em mídia paga (Meta Ads e Google Ads) no período.

Número total de pedidos no período

Total de clientes (novos + recorrentes) no período

Clientes cuja primeira compra aconteceu no período.

Clientes que compraram no período e cuja primeira compra foi antes do início dele.

Pedidos de recompra no período: pedidos de clientes que já tinham comprado antes daquele pedido (inclui a segunda compra de quem entrou no próprio período). É o divisor do cpr (investment ÷ recurringOrders). Não é a mesma população de recurringCustomers; não divida um pelo outro.

Ticket médio: revenue ÷ orders. 0 quando não há pedidos.

Margem de contribuição em valor: revenue × marginPercent / 100. Sem margem configurada, é igual a revenue.

Lucro de contribuição (contribution − investment)

Custo por venda: investment ÷ orders. Não depende da margem. 0 quando não há pedidos.

Custo por recompra: investment ÷ recurringOrders, ou seja, quanto foi investido em mídia, em média, para cada pedido de recompra. Usa o investimento total, por isso é sempre maior ou igual ao cpv. Não depende da margem. 0 quando não há pedidos de recompra.

CAC médio: investimento total em mídia ÷ clientes novos. Inclui o investimento em marca e monetização, porque essas campanhas também trazem clientes. Para o CAC restrito a campanhas de aquisição, veja campaignCac e acquisitionCac. Não depende da margem. 0 quando não há clientes novos.

CAC considerando só o investimento em campanhas classificadas como aquisição (campanhas sem classificação ficam de fora), dividido por todos os clientes novos. 0 quando nenhuma campanha está classificada ou não há clientes novos; use hasAcquisitionClassification para distinguir os dois casos.

Investimento em campanhas classificadas como aquisição. É o numerador de campaignCac e de acquisitionCac.

Clientes novos cuja primeira compra foi atribuída (por UTM) a uma campanha de aquisição. Diferente de newCustomers, que conta todos os clientes novos, inclusive orgânicos. Sem datas, considera todo o histórico.

CAC das campanhas de aquisição: acquisitionInvestment ÷ acquisitionNewCustomers, com os dois lados restritos a essas campanhas. Não depende da margem. null quando não há investimento em aquisição ou quando essas campanhas não trouxeram nenhum cliente atribuído.

LTV/CAC das campanhas de aquisição: acquisitionLtv ÷ acquisitionCac. Diferente de ltvCacRatio, que considera todos os clientes e todo o investimento. null quando um dos lados não pode ser calculado.

ROI das campanhas de aquisição, como razão: (acquisitionContribution − investimento de aquisição) ÷ investimento de aquisição. Costuma ser bem menor que roi, que inclui vendas orgânicas e não atribuídas no numerador. null quando não há investimento em aquisição ou quando essas campanhas não trouxeram nenhum cliente atribuído (a receita não foi observada, então não é 0).

Margem gerada pelos clientes trazidos pelas campanhas de aquisição: receita desses clientes × marginPercent / 100. null nos mesmos casos que acquisitionRoi.

LTV médio, com margem, dos clientes trazidos pelas campanhas de aquisição: receita total desses clientes ao longo da vida × margem ÷ acquisitionNewCustomers. null nos mesmos casos que acquisitionRoi.

Investimento em campanhas classificadas como monetização (venda para clientes da base). É o denominador de monetizationRoi e monetizationCpr.

Investimento em campanhas que não estão classificadas como aquisição, marca ou monetização. Somado a acquisitionInvestment, brandInvestment e monetizationInvestment, dá o investimento total das campanhas sem dupla contagem. Esse total pode diferir ligeiramente de investment por diferença de atualização dos dados e porque ajustes de gasto zerados ou negativos entram aqui, mas não em investment.

Investimento em campanhas classificadas como marca (reconhecimento de marca).

Total de impressões das campanhas classificadas como marca, somando Meta Ads e Google Ads. Para o CPM de marca, calcule brandInvestment ÷ brandImpressions × 1000.

Clientes novos cuja primeira compra foi atribuída (por UTM) a uma campanha de marca. Sem datas, considera todo o histórico. Por ser uma contagem, 0 é um valor real.

Margem gerada pelos clientes trazidos pelas campanhas de marca: receita desses clientes × marginPercent / 100. null quando não há investimento em marca ou quando essas campanhas não trouxeram nenhum cliente atribuído.

ROI das campanhas de marca, como razão: (brandContribution − investimento em marca) ÷ investimento em marca. O investimento usado vem da mesma base de atribuição de brandContribution e pode diferir ligeiramente de brandInvestment. null nos mesmos casos que brandContribution.

Parte do LTV gerada pelas recompras: média, por cliente, da receita dos meses posteriores ao mês da primeira compra × marginPercent / 100. Considera os clientes adquiridos até o fim do período (ou toda a base, sem datas). Uma segunda compra no mesmo mês da primeira conta como entrada, não como recompra. 0 quando não há clientes.

Margem dos pedidos atribuídos (pela UTM do próprio pedido) a campanhas de monetização: receita desses pedidos × marginPercent / 100. Sem datas, considera todo o histórico. null quando a atribuição de pedidos não está disponível para a organização.

ROI das campanhas de monetização, como razão: (monetizationContribution − monetizationInvestment) ÷ monetizationInvestment. null quando não há investimento em monetização ou quando a atribuição de pedidos não está disponível.

Clientes recorrentes distintos com ao menos um pedido no período atribuído (pela UTM do pedido) a uma campanha de monetização. É um subconjunto de recurringCustomers. 0 é um valor medido; null quando a atribuição de pedidos não está disponível.

Custo por recompra das campanhas de monetização: monetizationInvestment ÷ pedidos de recompra atribuídos a essas campanhas. Não depende da margem. null (e não 0) quando não há recompra atribuída, quando não há investimento em monetização ou quando a atribuição de pedidos não está disponível.

LTV dos clientes adquiridos no período: média da receita total de cada cliente ao longo da vida × marginPercent / 100.

LTV médio de toda a base de clientes da organização, sem filtro de período, × marginPercent / 100. Compare com ltv: se o LTV do período não cobre o CAC, mas o da base cobre, a questão é o tempo de payback, não o CAC.

Quantas vezes o LTV paga o CAC: ltv ÷ cac. 0 quando cac é 0.

Retorno sobre o investimento em mídia, como razão: (contribution − investment) ÷ investment (ex.: 1.19 = 119%). 0 quando não há investimento.

Lucro vitalício do cliente (ltv − cac): valor líquido por cliente após o custo de aquisição. Usa o ltv do período (considerando a margem); o CAC é independente da margem. Pode ser negativo quando o CAC excede o LTV do período.

Taxa de conversão da etapa Interesse para a etapa Decisão do funil configurado na plataforma, em % (0–100): Decisão ÷ Interesse × 100, no mesmo período. Não depende da margem. null quando a organização não tem a etapa Interesse configurada.

Payback em meses: tempo até a margem acumulada de uma safra de clientes cobrir o custo de aquisição dela, em média ponderada pelo número de clientes das safras que já se pagaram. 0 quando nenhuma safra se pagou no período.

Percentual de margem de contribuição aplicado. 100 quando nenhuma margem está configurada (marginConfigured=false)

Indica se uma margem de contribuição personalizada foi configurada para esta organização

Completude da margem configurada item a item (gateway, imposto, frete e CMV): complete = todos os itens resolvidos; partial = algum item pendente, então a margem é parcial; none = não há composição por item (margem nunca configurada ou configurada como percentual único; diferencie pelos valores de marginConfigured).

Status por item da composição da margem (synced = vindo dos pedidos, configured = informado pelo usuário, pending = não configurado ou com dados ausentes). null quando a organização não tem composição.

Indica se a organização já classificou alguma campanha como aquisição, em qualquer período. Use para diferenciar "nunca classificou campanhas" de "classificou, mas não há dados neste período".

Os mesmos indicadores calculados para o período imediatamente anterior, com o mesmo número de dias (ex.: para 01/03–31/03, o anterior é 29/01–28/02). Exceções: ltv e retentionLtv trazem a base de clientes adquirida até o início do período selecionado, e margin é a margem configurada (não depende do período). null quando a requisição não tem startDate e endDate.

Variação percentual de cada indicador: (atual − anterior) ÷ anterior × 100, comparando com previousPeriod. Para ltv e retentionLtv, compara a base adquirida até o fim com a base adquirida até o início do período. margin é sempre 0. Cada campo é null quando o valor anterior é 0 ou null; o objeto inteiro é null sem startDate e endDate.

Custo real das mercadorias vendidas (CMV), somado apenas nos pedidos que têm custo informado pela plataforma de e-commerce. null (e não 0) quando os dados de custo não estão disponíveis.

Receita dos pedidos que têm CMV real (valor em moeda, não percentual).

Receita dos pedidos sem CMV real (valor em moeda). Somada a revenueWithCmv, resulta na receita total.

De onde veio a margem: cmv_real (todos os pedidos têm CMV real), mixed (só parte tem), configured_percent (nenhum tem, mas há margem configurada) ou no_basis (nem CMV real, nem margem configurada). null quando os dados de custo não puderam ser lidos, o que é diferente de no_basis.

Margem de contribuição usando o CMV real onde existe e a margem configurada no restante: (revenueWithCmv − cogs) + revenueWithoutCmv × marginPercent / 100. Se a margem foi configurada item a item e está completa (marginCompleteness = complete), cada parte desconta seus próprios custos (gateway, imposto, frete e CMV). null (nunca uma soma parcial) quando parte da receita não tem nenhuma base de margem. Não altera contribution, que continua sendo revenue × marginPercent / 100.