Integracje / PostHog

Dokumenty i dane firmy

Integracja AI: PostHog

Podłączamy PostHog przez REST API do endpointów lejków, retencji, sesji i feature flags. Asystent czyta logi kliknięć z nagrań sesji, porównuje kohorty według person_properties i ocenia, jak aktywne przełączniki funkcji zmieniają zachowanie użytkowników.

Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

Narzędzie „Lejki konwersji w PostHog” w portalu redAi, ekran z danymi z programu PostHog
Narzędzie „Lejki konwersji w PostHog” w Waszym portalu. Dane przykładowe.

W skrócie

Jak asystent AI łączy się z systemem PostHog?

Łączymy się przez REST API PostHog. Klucz Personal API Key generujecie w Settings → Personal API Keys, wskazujecie project ID i asystent wysyła zapytania do endpointów /api/projects/{id}/... z nagłówkiem Authorization.

Na start potrzebujemy
Personal API Key z Settings → Personal API Keys w koncie PostHog.
Czego asystent nie robi
Nie zmienia żadnych danych w PostHog: nie edytuje zdarzeń, kohort ani flag funkcji bez potwierdzenia.
Gdzie są dane
Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.

Dane z PostHog w czacie i we własnym module

Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Lejki konwersji w PostHog. W portalu budujemy moduł, który łączy się z PostHog API i pokazuje wszystkie monitorowane lejki konwersji w jednym miejscu: platformę, krok odpadów i tygodniowy trend. Zespół widzi od razu, które lejki wymagają uwagi, bez logowania do PostHog i bez szukania właściwego projektu.

  • Pobiera lejki z PostHog API z podziałem na $os i $device za ostatnie 30 dni
  • Wykrywa kroki z odpórem wyraźnie wyższym na jednej platformie i oznacza je alertem
  • Liczy tygodniową zmianę konwersji i porównuje z poprzednim tygodniem w pp
  • Otwiera kartę ze szczegółami kroków i ścieżkami sesji powiązanymi z odpórem
  • Eksportuje zestawienie lejków do XLSX na żądanie
Rozmowa z asystentem AI w portalu redAi o danych z programu PostHog: Retencja tygodniowa: plan Pro vs Free (PostHog)

Pytanie w czacie

Asystent pobiera dane kohortowe z PostHog, zestawia je tygodniami i wskazuje wprost, kiedy i która grupa zaczyna odpadać.

Sprawdź w PostHog, jak retencja użytkowników z planem Pro wypada tygodniami w porównaniu z planem Free. Chcę wiedzieć, kiedy Free odpada wyraźnie szybciej i czy różnica rośnie po tygodniu 1.
Karta Lejek: Rejestracja → aktywacja (iOS) w narzędziu Lejki konwersji w PostHog w portalu redAi

Karta w narzędziu

Każdy lejek z tabeli otwiera kartę z pełnym podziałem kroków, historią zmian i podpowiedzią, co sprawdzić jako pierwsze.

Moduł zbiera dane z PostHog API i układa je w jeden przegląd: bez logowania do PostHog, bez ręcznego szukania między projektami.

Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.

Co podłączamy

Zaczynamy od odczytu danych. Zapis i akcje w systemie PostHog włączamy dopiero wtedy, gdy sami tego chcecie.

Lejki z segmentacją $os i $device

CzytamyDane lejka z /api/projects/{id}/funnels/ z podziałem na właściwości $os i $device za ostatnie 30 dni.

AsystentWykrywa, czy konkretny krok lejka odpada wyraźnie częściej na jednej platformie niż drugiej, i wskazuje te kroki jako pierwsze do sprawdzenia przez zespół.

Ścieżka sesji po session_id

CzytamyUstrukturyzowany log kliknięć i zatrzymań z konkretnej sesji pobrany przez /api/projects/{id}/sessions/.

AsystentOdtwarza ścieżkę użytkownika krok po kroku: co kliknął, gdzie się zatrzymał i na którym ekranie opuścił aplikację.

Feature flags z $feature_flag_called

