> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/google-analytics.md).

# Google analytics

O módulo **Google Analytics** envia um evento personalizado para o Google Analytics 4, permitindo acompanhar ações realizadas pelos clientes durante a conversa no seu painel de análise.

<figure><img src="/files/Y9p64egBAc9I4H9jRSIX" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Google Analytics na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **Google Analytics** para a área de trabalho do fluxo.

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma integração do tipo **Google Analytics** já cadastrada em **Integrações**, com os dados da sua propriedade GA4. Se ainda não tiver uma, cadastre primeiro em Integrações e depois volte a este módulo para selecioná-la.
{% endhint %}

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

<figure><img src="/files/KX6RANalNox5QBGS3KYA" alt=""><figcaption><p>Imagem 2 - Painel de configuração do módulo Google Analytics aberto.</p></figcaption></figure>

***

#### 📋 Campos de configuração

| Campo                  | O que preencher                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Nome da integração** | Selecione a integração Google Analytics já cadastrada em Integrações                                                      |
| **Nome do evento**     | Nome do evento a ser registrado no Google Analytics (até 24 caracteres, sem espaços — eles são removidos automaticamente) |
| **Parâmetros**         | Um ou mais pares de nome/valor com informações adicionais do evento                                                       |

{% hint style="info" %}
Você pode adicionar quantos parâmetros precisar, clicando em **Adicionar parâmetro**. Pelo menos um parâmetro é obrigatório.
{% endhint %}

***

#### 🔀 Saída do módulo

O módulo tem uma única saída, opcional: **Continuar automaticamente**. Se não conectada, o fluxo simplesmente encerra após o envio do evento.

{% hint style="warning" %}
Este módulo não possui uma saída de erro. Se o evento não for enviado corretamente (por exemplo, integração inválida ou falha de conexão), o fluxo segue normalmente sem nenhum aviso. Confira os relatórios do Google Analytics periodicamente para confirmar que os eventos estão chegando como esperado.
{% endhint %}

<figure><img src="/files/sWGmT0x3HUnBeqkd4YfA" alt=""><figcaption><p>Imagem 5 - Exemplo de saída conectada.</p></figcaption></figure>

***

### 💡 Caso de uso

**Cenário:** uma empresa quer acompanhar, no Google Analytics, quantos clientes concluem uma compra através do chatbot.

**Configuração:**

1. Adicione o módulo **Google Analytics** ao fluxo, no ponto em que a compra é confirmada.
2. Selecione a integração Google Analytics já cadastrada.
3. No campo **Nome do evento**, informe `compra_concluida`.
4. Em **Parâmetros**, adicione informações como o valor da compra, usando variáveis do fluxo.

**Resultado:** cada compra concluída pelo chatbot gera um evento no Google Analytics, permitindo acompanhar esse indicador no painel de relatórios.

***

### 📌 Dicas úteis

* Use nomes de evento consistentes com os já usados no restante do seu site/aplicativo, para facilitar a análise no Google Analytics.
* Como não há uma saída de erro, confira periodicamente os relatórios do Google Analytics para garantir que os eventos estão sendo registrados.
* Use os parâmetros para enriquecer o evento com dados relevantes da conversa, como valores, categorias ou identificadores.

***

### 📝 Resumo

* O módulo **Google Analytics** envia um evento personalizado para o Google Analytics 4.
* Os campos de configuração são **Nome da integração**, **Nome do evento** e **Parâmetros**.
* O fluxo sempre continua normalmente após este módulo, mesmo em caso de falha no envio do evento.