Google Analytics

  ## Ce que c'est

Cette intégration vous permet de connecter votre bot Botpress à Google Analytics, ce qui vous permet de mettre à jour les profils des utilisateurs, de suivre les vues des nœuds et les événements personnalisés directement dans les flux de votre bot.

## Comment ça marche

L'intégration fonctionne en utilisant des actions pour interagir avec Google Analytics via le protocole de mesure. Voici un bref aperçu des actions :

1. **Mise à jour du profil de l'utilisateur** : Envoie les mises à jour du profil de l'utilisateur à Google Analytics.
2. **Track Node** : Permet de suivre le déclenchement d'un nœud spécifique au sein de votre robot, en envoyant les données relatives à l'événement à Google Analytics.
3. **Track Event** : Envoie des données d'événement personnalisées à Google Analytics, y compris les propriétés facultatives définies dans la charge utile.

Ces actions utilisent l'identifiant de mesure Google Analytics et éventuellement un secret API pour une transmission sécurisée des données.

## Caractéristiques d'intégration

### Actions

- **Mise à jour du profil de l'utilisateur**
  - Envoie les mises à jour des informations du profil de l'utilisateur à Google Analytics.
  - Entrées : ID de l'utilisateur, profil de l'utilisateur (chaîne JSON facultative de métadonnées de l'utilisateur)

- **Track Node** (Suivi du nœud)
  - Envoie les données de suivi pour l'activation des nœuds dans le bot à Google Analytics.
  - Données d'entrée : ID de l'utilisateur, ID du nœud

- **Track Event** (Suivi d'un événement)
  - Envoie les données relatives à un événement personnalisé à Google Analytics.
  - Entrées : ID utilisateur, nom de l'événement, charge utile de l'événement (chaîne JSON facultative contenant les propriétés de l'événement).

### Configuration

- **Measurement ID** : Cet identifiant est nécessaire pour envoyer des données à Google Analytics. Vous pouvez trouver cet identifiant dans votre tableau de bord Google Analytics sous Admin > Data Streams.
- **Secret API** : Utilisé pour sécuriser la transmission des données. Il peut être obtenu dans la même section que l'ID de mesure, sous Secrets API du protocole de mesure.

## Instructions de configuration

#### Google Analytics Configuration

1. Connectez-vous à votre tableau de bord Google Analytics .
2. Créez ou sélectionnez une propriété GA4 existante.
3. Configurez ou vérifiez votre flux de données pour obtenir l'ID de mesure et le secret API.

#### Botpress Configuration

1. Cliquez sur `Install` en haut à droite et sélectionnez votre bot.
2. Suivez les instructions pour configurer votre intégration.
3. Entrez votre ID de mesure Google Analytics et, si vous l'utilisez, le secret API dans les champs appropriés.
4. Activez l'intégration pour enregistrer vos paramètres.