> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard de métricas e KPIs de assinaturas na Reval

> Leia o MRR estimado, a receita histórica, as assinaturas ativas e o crescimento da sua base de assinantes pelo admin da Shopify.

O dashboard é a tela inicial da Reval dentro do seu admin da Shopify. Ele mostra quatro indicadores do período com a comparação em relação ao período anterior, um gráfico de crescimento diário, a contagem por status, os motivos de cancelamento e os marcos históricos do negócio.

## Seletor de período

Você escolhe entre **Hoje**, **Ontem**, **Últimos 7 dias**, **Últimos 30 dias** e **Últimos 90 dias**. Os dias de calendário ("Hoje", "Ontem") são calculados no fuso horário da sua loja; os demais são janelas móveis. Os indicadores e o gráfico respondem ao período escolhido, e cada um é comparado com o **período imediatamente anterior de igual duração**. Esse "% vs período anterior" é o que dá sentido ao número: uma cifra de receita não diz nada sozinha, mas um +12% em relação ao período anterior, sim.

<Note>
  **Motivos de cancelamento e os Marcos do negócio são a exceção**: esses blocos são históricos completos e não mudam ao mover o seletor.
</Note>

Cada indicador tem um ícone de informação com a definição da métrica e os valores dos dois períodos, um minigráfico da sua evolução diária, e um clique que leva você à seção com o detalhe.

***

## Os quatro indicadores do período

### Receita por assinatura

A soma dos pedidos de assinatura criados no período — um pedido por cobrança. É dinheiro cobrado, não uma projeção.

### Novas assinaturas

As assinaturas criadas no período.

### Crescimento líquido

Novas assinaturas menos os cancelamentos do período. É o número que resume se a base cresce ou encolhe: você pode ter um bom mês de entradas e ainda assim encolher.

### Produtos vendidos

Unidades incluídas nos pedidos de assinatura do período.

***

## Crescimento por dia

Um gráfico de barras diário com os **ganhos para cima** (novas + retomadas) e as **perdas para baixo** (pausadas + canceladas). Ao passar o mouse por uma barra você vê o detalhamento do dia: novas, retomadas, pausadas, canceladas, e os pedidos e a receita daquela data.

É a visão mais útil para detectar problemas cedo: um pico de cancelamentos concentrado em poucos dias costuma indicar algo pontual (uma mudança de preço, um envio atrasado, uma campanha que atraiu o público errado) mais do que uma deterioração gradual.

***

## Status

Uma fileira com a contagem atual por status — **Ativas**, **Pausadas**, **Canceladas** e **Pendentes** — com acesso direto à lista de [Assinaturas](/pt/lojista/assinaturas).

***

## Marcos do negócio

Um painel lateral com os acumulados históricos, independentes do seletor de período:

* **Assinaturas ativas** — quantas estão cobrando hoje, e o total histórico de assinaturas criadas.
* **MRR estimado** — a receita recorrente mensal normalizada da sua base ativa: as frequências diferentes da mensal são convertidas ao equivalente mensal. Ele se chama *estimado* porque projeta o que seria cobrado se nada mudar; não é dinheiro cobrado.
* **Receita histórica** — o dinheiro efetivamente cobrado desde o início, com a quantidade de pedidos.
* **Produtos vendidos** — unidades históricas enviadas por assinatura.

***

## Motivos de cancelamento

Uma lista de por que os seus assinantes saíram, ordenada do maior para o menor. Diferente do resto do painel, **é histórico completo**: não responde ao seletor de período.

<Warning>
  A lista mistura dois fenômenos distintos e vale lê-los separadamente, porque eles se resolvem de maneiras opostas.
</Warning>

### Saídas voluntárias

O cliente escolheu sair e disse por quê. São os motivos que o portal oferece:

* Está muito caro
* Tenho produto acumulado
* Quero outro produto
* Problemas com a entrega
* Já não preciso mais
* Outro

Informar o motivo é opcional, então você também vai ver **Não especificado** — são as saídas de quem escolheu "Prefiro não dizer". Essa linha ser grande não é um problema de dados: é o normal.

Cada um aponta para uma ação diferente. *Está muito caro* discute o seu preço ou o seu plano. *Tenho produto acumulado* quase sempre significa que a frequência é alta demais, e se corrige oferecendo um intervalo mais longo em vez de perder o cliente. *Problemas com a entrega* não é um problema de produto, mas de logística.

### Saídas involuntárias

O cliente nunca decidiu sair: **o mandato caiu porque as cobranças falharam**. Elas aparecem com estas etiquetas:

* Cobrança recusada por saldo insuficiente
* Cobrança recusada pelo banco
* Cobrança recusada — quando o Mercado Pago não precisa o motivo

São geradas sozinhas quando o MP esgota as tentativas e cancela o mandato. Ninguém as escolheu.

<Note>
  A distinção é o que decide onde colocar o esforço. Um pico de saídas voluntárias se ataca com produto, preço ou frequência. Um pico de **cobranças recusadas** é um problema de recuperação de pagamentos: se ataca avisando o cliente em tempo para que ele atualize o cartão. Confundi-los leva a baixar preços quando o problema era um cartão vencido.
</Note>

A recuperação depende do cliente: **só ele pode trocar o cartão, pelo portal**, porque os tokens do Mercado Pago são emitidos com o titular presente. Você não pode fazer isso em nome dele pelo admin.

Isso faz com que avisar em tempo seja toda a estratégia. Enquanto o Mercado Pago tenta de novo, o cliente pode entrar no portal e trocar o meio de pagamento sem perder a assinatura. Se o mandato já foi cancelado, ele ainda pode **reativá-la** pelo portal com um cartão novo. Monte um fluxo no Klaviyo ou no Shopify Flow sobre o evento **Cobrança falhada** que o leve direto para lá: cada dia que passa sem esse aviso é um cliente que ficou sabendo tarde.

***

## Sobre as cobranças recusadas

<Warning>
  O dashboard **não tem uma métrica de recuperação de cobranças**, porque a Reval não repete cobranças. Quando o Mercado Pago recusa uma cobrança, é o MP que tenta de novo por conta própria, com o critério e a cadência dele. A Reval registra a recusa e a torna visível, mas não a gerencia.
</Warning>

Onde ver o status das cobranças com problemas:

* Em **Assinaturas**, as que têm uma cobrança recusada aparecem marcadas
* No **detalhe de cada assinatura**, a timeline mostra a recusa com o motivo traduzido, e as cobranças que o MP ainda está revisando
* Se as tentativas do MP se esgotarem, o MP cancela o mandato e a assinatura passa a cancelada, com o motivo registrado na timeline

***

## O que você não vai encontrar aqui

Estas métricas ainda não existem, e vale saber antes de procurá-las:

| Métrica                          | Status                                            |
| -------------------------------- | ------------------------------------------------- |
| Cohorts de retenção              | Não implementada                                  |
| LTV por assinante                | Não implementada                                  |
| Projeção de receita futura       | Não implementada                                  |
| Taxa de recuperação de cobranças | Não se aplica — a Reval não repete cobranças      |
| Detalhamento diário em tabela    | Não implementada; existe o gráfico de crescimento |

Para uma análise mais profunda, os dados crus saem pelas exportações das seções de Assinaturas e Pedidos.
