Cards de resumo de aquisição

Indica se a organização configurou uma margem de contribuição na plataforma. false significa que o padrão de 100% está em uso.

Completude da margem de contribuição configurada por itens de custo: complete = todos os itens resolvidos; partial = algum item pendente, então a margem aplicada é parcial; none = sem composição por itens (margem nunca configurada ou configurada como um percentual único; diferencie com 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.

Investimento em mídia TOTAL do período, incluindo brand e monetization. value é sempre um número (0 quando nada foi investido). Sem escala de margem. Este NÃO é o numerador do CAC — veja acquisitionInvestment.

Investimento das campanhas marcadas como aquisição na plataforma (marca, monetização e campanhas sem classificação ficam de fora). É o numerador exato do cac. Sempre um número; 0 significa que nenhuma campanha de aquisição investiu no período, e nesse caso cac vem null. Sem margem aplicada.

Novos clientes atribuídos a essas mesmas campanhas configuradas — o denominador exato de cac, de modo que acquisitionInvestment.value ÷ acquisitionNewCustomers.value = cac.value é válido (salvo o arredondamento de 2 casas decimais de cac). NÃO é newCustomers: dividir o investimento configurado por todos os clientes da organização creditaria à estratégia um tráfego que ela não trouxe e subestimaria o CAC. Sempre um número, e sempre ≤ newCustomers.

Novos clientes adquiridos no período, todos os canais, incluindo orgânico, e todas as campanhas, independentemente da configuração. Este é o KPI de resultado de negócio e o número para o qual as abas de /new-customers-over-time somam — NÃO é o denominador do CAC, que é acquisitionNewCustomers. value é sempre um número (0 quando não há nenhum).

acquisitionInvestment ÷ acquisitionNewCustomers: os dois lados vêm só das campanhas marcadas como aquisição. value é null (nunca 0) quando nenhuma campanha de aquisição investiu no período (inclusive quando nenhuma campanha foi marcada; veja hasAcquisitionClassification) ou quando elas não trouxeram nenhum cliente. Sem margem aplicada.

LTV médio dos clientes trazidos pelas campanhas marcadas como aquisição, já com a margem de contribuição aplicada (diferente do ltv bruto de /v1/acquisition/channels). value é null (nunca 0) quando nenhuma campanha de aquisição investiu no período ou trouxe clientes.

acquisitionAvgLtv ÷ cac. Os dois lados consideram só as campanhas de aquisição, então responde "as campanhas de aquisição se pagam?". É diferente do ltvCacRatio de /v1/acquisition/channels, cujo LTV considera todos os clientes do canal. value é null quando um dos lados é null.

(receita das campanhas de aquisição × margem − acquisitionInvestment) ÷ acquisitionInvestment, como razão decimal (0,42 = 42%). Costuma ser bem menor que um ROI amplo, porque considera só a receita atribuída às campanhas de aquisição, sem vendas orgânicas, diretas ou não atribuídas. value é null (nunca 0 nem −1) quando nenhuma campanha de aquisição investiu no período ou quando elas não trouxeram nenhum cliente, nas mesmas condições em que cac é null.

Payback em meses: média, ponderada pelo número de clientes, do primeiro mês em que a contribuição acumulada de cada grupo de clientes (receita × margem) cobre o custo de aquisição dele. Os grupos são formados por mês de aquisição, então mesmo um período de 7 dias considera meses inteiros. value é null quando nenhum grupo atingiu o payback ou o custo de todos é desconhecido; 0 é real (pagou no próprio mês de aquisição). changePct é sempre null.

Indica se a organização marcou alguma campanha como aquisição na plataforma V4MOS.AI, em qualquer data (não depende do período selecionado). false explica cac, ltvCacRatio, paybackMonths e métricas de aquisição null, e o grupo acquisition vazio em /v1/acquisition/campaigns: não é falta de dados no período, falta marcar as campanhas de aquisição.