> For the complete documentation index, see [llms.txt](https://vertte-app.gitbook.io/ajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vertte-app.gitbook.io/ajuda/secoes-lojistas/dashboard-afiliados.md).

# Dashboard (Visão Lojista)

### Como Utilizar

<figure><img src="/files/NrACdieD6Pw8VR5BbrDR" alt=""><figcaption></figcaption></figure>

O **Dashboard** é a primeira tela que você verá ao acessar a Vertte. Ele funciona como um **resumo completo do desempenho da sua loja** com base nas ações dos seus afiliados.

Aqui, você acompanha:

* Suas **vendas totais** (com e sem comissão),
* O **ticket médio** dos pedidos,
* O número de **transações realizadas**,
* E o valor total de **comissões geradas**.

Além disso, você pode filtrar o período que deseja analisar e visualizar os **pedidos mais recentes com uso de cupons ou UTMs**.

***

### 🗓 Como usar os filtros do Dashboard

Logo no topo da tela, você pode selecionar:

* **Um intervalo de datas personalizado**, clicando no calendário;
* **Um afiliado específico**, usando o campo “Filtre por afiliado”;

<figure><img src="/files/ebapElGjOXgyLFpOvcdr" alt=""><figcaption><p>Filtro por afiliados na seção dashboard</p></figcaption></figure>

* **O status do pedido**, caso queira refinar a análise:
  * Pedido efetuado
  * ⁠Aguardando pagamento
  * ⁠Pedido pago
  * ⁠Faturado
  * ⁠Pedido em separação
  * ⁠Pedido em produção
  * ⁠Pedido enviado
  * ⁠Pedido entregue
  * ⁠Pedido pronto para retirada
  * ⁠Pedido cancelado

<div data-full-width="true"><figure><img src="/files/4ENz37HCoF7RKh9jHsdc" alt="" width="375"><figcaption><p>Detalhes dos filtros da seção dashboard</p></figcaption></figure></div>

> 💡O intervalo máximo de datas para filtro é de **90 dias**. Você pode analisar desde um único dia até 3 meses inteiro

Para **resetar** qualquer filtro aplicado, clique em **"Limpar filtros"**.

***

### Quais pedidos são considerados?

A visualização de dados do dashboard considera **todos os pedidos** da loja no período selecionado.&#x20;

* **Pedidos comissionáveis** são aqueles que:
  * Possuem **cupom válido e vinculado a um afiliado**, ou
  * Utilizaram uma **UTM ativa vinculada a um afiliado**
  * Estão com status definido como comissionável na configuração da loja
  * Estão dentro do intervalo de datas filtrado

***

### Entendendo cada métrica (KPI)

Cada caixinha do dashboard representa um indicador importante. Veja o que cada uma delas significa:

**💳 Vendas Totais**

> **Soma de todos os pedidos realizados na sua loja** dentro do período selecionado, **independente de serem comissionáveis ou não**.\
> Também mostra o valor total de descontos aplicados nesses pedidos.

**💸 Ticket Médio**

> **Média de valor por pedido** (valor total / número de pedidos).\
> Inclui também o **frete médio** cobrado no período.

**🛍 Transações**

> Número total de pedidos registrados no período.\
> Logo abaixo, você verá quantos desses são **comissionáveis**, ou seja:

* Usaram um cupom ativo vinculado a um afiliado, ou
* Vieram de um link com UTM ativa associada a um afiliado,
* E estão com status que permite comissão (definido nas configurações da loja).

**🪙 Comissão**

> Soma do valor de comissão gerada apenas pelos **pedidos comissionáveis** no período.\
> Esse cálculo considera as regras definidas na aba **“Comissionamento”**, como por exemplo:

* Se a comissão é sobre o valor total ou sem o frete;
* A porcentagem ou valor fixo configurado por afiliado.

<figure><img src="/files/F6QroCY5zPNpSD0asVds" alt=""><figcaption><p>Aba de comissões na seção <strong>comissionamento</strong></p></figcaption></figure>

{% hint style="info" %}
Acesse a seção [**Comissionamento**](/ajuda/secoes-lojistas/openapi-1.md) para mais detalhes sobre as configurações;
{% endhint %}

***

### O que aparece em “Pedidos recentes”?

Na parte inferior do dashboard, você verá a lista de **pedidos mais recentes** que utilizaram **cupons ou UTMs** vinculadas a afiliados.

<figure><img src="/files/rp1KO7lweYD0EdBgJFVZ" alt=""><figcaption><p>Pedidos recentes na seção dashboard</p></figcaption></figure>

Essa área é útil para:

* Verificar se os pedidos estão sendo identificados corretamente;
* Acompanhar rapidamente o desempenho dos afiliados;
* Confirmar se os cupons estão sendo utilizados no checkout.

> ⚠️ Caso ainda não haja nenhum pedido com uso de cupom ou UTM, essa seção aparecerá vazia com uma mensagem explicativa.

### Exemplo prático

Vamos supor o seguinte cenário, filtrando os últimos 30 dias:

<table><thead><tr><th width="130.004638671875">Pedido</th><th>Status</th><th width="104">Origem</th><th>UTM</th><th width="154.4000244140625">Afiliado vinculado?</th><th width="117.5999755859375">Valor Total</th><th>Comissão</th></tr></thead><tbody><tr><td>001</td><td>Faturado</td><td>UTM_Promo</td><td>(vazio)</td><td>sim</td><td>R$ 250,00</td><td>R$ 25,00</td></tr><tr><td>002</td><td>Pedido Pago</td><td></td><td>gabi-afiliada</td><td>sim</td><td>R$ 180,00</td><td>R$ 18,00</td></tr><tr><td>003</td><td>Pedido Pago</td><td></td><td>(vazio)</td><td>não</td><td>R$ 200,00</td><td>-</td></tr><tr><td>004</td><td>Cancelado</td><td></td><td>Facebook</td><td>não</td><td>R$ 100,00</td><td>-</td></tr><tr><td>005</td><td>Pedido Pago</td><td>LUCI</td><td></td><td>sim</td><td>R$ 150,00</td><td>R$ 15,00</td></tr></tbody></table>

Neste exemplo:

* Total de pedidos: **5**
* Pedidos comissionáveis: **3** (001, 002, 005)
* Total em vendas: **R$ 880,00**
* Total em comissão: **R$ 58,00**
* Comissão média: **R$ 19,33**

***

### 💬 Dúvidas Frequentes

**1. O que entra em “vendas totais”?**\
Todos os pedidos da loja no período filtrado, mesmo os que não têm afiliado vinculado.

**2. O que é “ticket médio”?**\
É o valor médio por pedido (vendas totais ÷ total de pedidos).

**3. O que é "frete médio"?**\
É o valor médio do frete cobrado por pedido no período filtrado.

**4. Onde vejo os descontos concedidos?**\
Eles aparecem logo abaixo do valor total de vendas, na caixinha "Vendas Totais".

**5. Como saber quantos pedidos foram comissionados?**\
Essa informação aparece logo abaixo do número total de transações.

**6. Posso analisar períodos longos, como 6 meses?**\
Não. O filtro de datas é restrito a 90 dias e caso você queira expandir, é necessário separar os blocos.

**7. Posso ver os pedidos que usaram cupom?**\
Sim! Eles aparecem em “Pedidos Recentes”, no fim do dashboard.