Ten przewodnik pokazuje, jak rejestrować zdarzenia w aplikacji.
Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.
Analytics automatycznie rejestruje za 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 całkowitej liczby zdarzeń rejestrowanych przez 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 pliku gtag.js .
Aby pomóc Ci zacząć, 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 wydarzeniach i kiedy ich używać, zobacz Polecane wydarzenia .
Uwaga: aby uzyskać jak najwięcej szczegółów w raportach, rejestruj zalecane zdarzenia, które mają sens w przypadku Twojej aplikacji, oraz ich zalecane parametry. 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 ilustruje rejestrowanie zdarzenia select_content
:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453' });
Web namespaced API
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Oprócz określonych parametrów do każdego zdarzenia można dodać następujące parametry:
Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics . Niestandardowych wymiarów możesz używać w przypadku nieliczbowych danych parametrów zdarzeń i niestandardowych metryk w przypadku dowolnych danych parametrów lepiej przedstawionych liczbowo. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby mieć pewność, że te parametry niestandardowe pojawią się w raportach Analytics. Zrób to za pomocą: Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary
Parametrów niestandardowych można używać 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 akumulacji 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 niestandardowe zdarzenia. Na przykład, jeśli tworzysz grę i chcesz śledzić, kiedy gracz osiąga określony cel, możesz zarejestrować zdarzenie podobne do poniższego:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web namespaced API
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Zobacz zdarzenia na pulpicie nawigacyjnym
Możesz przeglądać zagregowane statystyki dotyczące swoich wydarzeń w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne są okresowo aktualizowane 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 pulpitu nawigacyjnego Zdarzenia w konsoli Firebase. Ten pulpit nawigacyjny pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.