Catch up on highlights from Firebase at Google I/O 2023. Learn more

Rejestruj zdarzenia

W tym przewodniku dowiesz się, jak rejestrować zdarzenia w aplikacji.

Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, na przykład działania użytkownika, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje niektóre zdarzenia za Ciebie; 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 ograniczeń co do całkowitej liczby zdarzeń rejestrowanych przez aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter i że rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, skutkuje dwoma różnymi zdarzeniami.

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żesz rozpocząć rejestrowanie zdarzeń za pomocą metody logEvent() . Jeśli znasz już Google Analytics, ta metoda jest równoznaczna z użyciem 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 do handlu detalicznego i e-commerce, aplikacji podróżniczych i gier. Aby dowiedzieć się więcej o tych zdarzeniach i kiedy z nich korzystać, zobacz Polecane zdarzenia .

Uwaga: aby uzyskać jak najwięcej szczegółów w raportach, rejestruj zalecane zdarzenia, które mają sens dla Twojej aplikacji i ich określonych parametrów. Dzięki temu będziesz mieć pewność, że będziesz korzystać 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 sposób rejestrowania 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 dowolnego zdarzenia możesz dodać następujące parametry:

  • Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics . Możesz używać niestandardowych wymiarów dla nieliczbowych danych parametrów zdarzeń i niestandardowych metryk dla dowolnych danych parametrów lepiej reprezentowanych 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 poprzez: Analityka > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary

    Parametry niestandardowe można wykorzystać w definicjach odbiorców , które można zastosować do każdego raportu. Parametry niestandardowe są także 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 jest parametrem ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych wskaźników odnoszących się do zdarzenia. Przykładami mogą być przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma specyficzne 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ągnie określony cel, możesz zarejestrować zdarzenie podobne do następującego przykładu:

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'});

Przeglądaj wydarzenia w panelu kontrolnym

Możesz przeglądać zbiorcze statystyki dotyczące swoich zdarzeń w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne są aktualizowane okresowo w ciągu dnia. W celu natychmiastowego przetestowania użyj wyjścia logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych możesz uzyskać z panelu Wydarzenia w konsoli Firebase. Ten pulpit nawigacyjny przedstawia raporty zdarzeń, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.