> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/pt/analytics/customers/trabalhando-com-conversoes.md).

# Trabalhando com conversões

## Configuração de eventos de análise em um chatbot

Nas configurações do bloco do fluxograma do chatbot, crie um bloco no qual seja necessário configurar eventos na análise:

Nas configurações do fluxo do chatbot, crie um bloco no qual você configura eventos de análise.

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

Ao clicar no botão ‘Análise’, um formulário de preenchimento é aberto.

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

O formulário contém os seguintes campos:&#x20;

* categoria do evento — um nome geral usado para agrupar eventos no bot.

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

Por exemplo, as categorias de eventos no bot podem incluir:&#x20;

a) ações gerais, como: chegou, comprou, pagou; \
b) categorias amplas de produtos, como: roupas femininas, roupas masculinas, calçados, artigos para casa etc.; \
c) categorias de serviços, como: cortes de cabelo, manicure e assim por diante.&#x20;

Este campo é opcional ao configurar eventos de análise.

* nome do evento — o nome específico do evento que você deseja exibir na análise, como: comprou, demonstrou interesse, pagamento bem-sucedido e assim por diante.

<div data-with-frame="true"><figure><img src="/files/ed4101617a01d23b8328c22d2a0caf03836c3c0b" alt="" width="563"><figcaption><p>O evento de análise é um campo obrigatório</p></figcaption></figure></div>

* valor do evento — um número ou uma variável de cliente/negócio fornecida no formato #{nome\_da\_sua\_variavel}.

<div data-with-frame="true"><figure><img src="/files/a8285e02dffc456a2a6562aab514bd4c08b3e5b5" alt="" width="563"><figcaption><p>Usando uma variável como valor</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/9816a63d6438c2512289e191a8ddc0113e8ed9b8" alt="" width="563"><figcaption><p><strong>Inserindo um valor numérico</strong></p></figcaption></figure></div>

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

{% hint style="warning" %}
Atenção: na seção Conversões — ‘Momento atual’ — os eventos NÃO são contabilizados em blocos sem estado.

* Fallback
* Gatilho
  {% endhint %}

À medida que o cliente avança pelo funil onde os eventos de Análise estão configurados, você pode visualizar os dados coletados na seção ‘Análise’.

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

Você precisa criar um widget na seção ‘Clientes’.

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

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

{% hint style="info" %}
[Você pode encontrar mais detalhes sobre as configurações do widget de análise na seção Clientes neste artigo.](/doc/pt/analytics/customers.md)
{% endhint %}

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

1. especifique o período de análise;
2. insira o nome do widget;
3. escolha como os dados de análise serão exibidos (gráfico de pizza, gráfico de colunas, gráfico de barras etc.);
4. selecione os dados que serão mostrados no widget.

**Etapa 1. Selecione a aba Conversões.**

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

**Etapa 2. Selecione o método de contagem de eventos.**

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

**O que calcular** - parâmetros de contagem de eventos para cada etapa.

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

* **Quantidade —** número de clientes que acionaram o evento.
* **Soma dos valores —** valor total do evento entre todos os clientes.
* **Valor médio —** valor médio do evento por cliente.
* **Valor mediano —** valor mediano do evento excluindo outliers.

**Como calcular %**

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

* **da primeira etapa**&#x20;
* **da última etapa**

**Etapa 3. Adicione uma etapa para contagem.**

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

Etapa 4. Escolha a categoria (se houver) e o evento [que você criou no bloco anteriormente](#analytics-event-setup-in-a-chatbot).

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

Se você precisar mostrar apenas um valor específico do evento, insira-o no campo Valor do evento.

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

**Para incluir todos os valores, deixe o campo em branco**

### Excluir dados de análise

Você pode excluir dados de conversão em Análise → Clientes → botão ‘Excluir dados de análise’.

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

Ao clicar no botão, um formulário é aberto no qual você pode escolher quais dados específicos deseja excluir.

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

1. **Excluir dados por bloco**

Ao escolher excluir dados por bloco, aparecem campos nos quais você pode selecionar os blocos para os quais deseja limpar os dados de conversão, bem como os dados dos clientes.

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

Como mostrado no exemplo acima, você pode selecionar um ou vários blocos para os quais você calculou anteriormente a conversão no widget.

Depois, você pode escolher as categorias de clientes cujos dados devem ser apagados.

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

Se você selecionar ‘Excluir dados do usuário por lista’ (rótulo) no menu suspenso, um campo adicional aparecerá para que você possa escolher a lista de clientes ou os rótulos cujos dados deseja excluir.

2. Excluir dados por categoria e evento

Nesse caso, aparecerão campos para selecionar a categoria e o evento, juntamente com as mesmas opções anteriores para escolher como excluir os dados de conversão com base em diferentes critérios de cliente (excluídos, por rótulo etc.).

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

Você pode excluir os dados de conversão de uma única categoria ou de todas as categorias. Da mesma forma, você pode escolher excluir dados de um evento ou de todos os eventos.

3. Excluir dados por site

Ao escolher excluir dados de conversão por site, será aberto o campo correspondente para selecionar o site necessário: um ou vários.

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

Depois de selecionar os filtros necessários para excluir os dados de conversão, clique no botão ‘Excluir’. Em seguida, aparecerá uma notificação dizendo ‘Dados excluídos com sucesso’.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/analytics/customers/trabalhando-com-conversoes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.