CzytamyLista aktywnych przełączników z /api/projects/{id}/feature_flags/ i zdarzenia otagowane polem $feature_flag_called.

AsystentPorównuje lejek grupy z włączoną flagą z grupą kontrolną i mówi wprost, czy nowa funkcja poprawia konwersję, czy nie ma wpływu.

Kohorty na person_properties

CzytamyGrupy użytkowników zdefiniowane przez właściwości osoby: kraj, plan abonamentowy, data dołączenia pobrane z bazy PostHog.

AsystentZestawia retencję wybranych kohort w kolejnych tygodniach i pokazuje, która grupa wraca rzadziej po pierwszym tygodniu niż pozostałe.

Trendy zdarzeń tygodniowe

CzytamyLiczba wystąpień każdego zdarzenia z /api/projects/{id}/trends/ z tygodniowym granulowaniem za ostatnie cztery tygodnie.

AsystentWskazuje trzy zdarzenia, których użycie wzrosło lub spadło najbardziej w stosunku do poprzedniego tygodnia.

Porównanie przed i po deployu

CzytamyDane lejka i retencji pobrane z funnels i trends API dla okresu przed datą wdrożenia i po niej.

AsystentAutomatycznie sprawdza po wdrożeniu, czy główny lejek zmienił się, i dołącza wynik z jednozdaniowym komentarzem do dziennika produktu.

O co pytają w praktyce

Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.

  • „Gdzie użytkownicy odpadają w lejku onboardingu w tym tygodniu?”
  • „Czy nowa funkcja z włączoną feature flagą poprawia kończenie rejestracji?”
  • „Co robił użytkownik, który zamknął aplikację na ekranie płatności?”
  • „Jak retencja kohorty z Polski z planem Pro wypada wobec reszty użytkowników?”

Co się zmienia

Zespół produktowy dostaje co poniedziałek gotowy raport z odpadami w lejkach, wynikiem każdej feature flagi i opisem ścieżki sesji, zamiast ręcznie klikać przez dashboardy.

Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.

O programie

PostHog to open-source platforma analityki produktowej, którą można postawić na własnym serwerze. Zbiera zdarzenia z aplikacji webowych i mobilnych, nagrywa sesje użytkowników jako logi kliknięć i ruchów kursora, a do tego pozwala zarządzać feature flags: przełącznikami włączającymi nową funkcję dla wybranego odsetka użytkowników. Opcja self-hosted ma znaczenie dla firm z wymaganiami RODO.

Na co dzień zespół pracuje z czterema głównymi obszarami: lejkami konwersji, nagraniami sesji, retencją z kohortami i wynikami flag funkcji. Dane w wersji self-hosted trafiają do bazy ClickHouse na własnym serwerze; firmy, które nie chcą stawiać infrastruktury, korzystają z chmury PostHog. Każde zdarzenie ma pola event_name i person_properties, co pozwala segmentować użytkowników po kraju, planie abonamentowym czy dacie dołączenia.

Gdzie to działa najlepiej

Menedżer produktu

W poniedziałek rano przed sprintem menedżer pyta asystenta o wyniki tygodnia: czy lejek onboardingu zmienił się po piątkowym wdrożeniu i które kohorty odpadają na etapie pierwszej akcji.

Z asystentem: Asystent pobiera dane z funnels i trends API, porównuje dwa tygodnie i odpowiada w kilka sekund. Menedżer idzie na spotkanie z liczbami gotowymi, bez czekania na developera.

Programista w zespole

Developer uruchomił nową wersję onboardingu pod feature flagą dla 20% użytkowników. Po trzech dniach pyta asystenta, czy flaga ma mierzalny wpływ na lejek rejestracji i retencję pierwszego tygodnia.

Z asystentem: Asystent pobiera zdarzenia otagowane $feature_flag_called z API, zestawia grupy i mówi, czy różnica jest istotna. Developer decyduje, czy funkcja idzie do wszystkich użytkowników.

Analityk UX

Analityk dostaje zgłoszenie, że użytkownicy z iOS nie kończą zakupu. Prosi asystenta o przejrzenie logów sesji z ostatnich 50 sesji mobilnych na etapie potwierdzenia zamówienia.

