Zdarzenia w dzienniku

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

Zdarzenia dostarczają informacji o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeniach systemowych czy 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 w niej rejestrować maksymalnie 500 różnych Analyticstypów zdarzeń (2000, jeśli korzystasz z Google Analytics 360). 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, powoduje rejestrowanie 2 osobnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i możesz uzyskać 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.

Szczegóły implementacji kilku zdarzeń i ich parametrów znajdziesz w dokumentacji zdarzeń tagu 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. Gdy zarejestrujesz parametr niestandardowy 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 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. Przykłady to 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ę.