Zdarzenia w dzienniku


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

Zdarzenia dają wgląd w to, co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe i błędy.

Analytics automatycznie rejestruje niektóre zdarzenia. Aby je otrzymywać, nie musisz dodawać kodu. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej maksymalnie 500 różnych Analyticstypów zdarzeń. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje zarejestrowanie 2 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.

Zdarzenia z dziennika

Po skonfigurowaniu instancji firebase.analytics() możesz zacząć rejestrować zdarzenia za pomocą metody logEvent(). Jeśli znasz już tag Google Analytics, ta metoda jest równoważna użyciu w tagu event polecenia event w tagu gtag.js.

Aby ułatwić Ci rozpoczęcie korzystania z Analytics SDK, definiuje on kilka zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, m.in. aplikacji do zakupów, e-commerce, podróży i gier. Więcej informacji o tych zdarzeniach i o tym, kiedy je stosować, znajdziesz w artykule [GA4] Zalecane zdarzenia.

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

Szczegółowe informacje o implementacji poszczególnych zdarzeń i ich parametrów znajdziesz w dokumentacji tagu gtag.js.

Ten 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

Oprócz parametrów zalecanych możesz dodawać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: w raportach Analytics możesz używać parametrów niestandardowych jako wymiarów lub danych. Wymiarów niestandardowych możesz używać w przypadku danych parametru zdarzenia niebędących liczbami, a danych niestandardowych – w przypadku wszelkich danych parametru, które lepiej przedstawiają się w postaci liczb. Gdy zarejestrujesz parametr niestandardowy za pomocą pakietu SDK, zarejestruj wymiar lub metrykę, aby parametry niestandardowe pojawiały się w raportach Analytics. Aby to zrobić, kliknij Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.

    Parametry niestandardowe możesz stosować w definicjach odbiorców, które możesz 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 wiele innych informacji znajdziesz w artykule BigQuery Export w Google Analytics 4.

  • parametr value: value to uniwersalny parametr, 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 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'});
analytics_log_event_custom_params.js

Web

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

Wyświetlanie zdarzeń w panelu

Zbiorcze statystyki dotyczące zdarzeń możesz wyświetlać w panelach konsoli Firebase. Te panele są okresowo aktualizowane w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych masz w panelu Zdarzenia w konsoli Firebase. Ten panel zawiera raporty zdarzeń, które są automatycznie tworzone dla każdego z różnych typów zdarzeń rejestrowanych przez Twoją aplikację.