Słownik

Co zawiera plan śledzenia i czego nie jest w stanie wychwycić

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Co zawiera plan śledzenia i czego nie jest w stanie wychwycićCo zawiera plan śledzenia i czego nie jest w stanie wychwycić

W skrócie

8 min czytania

Plan śledzenia to pisemna specyfikacja każdego zdarzenia analitycznego wysyłanego przez produkt: jego nazwy, dokładnego momentu uruchomienia, właściwości i ich typów, źródła oraz osoby odpowiedzialnej. Narzędzia takie jak Segment Protocols i Amplitude Data sprawdzają napływające zdarzenia względem planu, ale Segment zaznacza, że nie może wymagać wywołania Track, bo nie wie, kiedy powinno nastąpić, więc zaplanowane zdarzenie, które nigdy nie dotrze, nie wywoła żadnego naruszenia.

Czym jest plan śledzenia?

W analityce produktowej plan śledzenia to pisemna specyfikacja, która wymienia każde zdarzenie wysyłane przez produkt, dokładny moment jego uruchomienia, przenoszone właściwości wraz z typami, źródło, które je emituje, i osobę za nie odpowiedzialną. Uzgadnia się ją, zanim ktokolwiek napisze kod instrumentacji. Dokumentacja Segment Protocols definiuje go jako "a data spec outlining the events and properties you intend to collect across your Segment Sources." Wersja Amplitude dodaje uzasadnienie każdego wiersza: "A tracking plan defines every event and property you collect, why you collect each one, and which source emits it."

Plan jest umową, a kod śledzący jej realizacją. Gdy się rozjeżdżają, ktoś musi zdecydować, które z nich jest błędne, a bez planu nie ma z czym porównać kodu. Śledzenie zdarzeń to praktyka zapisywania tego, co zrobili użytkownicy. Plan śledzenia to dokument, który określa, co „zrobili” znaczy w przypadku każdego zdarzenia.

Jakich kolumn potrzebuje plan śledzenia?

Plan śledzenia potrzebuje jednego wiersza na zdarzenie i tylu kolumn, by programista mógł wdrożyć zdarzenie bez zadawania pytań. Poniższe kolumny zapobiegają realnym sporom w przyszłości. Edytor Tracking Plan w Segment używa części z nich, pod nazwami Name, Description, Status, Data Type i Permitted Values.

KolumnaCo się w niej znajdujeDlaczego jest potrzebna
Nazwa zdarzeniaDokładny wysyłany ciąg znaków, np. signup_completedEdytor Segment "strictly validates the name passed in your Track calls. Casing, spacing and spelling matter."
WyzwalaczJeden moment uruchomienia zdarzenia, opisany prostymi słowamiDwóch programistów, którzy przeczytają „przy rejestracji”, wdroży dwa różne zdarzenia
Pytanie, na które odpowiadaRaport lub wskaźnik zasilany tym zdarzeniemZdarzenie, dla którego nikt nie wskaże zastosowania, jest kandydatem do usunięcia
WłaściwościNazwa każdej właściwości wysyłanej ze zdarzeniemTo właściwości pozwalają podzielić zdarzenie na segmenty
Typstring, integer, boolean, data itd.Cena wysłana raz jako "49", a raz jako 49 psuje sumy
Wymagana lub opcjonalnaDla każdej właściwościWłaśnie to zawiera kolumna Status w Segment
Dozwolone wartościLista enum lub wzorzecDzięki temu Pro, pro i PRO nie stają się trzema planami
ŹródłoWeb, iOS, Android, serwerDefinicja Amplitude wymienia "which source emits it"
WłaścicielWskazana osoba lub zespółKtoś musi zatwierdzać zmiany
StatusPlanowane, aktywne, wycofaneChroni przed przypadkowym ponownym wdrożeniem wycofanych zdarzeń

