Z tego przewodnika dowiesz się, jak rejestrować zdarzenia w Twojej aplikacji.
Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, takie jak działania użytkowników, zdarzenia systemowe lub błędy.
Analytics automatycznie rejestruje dla Ciebie niektóre zdarzenia ; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej do 500 różnych typów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez Twoją aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter, a rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje powstanie dwóch różnych zdarzeń.
Zanim zaczniesz
Upewnij się, że masz skonfigurowany projekt i masz dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics .
Rejestruj zdarzenia
Po skonfigurowaniu instancji firebase.analytics()
można rozpocząć rejestrowanie zdarzeń za pomocą metody logEvent()
. Jeśli znasz już Google Analytics, ta metoda jest równoważna użyciu polecenia event
w gtag.js .
Aby ułatwić rozpoczęcie pracy, pakiet Analytics SDK definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, podróży i gier. Aby dowiedzieć się więcej o tych zdarzeniach i kiedy ich używać, zobacz Polecane zdarzenia .
Uwaga: aby uzyskać jak najwięcej szczegółów w raportach, zarejestruj zalecane zdarzenia, które mają sens dla Twojej aplikacji i ich zaleconych parametrów. Zapewnia to również korzystanie z najnowszych funkcji Google Analytics, gdy tylko staną się dostępne.
Szczegóły implementacji kilku zdarzeń i ich parametrów znajdziesz w dokumentacji zdarzenia gtag.js .
Poniższy przykład pokazuje, jak rejestrować zdarzenie select_content
:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Web version 8
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Oprócz określonych parametrów do dowolnego zdarzenia możesz dodać następujące parametry:
Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w raportach Analytics . Możesz użyć niestandardowych wymiarów w przypadku nieliczbowych danych parametrów zdarzeń, a niestandardowych danych w przypadku dowolnych danych parametrów lepiej przedstawionych w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby zapewnić wyświetlanie tych parametrów niestandardowych w raportach Analytics. W tym celu: Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary
Parametry niestandardowe mogą być używane w definicjach odbiorców , które można zastosować do każdego raportu. Parametry niestandardowe są też uwzględniane w danych eksportowanych do BigQuery , jeśli Twoja aplikacja jest połączona z projektem BigQuery. Znajdź przykładowe zapytania i wiele więcej w Google Analytics 4 BigQuery Export .
parametr
value
:value
to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowej metryki odnoszącej się do zdarzenia. Przykłady obejmują przychody, odległość, czas i punkty.
Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe. Na przykład, jeśli tworzysz grę i chcesz śledzić, kiedy gracz osiąga określony cel, możesz zarejestrować zdarzenie podobne do następującego przykładu:
Web version 9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web version 8
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Zobacz wydarzenia w desce rozdzielczej
Zagregowane statystyki dotyczące zdarzeń możesz wyświetlić w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne aktualizują się okresowo w ciągu dnia. Do natychmiastowego testowania użyj danych wyjściowych logcat, jak opisano w poprzedniej sekcji.
Możesz uzyskać dostęp do tych danych z panelu Zdarzenia w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego typu zdarzenia zarejestrowanego przez Twoją aplikację.