Zdarzenia w dzienniku

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Zdarzenia pozwalają uzyskać wgląd w to, co dzieje się w aplikacji. Dostarczają informacji m.in. o działaniach użytkowników, zdarzeniach systemowych i błędach.

Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej do 500 różnych typów zdarzeń Analytics (2000, jeśli korzystasz z Google Analytics 360). Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie. Zarejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje utworzenie 2 osobnych zdarzeń.

Zanim zaczniesz

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

Zdarzenia z dzienników

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

Aby ułatwić Ci rozpoczęcie korzystania z pakietu SDK Analytics, zawiera on szereg zalecanych zdarzeń, które są typowe dla różnych rodzajów aplikacji, m.in. aplikacji do handlu detalicznego i e-commerce, aplikacji turystycznych i gier mobilnych. Więcej informacji o tych zdarzeniach i o tym, kiedy ich używać, znajdziesz w artykule [GA4] Zalecane zdarzenia.

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

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

Web

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

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

  • Parametry niestandardowe: parametrów niestandardowych można używać jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku nieliczbowych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawić w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby te parametry niestandardowe pojawiały się w raportach Analytics. Aby to zrobić, w konsoli Firebase kliknij Analytics > Definicje niestandardowe.

    Parametry niestandardowe mogą być używane w definicjach odbiorców, które można stosować 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. Przykładowe zapytania i inne informacje znajdziesz w artykule Google Analytics 4 BigQuery Export.

  • Parametr value: value to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Przykłady: 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'});

Web

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

Wyświetlanie zdarzeń w panelu

W konsoli Firebase możesz wyświetlać zbiorcze statystyki dotyczące zdarzeń w panelu Analytics > Zdarzenia.

Pamiętaj o tych kwestiach dotyczących tego panelu:

  • Panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego typu zdarzenia zarejestrowanego przez aplikację.

  • Panel jest aktualizowany okresowo w ciągu dnia. Aby przeprowadzić natychmiastowe testowanie, użyj DebugView.