Z asystentem: Asystent odczytuje ścieżki z sessions API, wskazuje, gdzie sesje się urywają, i opisuje wzorzec. Analityk dostaje konkretny ekran do sprawdzenia, zamiast ręcznie przewijać nagrania.

Jak się łączymy

Łączymy się przez REST API PostHog. Klucz Personal API Key generujecie w Settings → Personal API Keys, wskazujecie project ID i asystent wysyła zapytania do endpointów /api/projects/{id}/... z nagłówkiem Authorization. Tryb pracy: wyłącznie odczyt. W wersji self-hosted z ClickHousem możliwy jest też bezpośredni dostęp SQL do surowych zdarzeń przy bardzo dużych wolumenach.

Asystent pracuje na serwerze klienta. Przed wysłaniem pytania do modelu AI przycinamy dane do fragmentów potrzebnych do odpowiedzi. Jeśli zdarzenia w Waszym projekcie zawierają e-maile lub inne dane osobowe użytkowników końcowych, konfigurujemy maskowanie na etapie integracji, zanim cokolwiek trafi do modelu.

Czego potrzebujemy od Was

  • Personal API Key z Settings → Personal API Keys w koncie PostHog.
  • Numer project ID: widoczny w adresie URL dashboardu PostHog.
  • Plan PostHog z dostępem do API lejków i feature flags; wersja self-hosted bez ograniczeń planowych.
  • Osoba techniczna znająca nazwy zdarzeń (event_name) i strukturę person_properties w projekcie.
  • Adres instancji: URL chmury PostHog (EU lub US) albo własny URL w przypadku self-hosted.

Czego asystent nie robi

  • Nie zmienia żadnych danych w PostHog: nie edytuje zdarzeń, kohort ani flag funkcji bez potwierdzenia.
  • Nie ogląda plików wideo: czyta tylko ustrukturyzowane logi kliknięć i ruchów kursora z sessions API.
  • Nie pracuje na surowych danych osobowych użytkowników końcowych: przy potrzebie konfigurujemy maskowanie przed wysłaniem do modelu.
  • Nie zastępuje diagnozy kodu: wskazuje wzorzec zachowania, ale przyczynę błędu technicznego szuka developer.

Częste pytania

Czy muszę dawać asystentowi dostęp do wszystkich projektów PostHog?

Nie. Personal API Key możecie wygenerować z uprawnieniami do konkretnego projektu i wskazać tylko ten project ID. Klucz możecie unieważnić w każdej chwili w Settings → Personal API Keys, bez wpływu na resztę konta PostHog.

Co się stanie, gdy zdarzenia mają niespójne nazwy albo brakuje właściwości?

Asystent pokaże wynik na podstawie tego, co znajdzie w API. Niespójne nazewnictwo, np. purchase_complete i purchase_completed jako dwa oddzielne zdarzenia, da niepełne lejki. Na etapie integracji razem z osobą techniczną z Waszego zespołu przejrzymy nazwy zdarzeń i ustalimy, które wchodzą do raportów.

Czy integracja działa z chmurą PostHog i z wersją self-hosted tak samo?

Tak, obie wersje mają ten sam REST API i integracja wygląda identycznie. Różnica: self-hosted daje opcję bezpośredniego zapytania SQL do bazy ClickHouse, co przyspiesza pracę przy bardzo dużych wolumenach zdarzeń. W chmurze PostHog tej opcji nie ma.

Jak często asystent pobiera dane i czy obciąża API PostHog?

Raport tygodniowy odpytuje API raz w tygodniu, w nocy. Zapytania na żądanie przez czat generują kilka wywołań API na pytanie. Przy wyższych wolumenach warto sprawdzić limity planu; wersja self-hosted z dostępem SQL do ClickHouse nie ma tych ograniczeń.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
Wolicie napisać

Pokażemy to na Waszych danych z PostHog

Jedno zdanie wystarczy: czego szukacie w PostHog albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

PostHog jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.