analytics-events

Umiejętność ułatwiająca integrację zdarzeń analitycznych Snowplow w kodzie frontendowym Metabase. Pozwala śledzić interakcje użytkowników poprzez typizowane schematy zdarzeń. Obsługuje proste zdarzenia (kliknięcia, otwieranie, zamykanie, tworzenie, usuwanie) z opcjonalnymi polami kontekstu, czasu trwania i wyniku. Wszystkie zdarzenia muszą być zdefiniowane w typach TypeScript przed użyciem. Narzędzie zawiera funkcje pomocnicze do śledzenia i dostęp do plików definicji schematów oraz funkcji śledzenia w całej bazie kodu.

1. Otwórz plik frontend/src/metabase-types/analytics/event.ts i zdefiniuj nowy typ zdarzenia w odpowiedniej unii typów (np. DataStudioEvent lub SimpleEvent), używając pól ze schematu SimpleEventSchema: event (wymagane, snake_case), target_id, triggered_from, duration_ms, result, event_detail.
2. Przejdź do pliku analytics.ts w katalogu funkcji, którą chcesz śledzić, i utwórz funkcję opakowującą, która będzie wywoływać trackSimpleEvent() z parametrami zdarzenia.
3. W komponencie lub funkcji, gdzie zachodzi interakcja użytkownika (klik, otwarcie, zamknięcie, utworzenie, usunięcie), zaimportuj utworzoną funkcję śledzenia.
4. Wywołaj funkcję śledzenia w odpowiednim miejscu w kodzie, przekazując wymagane parametry zdarzenia i opcjonalne pola kontekstu.
5. Sprawdź, czy zdarzenie jest poprawnie zarejestrowane w schemacie poprzez plik frontend/src/metabase-types/analytics/schema.ts, który zawiera rejestr wszystkich zdarzeń.
6. Testuj zdarzenie w środowisku deweloperskim, aby upewnić się, że śledzenie działa prawidłowo i zbiera oczekiwane dane.