| Wybierz platformę: | iOS+ Android Web Flutter Unity C++ |
Zdarzenia pozwalają uzyskać wgląd w to, co dzieje się w aplikacji. Dostarczają informacji m.in. o działaniach użytkowników, zdarzeniach systemowych i błędach.
Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej do 500 różnych typów zdarzeń Analytics (2000, jeśli korzystasz z Google Analytics 360). Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie, a rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 osobnych zdarzeń.
Zanim zaczniesz
Upewnij się, że masz skonfigurowany projekt i dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics.
Zdarzenia z dzienników
Po skonfigurowaniu instancji firebase.analytics() możesz zacząć rejestrować zdarzenia za pomocą metody logEvent(). Jeśli znasz już Google Analytics, ta metoda jest odpowiednikiem użycia polecenia event w gtag.js.
Aby ułatwić Ci rozpoczęcie pracy, [pakiet] SDK Analytics definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji handlu detalicznego i e-commerce, turystycznych oraz gier mobilnych. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Polecane zdarzenia.
Szczegóły implementacji kilku zdarzeń i ich parametrów znajdziesz w dokumentacji zdarzeń tagu gtag.js.
Poniższy przykład pokazuje, jak zarejestrować zdarzenie select_content:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'select_content', { content_type: 'image', content_id: 'P12453' });
Web
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
Oprócz zalecanych parametrów do każdego zdarzenia możesz dodać te parametry:
Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku nieliczbowych danych parametrów zdarzeń, a danych niestandardowych – w przypadku wszelkich danych parametrów, które lepiej przedstawić liczbowo. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby te parametry niestandardowe pojawiały się w raportach Analytics. Aby to zrobić, w konsoli Firebase kliknij Analytics > Definicje niestandardowe.
Parametry niestandardowe mogą być używane w definicjach odbiorców, które można stosować 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. Przykładowe zapytania i inne informacje znajdziesz w artykule Google Analytics 4 BigQuery Export.
Parametr
value:valueto parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Przykłady: 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. Jeśli na przykład tworzysz grę i chcesz śledzić, kiedy gracz osiąga określony cel, możesz zarejestrować zdarzenie podobne do tego:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});
Web
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
Wyświetlanie zdarzeń w panelu
W konsoli Firebase możesz wyświetlać zbiorcze statystyki dotyczące zdarzeń w panelu Analytics > Zdarzenia.
Pamiętaj o tych kwestiach dotyczących tego panelu:
W panelu wyświetlane są raporty o zdarzeniach, które są automatycznie tworzone dla każdego typu zdarzenia zarejestrowanego przez aplikację.
Panel jest aktualizowany okresowo w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, użyj DebugView.