Google Analytics

  ## Co to jest

Ta integracja umożliwia połączenie bota Botpress z Google Analytics, pozwalając na aktualizację profili użytkowników, śledzenie widoków węzłów i niestandardowych zdarzeń bezpośrednio w przepływach bota.

## Jak to działa

Integracja działa poprzez wykorzystanie akcji do interakcji z Google Analytics za pośrednictwem protokołu Measurement Protocol. Oto krótki przegląd akcji:

1. **Update User Profile**: Wysyła aktualizacje profilu użytkownika do Google Analytics.
2. **Track Node**: Śledzi, kiedy określony węzeł bota jest uruchamiany, wysyłając dane zdarzenia na adres Google Analytics.
3. **Track Event**: Wysyła niestandardowe dane zdarzenia do Google Analytics, w tym opcjonalne właściwości zdefiniowane w ładunku.

Działania te wykorzystują Google Analytics Measurement ID i opcjonalnie API Secret do bezpiecznej transmisji danych.

## Funkcje integracji

### Działania

- Aktualizuj profil użytkownika**
  - Wysyła aktualizacje informacji o profilu użytkownika do Google Analytics.
  - Dane wejściowe: ID użytkownika, Profil użytkownika (opcjonalny ciąg JSON metadanych użytkownika)

- Śledź węzeł**
  - Wysyła dane śledzenia dla aktywacji węzła wewnątrz bota do Google Analytics.
  - Dane wejściowe: ID użytkownika, ID węzła

- **Track Event**
  - Wysyła dane niestandardowego zdarzenia do Google Analytics.
  - Dane wejściowe: Identyfikator użytkownika, Nazwa zdarzenia, Ładunek zdarzenia (opcjonalny ciąg JSON właściwości zdarzenia)

### Konfiguracja

- Identyfikator pomiaru**: Ten identyfikator jest wymagany do wysyłania danych do Google Analytics. Identyfikator ten można znaleźć na pulpicie nawigacyjnym Google Analytics w sekcji Administrator > Strumienie danych.
- **API Secret**: Używany do zabezpieczenia transmisji danych. Można go uzyskać w tej samej sekcji, co identyfikator pomiaru, w sekcji Sekrety API protokołu pomiaru.

## Instrukcje konfiguracji

#### Google Analytics Konfiguracja

1. Zaloguj się do panelu Google Analytics .
2. Utwórz lub wybierz istniejącą właściwość GA4.
3. Skonfiguruj lub sprawdź strumień danych, aby uzyskać identyfikator pomiaru i sekret API.

#### Botpress Konfiguracja

1. Kliknij `Install` w prawym górnym rogu i wybierz swojego bota.
2. Postępuj zgodnie z wyskakującymi instrukcjami, aby skonfigurować integrację.
3. Wprowadź swój Google Analytics Measurement ID i, jeśli używasz, API Secret w odpowiednich polach.
4. Włącz integrację, aby zapisać ustawienia.