Wklej swój identyfikator pomiaru GA4 w Ustawienia → Google Analytics. Widget przesyła każdą interakcję do Twojej istniejącej właściwości, z dołączonym identyfikatorem agenta do filtrowania.
Większość zespołów już korzysta z Google Analytics. Teraz Twój widget AI może bezpośrednio do niego przesyłać dane. Integracja Google Analytics pozwala Ci zobaczyć zaangażowanie widgetu obok wszystkich innych danych na Twojej stronie — w tych samych pulpitach, segmentach i raportach, którym już ufasz.
G-XXXXXXXXXX — znajdź go w GA4 → Administrator → Strumienie danych → Twój strumień)To wszystko. Widget wykrywa nowy identyfikator przy następnym ładowaniu i zaczyna przesyłać zdarzenia. Żadne zmiany w kodzie na Twojej stronie. Żadne nowe skrypty śledzące do zarządzania. Tylko administratorzy i właściciele mogą zmieniać identyfikator.
Gdy skrypt osadzający uruchamia się, widget informuje go, do której właściwości GA4 ma wysłać za pomocą WIDGET_GA_INIT postMessage. Skrypt osadzający następnie:
window.gtag, jeśli już jest na stronie — brak podwójnej inicjalizacji, brak konfliktujących wywołań configgtag.js z googletagmanager.com i inicjalizuje go z Twoim identyfikatorem pomiarusend_to: <twój-identyfikator-pomiaru>, aby zdarzenia zawsze trafiały do właściwej właściwości, nawet na stronach z wieloma strumieniami GAPięć interakcji widgetu staje się zdarzeniami GA4:
| Zdarzenie | Nazwa GA4 | Dodatkowe parametry |
|---|---|---|
| Widget otwarty | widget_open | agent_id |
| Widget zamknięty | widget_close | agent_id |
| Wiadomość wysłana | widget_message_sent | agent_id, message_length |
| Odpowiedź AI otrzymana | widget_response_received | agent_id |
| Wystąpił błąd | widget_error | agent_id, error_type |
Każde zdarzenie niesie agent_id, więc możesz filtrować według konkretnych agentów w GA4 — przydatne, jeśli uruchamiasz kilka agentów w jednej organizacji. message_length (liczba znaków) pozwala odróżnić krótkie zapytania od szczegółowych, bez przechwytywania treści wiadomości. error_type oznacza błędy według kategorii (sieciowe, autoryzacja, limit szybkości) dla pulpitów diagnostycznych.
Treść wiadomości nigdy nie jest wysyłana do Google Analytics. Tylko metadane są przesyłane: typ zdarzenia, identyfikator agenta, długości numeryczne i kategorie błędów. Widget działa w kontekście Twojej strony, więc istniejący baner zgody na pliki cookie i mechanizmy zgodności z GDPR kontrolują, czy śledzenie jest uruchamiane — dokładnie tak, jak robią to dla reszty Twojej strony.
Jeśli Twoja strona już ładuje GA4, widget wykrywa window.gtag i używa go bezpośrednio. Jeśli nie, ładuje gtag.js używając Twojego identyfikatora pomiaru. W każdym przypadku zdarzenia trafiają do tej samej właściwości GA4 z tym samym kontekstem sesji, co reszta Twojej strony — więc interakcje widgetu pojawiają się naturalnie w Twoich ścieżkach użytkowników, lejkach konwersji i segmentach odbiorców.
Dane dotyczące zaangażowania widgetu zawsze istniały w Twoim pulpicie Companin. Ta integracja sprawia, że stają się częścią Twojego szerszego obrazu analitycznego — przypisane do tych samych sesji, tych samych użytkowników i tych samych celów, co wszystko inne, co mierzysz. Koniec z przełączaniem się między narzędziami, aby zrozumieć, czy widget pomaga konwertować odwiedzających.