Zdarzenia w dzienniku

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

Zdarzenia dostarczają informacji o tym, co dzieje się w aplikacji, np. o użytkownikach czynności, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje niektóre wydarzenia dla Ciebie, Ty nie muszą dodać kod, żeby je otrzymać. Jeśli aplikacja ma zbierać dodatkowe możesz zarejestrować maksymalnie 500 różnych typów zdarzeń Analytics w swojej aplikacji. Nie ma limitu całkowitej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że zdarzenie wielkość liter w nazwach jest rozróżniana, a logowanie 2 zdarzeń, których nazwy różnią się tylko daje dwa różne zdarzenia.

Zanim zaczniesz

Upewnij się, że Twój projekt jest skonfigurowany i masz dostęp do Analytics w sposób opisany w Pierwsze kroki z Analytics

Zdarzenia w dzienniku

Po skonfigurowaniu firebase.analytics() instancji, możesz zacząć rejestrować zdarzenia za pomocą logEvent() . Jeśli znasz już Google Analytics, ta metoda pozwoli Ci odpowiednika użycia polecenia event w gtag.js.

Aby ułatwić rozpoczęcie pracy, pakiet SDK Analytics określa kilka zalecanych zdarzeń typowych dla różnych typów aplikacji, takich jak e-commerce, turystyki i gier. Więcej informacji o tych wydarzeniach i ich używanie znajdziesz w sekcji Zalecane zdarzenia.

Uwaga: aby raport zawierał najpełniejsze informacje, rejestruj zalecane zdarzenia, które do Twojej aplikacji i przewidzianych parametrów. Dzięki temu będziesz też mieć pewność, możesz korzystać z najnowszych funkcji Google Analytics, gdy tylko będą dostępne.

Szczegółowe informacje o implementacji kilku zdarzeń i ich parametrach znajdziesz w Informacje o zdarzeniach gtag.js

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

Web

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

Oprócz określonych parametrów możesz dodać następujące parametry: do dowolnego wydarzenia:

  • Parametry niestandardowe: jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych parametrów zdarzeń nieliczbowych oraz niestandardowe dla dowolnego parametru lepiej przedstawionego w postaci liczbowej. Jednorazowo zarejestrowano parametr niestandardowy za pomocą pakietu SDK, zarejestruj wymiar lub aby mieć pewność, że te parametry niestandardowe pojawią się w Analytics raportów. Możesz to zrobić za pomocą: Analytics > Wydarzenia > Zarządzaj niestandardowymi definicjami > Tworzenie wymiarów niestandardowych

    Parametry niestandardowe można stosować odbiorcy definicje, które można zastosować w każdym raporcie. Parametry niestandardowe są też uwzględniane w danych wyeksportowane do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje o Google Analytics 4 BigQuery Export.

  • Parametr value: value to parametr ogólnego przeznaczenia, który przydaje się do gromadzenia kluczowych danych związanych ze zdarzeniem. Mogą to być na przykład przychody, dystans, czas i punkty.

Jeśli Twoja aplikacja ma konkretne potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe. Jeśli na przykład tworzysz grę śledzić realizację określonego celu przez gracza, możesz zarejestrować zdarzenie, podobny do tego przykładu:

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 swoich zdarzeń możesz wyświetlać w Panele konsoli Firebase. Te panele są okresowo aktualizowane w ciągu dnia. Aby przeprowadzić natychmiastowe testy, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych możesz uzyskać w Wydarzenia w panelu Firebase. Ten panel pokazuje raporty o zdarzeniach tworzone automatycznie dla poszczególnych typów zdarzeń rejestrowanych przez do aplikacji.