# 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins) blocos. Em vez disso, você pode adicionar o recurso Rastrear evento em um [mensagem do bot](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/message-components) antes da redireção. 
{% endhint %}

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FIHNQaU2mLLIEwwfXDmnZ%2FScreenshot%202023-10-24%20at%2016.36.50.png?alt=media&#x26;token=5ab01319-384f-462f-9c93-67b2226e3b72" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FNDgxhfDdZDecNaCRRA0F%2FScreenshot%202023-10-24%20at%2016.38.56.png?alt=media&#x26;token=33837beb-450c-4c60-944f-e5bd6d56d7cc" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F9OmA9VAVy17v3Huv8pO3%2FScreenshot%202023-10-24%20at%2016.42.32.png?alt=media&#x26;token=44e09007-3745-435b-b22c-5b3b2c942f49" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FXQQqlii9pKkHHe3ooaLQ%2FScreenshot%202023-10-24%20at%2016.44.08.png?alt=media&#x26;token=82d767cb-c481-469e-b4ab-c5e48d08c961" 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog) 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F6cz7POkHkfUbLAV6Gj2O%2FScreenshot%202023-10-24%20at%2016.46.17.png?alt=media&#x26;token=d854b4dd-2f45-4d49-af9d-6a0ae103afef" 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="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FZ6zSSJwgKv8KPejARnjy%2FScreenshot%202023-10-24%20at%2016.47.47.png?alt=media&#x26;token=093178c7-caa2-407a-9684-78ad579e10ae" alt=""><figcaption><p>Logs de execução onde você pode encontrar seus eventos rastreados.</p></figcaption></figure>