Lista typów danych z Segment to rozsądny punkt wyjścia dla kolumny Typ: "any, array, object, boolean, integer, number, string, null, Date time", przy czym daty z godziną są "required to be in ISO-8601 format." Kolumna Permitted Values przyjmuje "simple regular expressions to validate property values" i działa tylko dla właściwości tekstowych.

Jak wygląda wypełniony wiersz planu śledzenia?

Wypełniony wiersz wygląda jak mała specyfikacja. Oto jedno zdarzenie z procesu rejestracji w SaaS, zapisane tak, jak przechowywałby je plan trzymany w repozytorium:

event: signup_completed
trigger: >
  Fires once, from the server, after the account row is written.
  Not on button click. Not on page load of /welcome.
answers: Signup-to-activation funnel, weekly signups by channel
source: backend
owner: growth-eng
status: live
properties:
  plan:
    type: string
    required: true
    allowed: [team, pro]
  signup_method:
    type: string
    required: true
    allowed: [email, google, github]
  invited:
    type: boolean
    required: false

Opis wyzwalacza to element, który większość planów ma źle napisany. „Uruchamia się przy rejestracji” nie mówi, czy liczy się nieudane wysłanie formularza, czy ponowienie uruchomi zdarzenie dwukrotnie ani czy zdarzenie pochodzi z przeglądarki, czy z serwera. Zapis "not on button click" wyklucza najczęstszy duplikat, gdy kliknięcie się rejestruje, a serwer następnie odrzuca formularz. Styl nazewnictwa to osobna decyzja, a wybór konwencji nazewnictwa zdarzeń przed pierwszym wierszem oszczędza późniejszej zmiany nazw.

Pracownik magazynu porównuje towary z listą na podkładce, podobnie jak narzędzie sprawdza napływające zdarzenia względem planu.

Co narzędzie do planu śledzenia może sprawdzić, a czego nie?

Narzędzie do planu śledzenia porównuje zdarzenia, które docierają, ze zdarzeniami opisanymi w planie, ale nie powie ci o zdarzeniach, które nigdy nie dotarły. Ta druga część to najważniejsza rzecz, jaką warto wiedzieć o tych narzędziach, a dostawcy sami o tym mówią.

Dokumentacja Segment opisuje stronę kontrolną: "Violations generate when an event doesn't match the spec'd event in the Tracking Plan." A w opisie kolumny Status dodaje: "You can't require a Track call because Segment is unable to verify when a Track call should be fired." Segment może sprawdzić, czy zdarzenie ma wymagane właściwości, ale nie ma jak ustalić, że zdarzenie powinno się uruchomić, a tego nie zrobiło.

Amplitude zajmuje się kierunkiem odwrotnym. Zdarzenia, które docierają, choć nie ma ich w planie, pojawiają się jako "Unexpected", a Amplitude pisze: "You can add them to your plan, or delete them to stop ingestion and remove them from your data catalog." W sprawie brakujących zdarzeń Amplitude publikuje osobny przewodnik zatytułowany "Planned events that never arrived: confirm the problem", który zaleca: "Compare your tracking plan with observed data and your planning records to find planned events that never reached Amplitude." Ta sama strona podaje, że "Data Assistant doesn't identify these entries", a Observe, czyli widok pokazujący, czy zdarzenie dotarło, obejmuje "the selected time range, up to 14 days."

Zielony dashboard walidacji oznacza więc, że każde zdarzenie, które dotarło, było zgodne ze specyfikacją. Nie oznacza, że dociera każde zdarzenie ze specyfikacji. Praktycznym rozwiązaniem jest kontrola przy każdym wydaniu. Wypisz zdarzenia oznaczone w planie jako aktywne, sprawdź w najnowszych danych każdą nazwę i oznacz te z zerową liczbą wystąpień. Przewodnik Amplitude dodaje słuszne zastrzeżenie: zdarzenie bez aktywności "might belong to a rare workflow, a disabled feature, or a future release", więc zanim usuniesz wiersz, zapytaj właściciela.

