# Análises

Para exibir as ações do cliente do bot na seção "Analytics", você pode usar as configurações de evento e valor para analytics nas configurações do bloco dentro do Builder.

Quando você clica no botão "Analytics", um formulário de entrada de dados é aberto:

<div data-with-frame="true"><figure><img src="/files/c2ca9915e4df56412613bbd682d5502b22ccc368" alt=""><figcaption></figcaption></figure></div>

com os campos:

**Categoria do evento** – um nome geral para determinados eventos no bot:

<div data-with-frame="true"><figure><img src="/files/85e3695d4b641a04751cc261d2dc8ece89651ba6" alt="" width="563"><figcaption></figcaption></figure></div>

Por exemplo, as categorias no bot podem incluir:

a) Ações gerais: chegou, comprou, pagou;\
b) Categorias gerais de produtos: roupas femininas, roupas masculinas, calçados, artigos para o lar etc.;\
c) Categorias de serviços: cortes de cabelo, manicure etc.

Este campo é opcional na configuração.

Nome do evento, para o qual as estatísticas serão coletadas (campo obrigatório!).

<div data-with-frame="true"><figure><img src="/files/197ee0f64a5e6a03e9f9379ac21041ee00526b80" alt="" width="563"><figcaption></figcaption></figure></div>

Um item específico de uma categoria geral.

Por exemplo, dentro da categoria de ações gerais:\
a) chegou: do bot do Telegram, do bot do VK, do bot do WhatsApp;\
b) comprou: produto1, produto2, produto3 etc.

Este campo é obrigatório.

Em seguida, você pode especificar um valor para o evento no bot: por exemplo, o cliente pagou um valor específico, comprou uma certa quantidade de produtos etc.:

<div data-with-frame="true"><figure><img src="/files/8b81858421f5f8a3e7e6a03d0a1252c5a474966d" alt="" width="563"><figcaption></figcaption></figure></div>

Valor do evento – um número ou uma variável de cliente/negócio especificada no formato #{cost}:

1. Especificando um valor numérico:

<div data-with-frame="true"><figure><img src="/files/2535c2990f51ecc757d14e24dbe4f453ae5ad7ab" alt="" width="563"><figcaption></figcaption></figure></div>

2. Especificando um valor por meio de uma variável:

<div data-with-frame="true"><figure><img src="/files/0c92240d9030dbe7ce47b1f3073456793791e316" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Os dados são agrupados (somados) por nome e categoria do evento.
{% endhint %}

{% hint style="danger" %}
Por favor, observe!

Os eventos de analytics não são rastreados em blocos cinza (bloco Trigger, bloco Fallback), pois esses blocos são destinados ao envio de notificações, à validação da entrada do cliente no bot, ao início de broadcasts e funções semelhantes.
\
Os blocos cinza são usados para evitar a interrupção da jornada do cliente no funil principal.
{% endhint %}

Quando um cliente passa por um bloco em que os eventos estão configurados, você pode ver os dados na seção "Analytics":

<div data-with-frame="true"><figure><img src="/files/20dbdfaf04c0e1b047cc2a58d280870d04a23dc6" alt="" width="563"><figcaption></figcaption></figure></div>

Você precisa criar um widget na seção "Clients":

<div data-with-frame="true"><figure><img src="/files/f5517150cef7f07f231d3300229c32601e71a65b" alt="" width="563"><figcaption></figcaption></figure></div>

Em seguida, selecione as configurações necessárias:

<div data-with-frame="true"><figure><img src="/files/98755df233a350b8705bf335e3abc79d6dddae80" alt="" width="375"><figcaption></figcaption></figure></div>

1. Especifique o período de analytics
2. Digite o nome do widget
3. Escolha o tipo de visualização de dados para o analytics (gráfico de pizza, gráfico de barras etc.)
4. Selecione os dados a serem exibidos no widget:

<div data-with-frame="true"><figure><img src="/files/ff913917405e2294a6fcff366cc80728c78a8748" alt="" width="563"><figcaption></figcaption></figure></div>

Em seguida, siga estas etapas simples para configurar o rastreamento de eventos de analytics do chatbot:

Etapa 1. Selecione a aba Conversions:

<div data-with-frame="true"><figure><img src="/files/41a1c5243d9732fdd9835c5fa3fa4d985f19870d" alt="" width="375"><figcaption></figcaption></figure></div>

Etapa 2. Especifique os métodos para calcular os dados de Analytics:

<div data-with-frame="true"><figure><img src="/files/ac963654b8b8b3ab2ce93f92d82231e3a178c717" alt="" width="563"><figcaption></figcaption></figure></div>

**O que contar** – parâmetros de cálculo para cada etapa:

<div data-with-frame="true"><figure><img src="/files/0b6f3bce6174d7a24d003e62dfb8f586010121f2" alt="" width="563"><figcaption></figcaption></figure></div>

* **Quantidade** – o número de clientes que passaram pelo evento selecionado.
* **Soma dos valores** – a soma total dos valores do evento para todos os clientes que passaram por ele. Isso pode mostrar a quantidade de produtos vendidos ou a receita total das vendas.
* **Valor médio** – o valor médio do evento para todos os clientes que passaram por ele. Isso pode mostrar quantas unidades de um produto são vendidas, em média, por cliente.
* **Valor mediano** – o valor mediano do evento para todos os clientes que passaram por ele. Isso fornece uma média mais precisa, excluindo valores extremos.

**Como calcular percentuais**

<div data-with-frame="true"><figure><img src="/files/2b284a59f158b224c57f69d2996eac9626a035de" alt="" width="563"><figcaption></figcaption></figure></div>

* Contar a partir da etapa anterior %.
* Contar a partir da primeira etapa.

Etapa 3. Adicione uma etapa para cálculo:

<div data-with-frame="true"><figure><img src="/files/930bd61f64f648f6cc1e99a656e1e78c69afe39c" alt="" width="563"><figcaption></figcaption></figure></div>

Etapa 4. Selecione a categoria (se houver) e o evento que você especificou anteriormente e salvou no bloco do bot:

<div data-with-frame="true"><figure><img src="/files/52eb2cc73ea50f5437f72f1868df85953a4c516a" alt="" width="563"><figcaption></figcaption></figure></div>

Se você precisar exibir apenas um valor específico do evento, insira o valor necessário no campo "Valor do evento":

<div data-with-frame="true"><figure><img src="/files/7d005c84edccc5d6380d77e812c6611ab2654bb7" alt="" width="563"><figcaption></figcaption></figure></div>

Se quiser exibir todos os valores, deixe o campo em branco.

{% hint style="info" %}
Outros recursos de analytics no MaviBot são explicados no artigo "[MaviBot Analytics](/doc/pt/analises-do-mavibot.md)."
{% endhint %}

{% hint style="success" %}
Pronto!&#x20;

Você aprendeu como trabalhar com o editor de fluxo do chatbot MaviBot!
{% 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.mavibot.ai/doc/pt/chatbot/builder/setting/analises.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.