Zdarzenia w dzienniku

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


Zdarzenia pozwalają stwierdzić, 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 dla Ciebie, 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 Analytics zdarzeń typów (2000, jeśli używasz Google Analytics 360). Łączna liczba zdarzeń rejestrowanych przez aplikację nie jest ograniczona. Pamiętaj, że w nazwach zdarzeń jest rozróżniana wielkość liter – 2 zdarzenia, których nazwy różnią się tylko wielkością liter, będą traktowane jako różne zdarzenia.

Zanim zaczniesz

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

Zdarzenia w dzienniku

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

Aby ułatwić Ci rozpoczęcie, pakiet SDK Analytics definiuje kilka 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 Zalecane zdarzenia.

Szczegóły implementacji kilku zdarzeń i ich parametrów znajdziesz w dokumencie dokumentacji zdarzeń 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 określonych parametrów możesz dodać do dowolnego zdarzenia te parametry:

  • Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych parametrów zdarzeń, które nie są liczbami, a danych niestandardowych – w przypadku danych parametrów, które lepiej reprezentują liczby. Gdy zarejestrujesz parametr niestandardowy 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 BigQuery Export w Google Analytics 4.

  • Parametr value: value to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych związanych ze zdarzeniem. Przykłady: przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma szczególne potrzeby, których nie spełnia ż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ą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ń na panelu

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

O tym panelu warto wiedzieć:

  • Panel pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.

  • Panel jest okresowo aktualizowany w ciągu dnia. Do natychmiastowego testowania, używaj DebugView.