Kontrola zaplanowanych zdarzeń przy wydaniu
Wypisz aktywne zdarzenia
Sprawdź każdą nazwę w najnowszych danych
Oznacz te z zerową liczbą
Zapytaj właściciela
Zachowaj lub usuń wiersz
Wykonuj tę kontrolę przy każdym wydaniu, bo żaden dashboard walidacji sam nie zgłosi brakującego zdarzenia.

Które limity narzędzi docelowych powinny znaleźć się w planie?

W planie powinny się znaleźć limity każdego narzędzia, do którego trafiają zdarzenia, bo wiersz przekraczający limit zawodzi po cichu po stronie narzędzia docelowego. Google Analytics mówi to wprost: "Google Analytics doesn't log events, event parameters, and user properties that exceed the following limits."

LimitGA4Amplitude
Długość nazwy zdarzenia40 znakówNie podano na stronie limitów
Liczba różnych nazw zdarzeńBrak limitu dla strumieni webowych; 500 na użytkownika aplikacji dla strumieni aplikacji2 000 typów zdarzeń na projekt
Właściwości na zdarzenie25 parametrów zdarzeniaBrak limitu na zdarzenie
Długość nazwy właściwości40 znakówNie podano na stronie limitów
Długość wartości właściwości100 znaków, z wyjątkami dla page_title (300), page_referrer (420) i page_location (1 000)1 024 znaki dla większości wartości
Właściwości użytkownika25 na usługę, nazwy do 24 znaków, wartości do 361 000 na projekt

Oba narzędzia inaczej reagują na przekroczenie limitów. GA4 odrzuca element, a jako przykład podaje: "Analytics doesn't process the 26th user property nor does it process an event name with more than 40 characters." Amplitude nadal przyjmuje dane, ale "stops indexing new values", więc dane istnieją w eksportach, lecz nie można ich odpytywać na wykresach. Amplitude dodaje, że zdarzenia ponad limit typów "still count toward the monthly event volume", co oznacza, że wymykający się spod kontroli błąd instrumentacji kosztuje pieniądze za dane, których nikt nie może pokazać na wykresie.

Segment ma własny limit dla planów zarządzanych jako pliki: przesyłany plik CSV z planem "must be smaller than 15 mb" i musi "have fewer than 100,000 rows and 2,000 rules."

Mały zespół porządkuje karteczki na tablicy, aby wybrać kilka najważniejszych priorytetów, podobnie jak przy wyborze pierwszych zdarzeń do planu śledzenia.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Ile zdarzeń powinna zawierać pierwsza wersja?

Pierwsza wersja powinna zawierać tylko kilka zdarzeń odpowiadających na pytania, które zespół i tak zadaje co tydzień. Przewodnik wdrożeniowy Amplitude mówi "resist the urge to track everything upfront" i proponuje "starting with two important events in your product to give you initial insights." Jego poradnik o taksonomii ustala kolejność pracy: najpierw cele biznesowe, potem kluczowe wskaźniki, a następnie zdarzenia i właściwości potrzebne do tych wskaźników.

To właściwa kolejność. Zacznij od wskaźnika z cotygodniowego przeglądu, na przykład north star metric, zapisz pytanie, które on rodzi, i dodaj tylko zdarzenia potrzebne do odpowiedzi. Proces rejestracji wymagający analizy lejka potrzebuje jednego zdarzenia na krok i jednej właściwości dzielącej wynik, a nie czterdziestu zdarzeń dla każdego kliknięcia na stronie. Jeśli korzystasz z Flowsery, jego śledzenie celów „rejestruje rejestracje, zakupy, pobrania i zdarzenia niestandardowe w jednym miejscu”, a w planie decydujesz, które z tych celów warto zdefiniować.

Jak utrzymywać aktualność planu śledzenia?

Plan śledzenia pozostaje aktualny, gdy zmiana w kodzie śledzącym nie może zostać scalona bez odpowiadającej jej zmiany w planie. Wszystko inne to przypomnienia, które ludzie ignorują.

