Google Analytics

  ## Was es ist

Diese Integration ermöglicht es Ihnen, Ihren Botpress Bot mit Google Analytics zu verbinden. So können Sie Benutzerprofile aktualisieren, Knotenansichten und benutzerdefinierte Ereignisse direkt in den Abläufen Ihres Bots verfolgen.

## Wie es funktioniert

Die Integration funktioniert über Aktionen, die über das Messprotokoll mit Google Analytics interagieren. Hier ist ein kurzer Überblick über die Aktionen:

1. **Benutzerprofil aktualisieren**: Sendet Aktualisierungen des Benutzerprofils an Google Analytics.
2. **Knoten verfolgen**: Verfolgt, wann ein bestimmter Knoten innerhalb Ihres Bots ausgelöst wird, und sendet Ereignisdaten an Google Analytics.
3. **Ereignis verfolgen**: Sendet benutzerdefinierte Ereignisdaten an Google Analytics, einschließlich optionaler Eigenschaften, die in der Nutzlast definiert sind.

Diese Aktionen verwenden die Google Analytics Measurement ID und optional ein API-Geheimnis für die sichere Datenübertragung.

## Integrationsmerkmale

### Aktionen

- **Benutzerprofil aktualisieren**
  - Sendet Aktualisierungen der Benutzerprofilinformationen an Google Analytics.
  - Eingaben: Benutzer-ID, Benutzerprofil (optionaler JSON-String mit Benutzer-Metadaten)

- **Knoten verfolgen**
  - Sendet Tracking-Daten für die Knotenaktivierung innerhalb des Bots an Google Analytics.
  - Eingaben: Benutzer-ID, Knoten-ID

- **Ereignis verfolgen**
  - Sendet Daten für ein benutzerdefiniertes Ereignis an Google Analytics.
  - Eingaben: Benutzer-ID, Ereignisname, Ereignis-Nutzdaten (optionale JSON-Zeichenkette mit Ereigniseigenschaften)

### Konfiguration

- **Messungs ID**: Diese ID ist erforderlich, um Daten an Google Analytics zu senden. Sie finden diese ID in Ihrem Google Analytics Dashboard unter Admin > Data Streams.
- **API Geheimnis**: Wird verwendet, um die Datenübertragung zu sichern. Sie finden es im selben Abschnitt wie die Messungs-ID unter Messprotokoll-API-Geheimnisse.

## Anweisungen zur Einrichtung

#### Google Analytics Einrichtung

1. Melden Sie sich bei Ihrem Google Analytics Dashboard an.
2. Erstellen Sie eine GA4-Eigenschaft oder wählen Sie eine bestehende aus.
3. Konfigurieren oder überprüfen Sie Ihren Datenstrom, um die Messungs-ID und das API-Geheimnis zu erhalten.

#### Botpress Einrichtung

1. Klicken Sie oben rechts auf `Installieren` und wählen Sie Ihren Bot aus.
2. Folgen Sie den Popup-Anweisungen, um Ihre Integration zu konfigurieren.
3. Geben Sie Ihre Google Analytics Measurement ID und, falls verwendet, das API Secret in die entsprechenden Felder ein.
4. Aktivieren Sie die Integration, um Ihre Einstellungen zu speichern.