Przejdź do treści

Plan śledzenia (tracking plan)

Plan śledzenia (tracking plan) to żywa specyfikacja każdego zdarzenia analitycznego, które śledzi produkt: nazwa zdarzenia, jego właściwości, moment, w którym się uruchamia, i osoba, która za nie odpowiada. To umowa między ludźmi, którzy wdrażają kod, a ludźmi, którzy czytają dane, dzięki której to samo zachowanie jest zawsze zapisywane w ten sam sposób.

Zaktualizowano 2 min czytaniaAutor: fromHello

Najważniejsze wnioski

  1. Jeden wiersz na zdarzenie – nazwa, właściwości, wyzwalacz, właściciel – a plan zmienia się w tym samym pull requeście co kod.

  2. Jedna konwencja nazewnictwa, najczęściej obiekt_akcja w snake_case (subscription_started), sprawia, że po miesiącach nadal da się odpytywać zdarzenia.

  3. Rozjazd – zmiany nazw, duplikaty, brakujące właściwości – po cichu psuje lejki, segmenty i każdy raport, który z nich korzysta.

Co zawiera plan śledzenia?

Co najmniej jeden wiersz na zdarzenie: nazwę zdarzenia, dołączone do niego właściwości, dokładny moment, w którym się uruchamia, i osobę, która za nie odpowiada. Dobre plany zapisują też, które narzędzia otrzymują zdarzenie i na jakie pytanie ma ono odpowiadać – zdarzenie, którego nikt nie odpytuje, to utrzymanie bez zysku. Format jest mniej ważny niż nawyk: arkusz kalkulacyjny, wersjonowany plik w repozytorium czy narzędzie do schematów, takie jak Segment Protocols albo Amplitude Data – wszystko działa, o ile plan jest aktualizowany w tym samym pull requeście co kod śledzący.

Plan śledzenia i pojęcia, z których się składa.

Jak nazywać zdarzenia?

Wybierz jedną konwencję i egzekwuj ją wszędzie. Najczęstsza to obiekt_akcja w snake_case: subscription_started, invoice_paid, report_exported. Najpierw obiekt, żeby powiązane zdarzenia sortowały się razem; akcja w czasie przeszłym, bo zdarzenie zapisuje coś, co się wydarzyło. To, którą konwencję wybierzesz, jest mniej ważne niż jej jednolitość – Sign Up, signup i user_signed_up w jednym zbiorze danych to trzy zdarzenia, które Twoje narzędzie analityczne traktuje jak obce sobie, a każdy wykres na nich oparty jest błędny.

Czym jest rozjazd śledzenia i dlaczego zabija analitykę?

Rozjazd (drift) to luka, która otwiera się między planem a tym, co kod faktycznie wysyła: zdarzenie dostaje nową nazwę bez aktualizacji planu, właściwość zmienia typ, pojawia się duplikat pod drugą nazwą. Każda zmiana jest drobna; razem sprawiają, że lejki zaniżają liczby, segmenty dynamiczne przestają obejmować użytkowników, których powinny, a panele dryfują w stronę fikcji – i wtedy zespół całkowicie przestaje ufać danym. Lekarstwo jest proceduralne, a nie techniczne: żadne zdarzenie nie trafia na produkcję bez wpisu w planie, a przegląd tego wpisu jest częścią code review.

Dlaczego to ważne dla dwuosobowego zespołu

Małe zespoły pomijają plan, bo wydaje się procedurą dla firmy, którą jeszcze nie są. Logika działa odwrotnie: przy dwóch osobach w październiku nikt nie pamięta, dlaczego istnieją jednocześnie checkout_completed i order_completed. Jednostronicowy plan napisany przed pierwszym zdarzeniem kosztuje jedno popołudnie – to pierwsze zadanie, jakie wykonuje Growth Engineer. O tym, jak plan wpisuje się w kompletną konfigurację, od SDK po zgody, przeczytasz w poradniku dane first-party i śledzenie.

FAQ

Najczęstsze pytania

  • Czym różni się plan śledzenia od słownika danych?

    Plan śledzenia jest normatywny: mówi, co powinno być śledzone, zanim kod trafi na produkcję. Słownik danych jest opisowy: dokumentuje dane, które już istnieją, ze wszystkimi ich wadami. Małe zespoły zwykle łączą jedno z drugim – w jeden dokument, który jest zarazem specyfikacją i punktem odniesienia.

  • Kto powinien odpowiadać za plan śledzenia?

    Jedna wskazana osoba – w małym startupie zwykle ten założyciel, który jest najbliżej danych, albo Growth Engineer. Odpowiedzialność oznacza zatwierdzanie każdego nowego zdarzenia i odrzucanie nazw łamiących konwencję, a nie osobiste pisanie każdego wpisu.

  • Ile zdarzeń powinien zawierać plan śledzenia?

    Mniej, niż się spodziewasz. Zacznij od zdarzeń, których potrzebuje Twój lejek i metryka aktywacji, a kolejne dodawaj tylko wtedy, gdy wymaga tego realne pytanie. Każde zdarzenie to zobowiązanie do utrzymania; zarówno Segment, jak i Amplitude zalecają utrzymywanie oszczędnej taksonomii.

  • Jakie narzędzia mogą egzekwować plan śledzenia?

    Narzędzia do walidacji schematów – Segment Protocols, Amplitude Data, Avo – blokują lub oznaczają zdarzenia niezgodne z planem. Bez nich linter nazw zdarzeń plus jedna reguła przeglądu (żadnego nowego zdarzenia bez wpisu w planie) wyłapuje większość rozjazdów w skali dwuosobowego zespołu.

fromHello to oprogramowanie open source do automatyzacji marketingu: wiadomości uruchamiane przez to, co robią ludzie.

fromHello Cloud udostępniamy w ramach wczesnego dostępu, przez listę oczekujących.

Wczesny dostęp

fromHello Cloud

Nikt nie zakłada firmy, żeby była mała.

Wczesny dostęp do fromHello Cloud otwieramy etapami. Onboarding prowadzimy razem z Tobą: pomagamy wszystko skonfigurować i przenieść Twoje kontakty.

Napiszemy do Ciebie, gdy otworzymy Ci dostęp. Bez spamu.

Jeszcze nie teraz? Zobacz na GitHubie