Większość pracy wykonuje kolumna Status. Oznaczenie zdarzenia jako wycofanego zamiast usuwania wiersza sprawia, że nowy programista nie wprowadzi ponownie starej nazwy pół roku później. Oba narzędzia przechowują historię. Segment podaje, że zmiany planu wprowadzone przez przesłanie pliku są "reflected in the Audit Trail and Tracking Plan changelog", a eksport CSV nazywa każdy plik workspaceSlug-trackingPlanName--yyyy-mm-dd--hh-mm-utc. Plan trzymany w repozytorium obok kodu dostaje historię za darmo dzięki kontroli wersji.

Najczęściej zadawane pytania

Czym plan śledzenia różni się od konwencji nazewnictwa zdarzeń?

Konwencja nazewnictwa zdarzeń to jedna z zasad w planie śledzenia: określa, jak tworzyć nazwy, na przykład object_action w snake case. Plan śledzenia to pełna lista zdarzeń zgodnych z tą zasadą, z wyzwalaczem, właściwościami, typami, źródłem i właścicielem każdego z nich.

Kto powinien być właścicielem planu śledzenia?

Zmiany powinna zatwierdzać jedna wskazana osoba z zespołu, który najczęściej czyta dane, a programiści mogą proponować wiersze. Plan, który każdy może edytować bez przeglądu, z czasem staje się tak samo bezużyteczny jak jego brak.

Czy plan śledzenia powinien być w arkuszu, czy w narzędziu?

Arkusz wystarczy w pierwszej wersji z kilkudziesięcioma zdarzeniami. Narzędzie takie jak Segment Protocols lub Amplitude Data dodaje walidację napływających zdarzeń względem planu, a plik w repozytorium kodu daje przegląd i historię dzięki pull requestom.

Czy zdarzenia po stronie serwera powinny być w tym samym planie?

Tak. Prowadź jeden plan z kolumną Źródło, bo ta sama nazwa zdarzenia wysyłana z przeglądarki i serwera jest liczona podwójnie, chyba że plan określa, które z nich jest właściwym zapisem. Sama definicja planu śledzenia w Amplitude obejmuje "which source emits it".

Jak znaleźć zaplanowane zdarzenia, które nigdy się nie uruchomiły?

Porównaj zdarzenia oznaczone w planie jako aktywne z nazwami zdarzeń widocznymi w najnowszych danych i oznacz te z zerową liczbą wystąpień. Segment zaznacza, że nie może wymagać wywołania Track, a Amplitude podaje, że Data Assistant nie identyfikuje takich pozycji, więc żaden dashboard walidacji sam nie zgłosi tego problemu.

Czy autoprzechwytywanie eliminuje potrzebę planu śledzenia?

Nie. Autoprzechwytywanie rejestruje kliknięcia i odsłony, ale nie zapisuje, co kliknięcie oznaczało, na przykład który plan wybrał użytkownik albo czy serwer przyjął formularz. Zdarzenia zasilające wskaźniki przychodów i aktywacji nadal wymagają spisanego wyzwalacza i listy właściwości.

Co powinna zawierać kolumna wyzwalacza?

Powinna wskazywać jeden moment uruchomienia zdarzenia, prostymi słowami, wraz z tym, co się nie liczy. „Uruchamia się przy rejestracji” pozostawia otwarte pytania, czy liczy się nieudane wysłanie albo ponowienie i czy zdarzenie wysyła przeglądarka, czy serwer. "Fires once, from the server, after the account row is written. Not on button click" nie zostawia miejsca na domysły.

Od ilu zdarzeń powinien zaczynać się plan śledzenia?

Zacznij od kilku zdarzeń odpowiadających na pytania, które zespół zadaje co tydzień. Przewodnik wdrożeniowy Amplitude mówi "resist the urge to track everything upfront" i proponuje zacząć od dwóch ważnych zdarzeń. Kolejne dodawaj dopiero wtedy, gdy potrzebuje ich jakiś wskaźnik.

