Zdarzenia w dzienniku

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

Analytics automatycznie rejestruje niektóre zdarzenia, więc nie musisz dodawać kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować maksymalnie 500 różnych typów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez Twoją 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 utworzeniu instancji FirebaseAnalytics możesz jej używać do rejestrowania zdarzeń za pomocą metod log biblioteki.

Zdarzenia wstępnie zdefiniowane

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 i e-commerce, aplikacji podróżniczych oraz gier. Więcej informacji o tych zdarzeniach i o tym, kiedy je stosować, znajdziesz w artykule [GA4] Zalecane zdarzenia.

Metody logowania zalecanych typów zdarzeń znajdziesz w przewodniku po interfejsie API.

Ten przykład pokazuje, jak rejestrować zdarzenie select_content:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Możesz też zarejestrować to samo zdarzenie za pomocą funkcji logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Może to być przydatne, jeśli chcesz określić dodatkowe parametry inne niż zalecane (wymagane). Do dowolnego zdarzenia możesz dodać te parametry:

Parametry niestandardowe: w raportach Analytics parametry niestandardowe mogą być używane jako wymiary lub dane. Wymiarów niestandardowych możesz używać w przypadku danych parametru zdarzenia niebędących liczbami, a danych niestandardowych – w przypadku dowolnych danych parametru, które lepiej przedstawiają się w postaci liczb. Po zarejestrowaniu parametru niestandardowego 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.

Parametrów niestandardowych możesz używać w definicjach list 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.
value parametr: parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych dotyczących zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.
Nazwy parametrów mogą mieć maksymalnie 40 znaków. Muszą się zaczynać od litery i zawierać tylko znaki alfanumeryczne oraz podkreślenia. Obsługiwane są typy ciągu znaków i liczb. Wartości parametrów ciągu znaków mogą mieć maksymalnie 100 znaków. Prefiksy „firebase”, „google” i „ga_” są zastrzeżone i nie należy ich używać w nazwach parametrów.

Zdarzenia niestandardowe

Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje żaden zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak w tym przykładzie:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Ustawianie domyślnych parametrów zdarzenia

Parametry możesz rejestrować w ramach zdarzeń za pomocą tagu setDefaultEventParameters(). Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które zostaną zarejestrowane.

Podobnie jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzenia, aby pojawiły się w raportach Analytics.

Dopuszczalne wartości parametrów to ciągi tekstowe i liczby. Ustawienie wartości klucza na nullpowoduje wyczyszczenie tego parametru. Przekazanie wartości null powoduje wyczyszczenie wszystkich parametrów.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Jeśli w metodach logEvent() lub log podany jest parametr, to właśnie jego wartość jest używana zamiast wartości domyślnej.

Aby usunąć parametr domyślny, wywołaj metodę setDefaultEventParameters() z parametrem ustawionym na null.

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ć natychmiastowy test, 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ę.