Zdarzenia w dzienniku


Z tego przewodnika dowiesz się, jak rejestrować zdarzenia w aplikacji.

Zdarzenia dają wgląd w aktualny ruch w Twojej aplikacji, np. w formie działań użytkowników, zdarzeń systemowych lub błędów.

Analytics automatycznie rejestruje niektóre zdarzenia. Nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować maksymalnie 500 różnych Analytics rodzajów zdarzeń. Nie ma limitu łącznej ilości rejestrowanych przez aplikację zdarzeń. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i masz dostęp do Analytics zgodnie z opisem w artykule Rozpoczynanie korzystania z Analytics.

Zdarzenia z dziennika

Po skonfigurowaniu instancji firebase.analytics() możesz zacząć rejestrować zdarzenia 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ć 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 handlowych i e-commerce, podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule Polecane zdarzenia.

Uwaga: aby w raportach pojawiały się jak najbardziej szczegółowe informacje, rejestruj zalecane zdarzenia, które mają znaczenie w przypadku Twojej aplikacji, oraz ich określone parametry. Dzięki temu będziesz też korzystać z najnowszych funkcji Google Analytics, gdy tylko zostaną udostępnione.

Szczegóły implementacji kilku zdarzeń i ich parametrów znajdziesz w dokumentacji zdarzeń gtag.js.

Poniższy przykład pokazuje, jak rejestrować zdarzenie select_content:

Web

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});
analytics_log_event_params.js

Web

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

Poza określonymi parametrami możesz dodać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w Analyticsraportach. Wymiarów niestandardowych możesz używać w przypadku nienumerycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawiają wartości liczbowe. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby te parametry niestandardowe pojawiały się w raportach Analytics. Możesz to zrobić w sekcji Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

    Parametry niestandardowe można stosować w definicjach list odbiorców, które można stosować w każdym raporcie. 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 BigQuery Export w Google Analytics 4.

  • Parametr value: value to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma specyficzne potrzeby, których nie obejmuje żaden z zalecanych typów zdarzeń, możesz rejestrować własne zdarzenia niestandardowe. Jeśli na przykład tworzysz grę i chcesz śledzić, kiedy gracz osiągnie 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'});
analytics_log_event_custom_params.js

Web

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

Wyświetlanie zdarzeń w panelu

Zagregowane statystyki dotyczące zdarzeń możesz wyświetlać w Firebasepanelach konsoli. Te panele są okresowo aktualizowane w ciągu dnia. Aby natychmiast przetestować aplikację, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych możesz uzyskać w panelu Wydarzenia w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.