Rejestruj zdarzenia

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' }]
});
analytics_log_event_params.js

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});
index.js

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

Web version 8

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

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ę.