# Métricas e indicadores

**Métricas** são **dados brutos** obtidos por meio da troca de mensagens entre usuários e assistentes. Elas serão sempre o resultado da **soma** de um determinado evento.

Já os **indicadores** são criados usando operações de **Subtração, Multiplicação e Divisão sobre as métricas existentes**, ou seja, são cálculos que usam as métricas para obter informações que indicam a performance do assistente virtual.

![](/files/-MZtObXe5UceeSGmCHlF)

Dois indicadores **já estão configurados** no Dashboard da Zenvia NLU, o **NPS e CSAT**. Vamos explicá-los melhor à frente.

## Criar, editar **e excluir** 

**Clique no "criar" com o ícone "+** " que está dentro do card pontilhado para criar uma nova métrica ou indicador. 

![](/files/CaFssWq62Be7CS46FN2J)

**Será preciso escolher:**

* **Nome:** não pode ser repetido;
* **Descrição** campo para descrição da métrica - 100 caractéres; 
* **Operação;**
* **Eventos;**
* **Cor;**

![](/files/wTKTH4Tkn6tEAeZ0OYLA)

Depois disso, irá aparecer um card no dashboard, ele será similar ao exemplo abaixo, e tem algumas funcionalidades:

![](https://t3001453.p.clickup-attachments.com/t3001453/7bca88da-d26e-465e-9e81-7ddbe19c40f0/cardash.png)

* **Edição:** permite mudar todos os valores definidos na criação da métrica ou indicador. Para isso, clique no ícone de lápis.
* **Expandir:** irá apresentar todos os [campos extras](/monitor/eventos.md) configurados nos eventos, e uma contagem da ocorrência desses campos.
* **Excluir:** basta clicar no ícone de lixeira e confirmar. **Nenhum dado da métrica é recuperável após a exclusão.**

{% hint style="warning" %}
É permito criar no máximo 20 cards por Dashboard.
{% endhint %}

Você também pode reordenar os cards da maneira que preferir

![](/files/C9mH7BnZCNvH0FIY9wen)

## Operações

A partir das operações de subtração, multiplicação e divisão entre métricas conseguimos criar indicadores. Use-os como ferramentas para minerar os dados e extrair informações importantes para o negócio e sobre o desempenho do assistente. Todos os cálculos usam os eventos como parâmetros e apresentam os resultados obtidos. Na Zenvia NLU existem 4 opções de operações:

![](/files/vY1qldsKKLLLJoSB4lfD)

**Soma**

* Usa apenas **um evento** e mostra a quantidade **total de ocorrência**s dele.\
  **Exemplo**: ao escolher o evento *new\_dialog* será mostrado no card da métrica a quantidade total de vezes que o assistente iniciou uma nova conversa.

**Subtração**

* A métrica de subtração informará os valores extras existentes tanto no evento 1 quanto no evento 2. Caso o extra possua valor positivo, significa que esse extra apareceu maior número de vezes no evento 1, para valores negativos, significa que o extra apareceu em maior quantidade no evento 2, consequentemente, para valores zerados significa que apareceram a mesma quantidade de vezes em ambos os eventos.

![](/files/IBOIT0YmUl2dL3rH4TMw)

Como pode ser visto no exemplo, para o **extra1**, os valores “**extra1\_event1**” e “**event1**” apareceram com **quantidade positiva**, pois aparecem em sua **maioria no evento 1**. Enquanto os valores “**extra1\_event2**” e “**event2**” aparecem com **quantidade negativa** pois aparecem em sua **maioria no evento 2**. Por último o valor “**extra1**” aparece a **mesma quantidade de vezes em ambos os eventos**, resultando na **quantidade 0**. 

**Multiplicação e divisão**

* Precisam de dois eventos para gerar resultado, formando assim um indicador.
* A ordem na operação é sempre a que você seleciona na criação do card.\
  **Exemplo**: (`evento1 - evento2`; `evento1 * evento2`; `evento1 / evento2`). 

![](https://t3001453.p.clickup-attachments.com/t3001453/f5e6760a-e9f7-4598-85dc-3c7a0840494a/Cart%C3%A3o%20de%20Visita%20Azul%20e%20Dourado%20para%20Instrutora%20de%20Ioga.jpg)

O evento 1 sempre será o aditivo ou fator ou divisor da operação, enquanto o evento 2 será definido como subtrativo ou fator ou dividendo.

### Indicadores

* **NPS** ou Net Promoter Score considera as notas de 0 a 10 dos usuários, calculando o score da seguinte forma: ((`quantidade de notas 9 e 10`) - (`quantidade de notas de 0 a 6`)) / (`quantidade total de notas`).
* **CSAT** avalia a satisfação do usuário (Customer Satisfaction) utilizando as pontuações 1 a 5 (com possibilidade de variação) e a conta realizada considera: (`soma das notas`) / (`quantidade de notas`).

![](/files/ogdjNXf3h0XAhF75uAOd)

### Agrupamento de valores

Ao criar ou editar uma métrica de soma, será disponibilizado a opção de adicionar agrupamento de valores.

![](/files/l0Xx68TPpkiMG6HWJxNq)

Pode ser criado vários grupos que serão aplicados para agrupar valores de extra1 e extra2. 

Em cada grupo é preciso das seguintes informações:

![](/files/-Mb2g6PvD5eaMC94QV7Q)

* Nome
* Valores do grupo
  * exemplos: qualquer valor nos extras iguais a um dos valores do grupo (sim, SIM, S, s, Sim, si) passará a ser contabilizado como Sim.

{% hint style="info" %}
Não é possível cria mais de um grupo com o mesmo nome
{% endhint %}

#### Comparações

Exemplo a ser demonstrado:

*  *escolha, escolha1 e escolha2 -> Escolhas*
* *sim, si, s* -> Sim
* *nao, n -> Não*

{% tabs %}
{% tab title="Com" %}
![](/files/-Mb2h7EmSfCtPVsV9cSF)
{% endtab %}

{% tab title="Sem" %}
![](/files/-Mb2h54Zv0M6cAKtU0S7)
{% endtab %}
{% endtabs %}

{% hint style="info" %}
Não é possível colocar valores igual em agrupamentos diferentes.
{% endhint %}

### Expansão de operações

Relacione o evento 1 com o evento 2, ou seja, comparando e calculando a quantidade de ocorrências de cada valor de extra1 no evento1 com esse mesmo valor de extra1 no evento2. A mesma lógica é aplicada aos valores de extra2 do evento1 e do evento2.

**Exemplo:**

Analisando os exemplos abaixo temos:

* O valor "*Consulta extrato"* ocorreu 9 vezes no extra do evento1 e 5 vezes no extra1 do evento2
* O valor "*200"* ocorreu 7 vezes no extra do evento1 e 7 vezes no extra1 do evento2

![](/files/-McJs36kswFZ2CLFXITf)

![](/files/-McJs8lBY8Z1qE2gHYhJ)

{% hint style="info" %}
Valores de extras encontrado no evento1 mas não encontrado no evento2 são agrupados como "*Restantes*".
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altu.d1.cx/monitor/dashboard/metricas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.