Co się dzieje, gdy plan przekracza limity GA4 lub Amplitude?

GA4 odrzuca element, więc 26. właściwość użytkownika albo nazwa zdarzenia dłuższa niż 40 znaków nigdy nie zostanie przetworzona. Amplitude nadal przyjmuje dane, ale przestaje indeksować nowe wartości, więc dane pojawiają się w eksportach, lecz nie można ich odpytywać na wykresach. Zdarzenia ponad limit typów nadal wliczają się do miesięcznego wolumenu zdarzeń.

Dlaczego oznaczać zdarzenie jako wycofane zamiast usuwać wiersz?

Wiersz oznaczony jako wycofany sprawia, że nowy programista nie wprowadzi ponownie starej nazwy kilka miesięcy później. Zachowuje też historię w planie. Zanim usuniesz wiersz zdarzenia bez aktywności, zapytaj właściciela, bo może ono "belong to a rare workflow, a disabled feature, or a future release."

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Częściej widoczni w Google

Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.

Jeszcze jedno...

Flowsery

Flowsery

Analityka witryny skupiona na przychodach

Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Powiązane hasła ze słownika

Jak warstwa danych przekazuje zdarzenia do tagów analitycznychJak warstwa danych przekazuje zdarzenia do tagów analitycznych
Słownik

Jak warstwa danych przekazuje zdarzenia do tagów analitycznych

Warstwa danych to kolejka, do której strona wysyła zdarzenia analityczne. Jak Menedżer tagów odczytuje dataLayer, dlaczego dane się scalają i jakie błędy gubią zdarzenia.

•9 min czytania
Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwyJak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy
Słownik

Jak konwencja nazewnictwa zdarzeń przetrwa pierwszą zmianę nazwy

Konwencja nazw zdarzeń musi uwzględniać zastrzeżone nazwy GA4, limit 40 znaków i wielkość liter, bo zmiana nazwy po starcie nie obejmuje historii.

•9 min czytania
Co analityka behawioralna śledzi, a czego nie widać w odsłonachCo analityka behawioralna śledzi, a czego nie widać w odsłonach
Słownik

Co analityka behawioralna śledzi, a czego nie widać w odsłonach

W przeciwieństwie do surowej liczby odsłon analityka behawioralna rejestruje, co odwiedzający faktycznie robi na stronie, jako strumień nazwanych zdarzeń powiązanych z tą konkretną osobą.

•6 min czytania
Jak śledzenie zdarzeń zapisuje to, co użytkownicy naprawdę zrobiliJak śledzenie zdarzeń zapisuje to, co użytkownicy naprawdę zrobili
Słownik

Jak śledzenie zdarzeń zapisuje to, co użytkownicy naprawdę zrobili

W analityce produktowej śledzenie zdarzeń zapisuje nazwane działania użytkowników wraz z właściwościami, zamieniając dane o ruchu w zapis tego, co ludzie zrobili.

•8 min czytania
Co autocapture rejestruje bez ręcznej instrumentacjiCo autocapture rejestruje bez ręcznej instrumentacji
Słownik

Co autocapture rejestruje bez ręcznej instrumentacji

W analityce produktowej autocapture automatycznie rejestruje każde kliknięcie, odsłonę i wysłanie formularza, bez ani jednego ręcznie napisanego wywołania śledzącego.

•6 min czytania
Jak analityka produktowa śledzi użytkowników, a nie odsłonyJak analityka produktowa śledzi użytkowników, a nie odsłony
Słownik

Jak analityka produktowa śledzi użytkowników, a nie odsłony

W odróżnieniu od analityki stron analityka produktowa mierzy zachowania zdarzenie po zdarzeniu i użytkownik po użytkowniku, odpowiadając na pytania o aktywację, retencję i lejki.

•7 min czytania

Powiązane artykuły