# Rastrear eventos para análises

Um evento pode ser qualquer coisa que você queira rastrear em um determinado ponto do seu fluxo para que você possa coletar dados para a análise do seu bot. Nesta página, você aprenderá a:

* [Adicionar um passo Rastrear evento](#add-a-track-event-step)
* [Encontrar eventos rastreados nos seus logs de execução](#find-your-execution-logs)

{% hint style="warning" %}
O recurso Rastrear Evento não deve ser confundido com [eventos](https://docs.chatlayer.ai/bot-answers/events) em si, que são usados para acionar um fluxo quando [uma variável mudou](https://docs.chatlayer.ai/bot-answers/events#variables-changed-event) ou quando [um silêncio foi detectado](https://docs.chatlayer.ai/bot-answers/events#silence-detected-event). 
{% endhint %}

## Adicionar um passo Rastrear evento

Para adicionar um passo Rastrear evento ao seu chatbot:

1. Adicione um passo ao seu bloco.
2. Clique `Ações` .
3. Selecione `Rastrear Evento`.

{% hint style="info" %}
Eventos de rastreamento não são compatíveis com [bloco de Condição](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins.md) blocos. Em vez disso, você pode adicionar o recurso Rastrear evento em um [mensagem do bot](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/message-components.md) antes da redireção. 
{% endhint %}

<figure><img src="/files/19f420b5557445ee163d5594a35d0eae9a9a34d5" alt="" width="375"><figcaption><p>Adicionar um passo Rastrear evento ao seu bloco</p></figcaption></figure>

2\. Clique em `Nome`. Uma lista de eventos a serem rastreados aparecerá, se você tiver algum, ou você poderá criar um novo evento a partir daqui.&#x20;

<figure><img src="/files/1c012846f3fba3b88aaf21bcad018c420aeccbf6" alt="" width="375"><figcaption></figcaption></figure>

3. Crie um novo evento digitando um nome em `Nome do Evento`.

{% hint style="info" %}
Certifique-se de criar um evento ou selecionar um existente antes de adicionar chave(s) e valor(es).
{% endhint %}

<figure><img src="/files/04a05eb23b94383e06e046e021c17062852452d5" alt="" width="375"><figcaption></figcaption></figure>

4. No menu suspenso, clique em `Criar`. Uma janela Criar Evento de Rastreamento aparecerá.
5. Em `Descrição do Evento`, adicione um texto que explique sobre o que é este evento.

<figure><img src="/files/a9987819988299d909be4ee8426b1feba1b7a288" alt="" width="375"><figcaption></figcaption></figure>

6. Clique em `Criar`. Seu evento agora está criado.
7. Volte ao seu bloco agora. Defina os atributos que serão salvos com este evento. Atributos são pares de chaves e valores que não são obrigatórios, mas enriquecerão seus dados. Seus valores podem ser informações codificadas diretamente ou variáveis que você coletou anteriormente no seu fluxo.

{% hint style="info" %}
Se você pretende usar uma variável coletada de um [Coletar entrada](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md) bloco como um dos valores de seu atributo, certifique-se de fazê-lo em um bloco que siga a Coleta de entrada.
{% endhint %}

<figure><img src="/files/9c246466fb82a3f3751d263c43440e1d90eb553a" alt="" width="375"><figcaption></figcaption></figure>

8. Salve suas alterações.

## Encontre eventos rastreados nos seus logs de Execução

Quando o bloco onde o recurso Rastrear Evento está for acionado, ele será registrado nos seus logs de execução. &#x20;

Você pode encontrar seus logs de execução em `Histórico` > `Logs de execução` > `Eventos de rastreamento`. Se você atribuiu atributos ao seu evento, eles também aparecerão ali.&#x20;

<figure><img src="/files/d7b44c68f85c9f88c23f9c7e461a818e42605b46" alt=""><figcaption><p>Logs de execução onde você pode encontrar seus eventos rastreados.</p></figcaption></figure>


---

# 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.chatlayer.ai/chatlayer-documentation-pt-br/bot-answers/track-events-for-analytics.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.