Métricas Customizadas

Crie suas próprias métricas de negócio e acompanhe KPIs específicos do seu app

TL;DR

Métricas Customizadas transformam seus eventos em indicadores mensuráveis para otimizar conversão e receita.

O que são Métricas Customizadas?

Métricas Customizadas são queries salvas que calculam KPIs específicos baseados nos eventos rastreados. Com elas você pode:

Calcular taxa de conversão de funis específicos
Medir abandono em etapas críticas do onboarding
Comparar performance entre variantes de testes A/B
Acompanhar receita por segmento ou produto

A vantagem é que você configura a métrica uma vez no dashboard e ela calcula automaticamente, sem precisar escrever código de análise.

Como Funcionam

Métricas são criadas no dashboard (não no SDK). Você configura filtros de eventos e o Paywallo calcula automaticamente.

Configure a métrica no dashboard

Defina eventos, filtros, período e agrupamento

Servidor calcula automaticamente

Query é executada sobre os eventos armazenados no banco de dados

Resultado exibido em card

Veja o valor calculado na página de Métricas Customizadas

Tipos de Métricas

1. Contagem de Eventos (Count)

O que faz: Conta quantos eventos matcham os filtros

Exemplo: Quantos usuários completaram onboarding em iOS nos últimos 7 dias?

Configuração:

Tipo: Contagem
Evento: onboarding_completed
Filtro de propriedade: platform = "ios"
Período: Últimos 7 dias

2. Taxa de Conversão (Conversion)

O que faz: Calcula a porcentagem de usuários que completaram evento B após evento A

Exemplo: Qual % dos usuários que iniciaram onboarding também completaram?

Configuração:

Tipo: Conversão
Evento inicial: onboarding_started
Evento final: onboarding_completed
Período: Últimos 30 dias

3. Soma de Propriedade (Property Sum)

O que faz: Soma valores numéricos de uma propriedade específica

Exemplo: Total de receita gerada por compras em Android?

Configuração:

Tipo: Soma
Evento: purchase_completed
Propriedade para somar: price
Filtro: platform = "android"
Período: Últimos 30 dias

Exemplo Prático

Caso de Uso: Medir impacto de teste A/B em conversão

Você está testando duas versões de onboarding (Variante A vs Control) e quer saber qual converte mais para premium.

1. Configure uma Feature Flag:

Key: onboarding_variant
Control: "old_flow"
Variante A: "new_flow"
Distribuição: 50/50

2. No código, rastreie com a variante:

const { variant } = await Paywallo.getVariant('onboarding_variant'); Paywallo.track('onboarding_completed', { variant: variant, }); Paywallo.track('subscription_started', { variant: variant, });

3. Crie 2 métricas customizadas:

Métrica 1: Conversão Control

Tipo: Conversão
De: onboarding_completed
Para: subscription_started
Filtro: variant = "old_flow"

Métrica 2: Conversão Variante A

Tipo: Conversão
De: onboarding_completed
Para: subscription_started
Filtro: variant = "new_flow"

4. Compare resultados:

Na página de Métricas Customizadas, você verá lado a lado a taxa de conversão de cada variante.

Opções de Configuração

Parâmetros disponíveis

Opção	Valores	Descrição
`Período`	7d, 30d, 90d, personalizado	Janela de tempo para calcular
`Agrupar por`	Dia, semana, mês, variante	Como dividir o resultado (para gráficos)
`Filtros de Evento`	Propriedade/operador/valor	Filtrar eventos por propriedades
`Filtro por Flag`	Feature Flag + variantes	Segmentar por variantes de teste A/B

Métricas não são calculadas em tempo real

Use o botão "Recalcular" na página de Métricas Customizadas para atualizar os valores.

Dicas de Boas Práticas

•Use nomes descritivos para métricas: "Taxa de Conversão Onboarding iOS" é melhor que "Métrica 1"
•Para testes A/B, crie uma métrica para cada variante para facilitar comparação
•Sempre rastreie propriedades relevantes nos eventos (como variant, platform, etc) para poder criar métricas segmentadas depois
•Use agrupamento por dia/semana para visualizar tendências ao longo do tempo