## O que é Esta integração permite-lhe ligar o seu bot Botpress a Google Analytics, permitindo-lhe atualizar perfis de utilizador, acompanhar visualizações de nós e eventos personalizados diretamente nos fluxos do seu bot. ## Como funciona A integração funciona usando ações para interagir com Google Analytics por meio do Protocolo de medição. Aqui está uma breve visão geral das ações: 1. **Update User Profile**: Envia actualizações do perfil do utilizador para Google Analytics. 2. **Track Node**: Rastreia quando um nó específico dentro do seu bot é acionado, enviando dados do evento para Google Analytics. 3. **Track Event**: Envia dados de eventos personalizados para Google Analytics, incluindo propriedades opcionais definidas no payload. Estas acções utilizam Google Analytics Measurement ID e, opcionalmente, um API Secret para uma transmissão segura de dados. ## Características de integração ### Acções - Atualizar perfil de utilizador - Envia actualizações às informações do perfil do utilizador para Google Analytics. - Entradas: ID do utilizador, Perfil do utilizador (cadeia JSON opcional de metadados do utilizador) - Rastrear Nó** - Envia dados de rastreio para ativação de nós no bot para Google Analytics. - Entradas: ID do utilizador, ID do nó - Rastrear evento - Envia dados para um evento personalizado para Google Analytics. - Entradas: ID de utilizador, Nome do evento, Carga útil do evento (cadeia JSON opcional de propriedades do evento) ### Configuração - ID de medição**: Este ID é necessário para enviar dados para Google Analytics. Pode encontrar este ID no seu painel de controlo Google Analytics em Admin > Data Streams. - **Segredo da API**: Utilizado para proteger a transmissão de dados. Pode ser obtido na mesma secção que o ID de medição em Segredos da API do protocolo de medição. ## Instruções de configuração #### Google Analytics Configuração 1. Inicie sessão no seu painel de controlo Google Analytics . 2. Crie ou seleccione uma propriedade GA4 existente. 3. Configure ou verifique seu fluxo de dados para obter o ID de medição e o segredo da API. #### Botpress Configuração 1. Clique em `Install` no canto superior direito e seleccione o seu bot. 2. Siga as instruções do popup para configurar a sua integração. 3. Introduza o seu Google Analytics Measurement ID e, se estiver a utilizar, o API Secret nos campos apropriados. 4. Active a integração para guardar as suas definições.
