Rejestruj zdarzenia

Ten przewodnik pokazuje, jak rejestrować zdarzenia w aplikacji.

zdarzenia zapewniają wgląd w to, co dzieje się w aplikacji, takie jak działania użytkownika, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje niektóre wydarzenia dla Ciebie;nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli aplikacja wymaga gromadzenia danych dodatkowych, możesz zarejestrować do 500 różnych typów zdarzeń analitycznych w aplikacji. Nie ma limitu całkowitej głośności zdarzeń dzienników aplikacji.,Należy pamiętać, że nazwy zdarzeń uwzględniają wielkość liter, a rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje powstanie dwóch odrębnych zdarzeń.

zanim rozpoczniesz

upewnij się, że skonfigurowałeś swój projekt i masz dostęp do analityki zgodnie z opisem w zakładce Analytics.

Rejestruj zdarzenia

Po skonfigurowaniu instancjifirebase.analytics()możesz zacząć rejestrować zdarzenia za pomocą metodylogEvent(). Jeśli jesteś już zaznajomiony z Google Analytics, ta metoda jest równoważna z użyciem poleceniaevent ingtag.js.,

aby ułatwić Ci rozpoczęcie pracy, Pakiet Analytics SDK definiuje szereg sugerowanych zdarzeń, które są powszechne wśród różnych typów aplikacji,w tym aplikacji detalicznych i e-commerce, aplikacji podróżniczych i gier. Aby dowiedzieć się więcej o tych zdarzeniach i kiedy z nich korzystać,przejrzyj wydarzenia i właściwościartykuły w Centrum pomocy Firebase.

Uwaga: Aby uzyskać maksymalną szczegółowość raportów, Zaloguj sugerowane zdarzenia, które mają sens dla aplikacji i ich zalecanych parametrów. Zapewnia to również, żezawsze funkcje Google Analytics, gdy stają się dostępne.,

szczegóły implementacji kilku zdarzeń i ich parametry można znaleźć w tagach.odniesienie do zdarzenia js.

poniższy przykład pokazuje, jak zarejestrować zdarzenieselect_content:

analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: });

oprócz zalecanych parametrów, możesz dodać następujące parametry do każdego zdarzenia:

• parametry niestandardowe: parametry niestandardowe mogą być rejestrowane do raportowania w raportach analitycznych. Mogą być również stosowane jako filtry w definicjach, które można zastosować do każdego raportu., Parametry niestandardowe są również dołączone w datacheksportowane do Bigqueryjeśli Twoja aplikacja jest powiązana z projektem BigQuery.
• value parametr: value jest parametrem 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óre nie są objęte sugerowanym typem zdarzenia, możesz zarejestrować własne zdarzenia niestandardowe., Na przykład, jeśli tworzysz grę i chcesz śledzić, kiedy gracz ukończy konkretny cel, możesz zarejestrować zdarzenie podobne do poniższego przykładu:

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

wyświetlanie zdarzeń na pulpicie nawigacyjnym

Możesz przeglądać zagregowane statystyki dotyczące swoich zdarzeń na pulpicie nawigacyjnym konsoli Firebase. Te pulpity nawigacyjne aktualizują się periodicallythrough the day. Do natychmiastowego testowania użyj wyjścia logcat, jak opisano w poprzedniej sekcji.

możesz uzyskać dostęp do tych danych z eventsdashboard w konsoli Firebase., Ten pulpit nawigacyjny pokazuje raporty zdarzeń, które są automatycznie tworzone dla każdego rodzaju zdarzeń rejestrowanych przez Twoją aplikację.