## 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.