Zdarzenia w dzienniku

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. 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 Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez aplikację. 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 2 różne zdarzenia.

Zanim zaczniesz

Sprawdź, czy masz skonfigurowany projekt i czy masz dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics.

Jeśli chcesz zbierać dane o atrybucji w kampanii, upewnij się, że dodasz do projektu framework AdSupport.

Zdarzenia w dzienniku

Po skonfigurowaniu instancji FirebaseApp możesz zacząć rejestrować zdarzenia za pomocą logEvent() metody.

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ółowe informacje o implementacji znajdziesz w dokumentacji stałych w Swift i Objective-C.

Poniższy przykład pokazuje, jak zarejestrować zalecane zdarzenie kFIRSelectContent:

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

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 przedstawiają 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 kFIRParameterValue: kFIRParameterValue 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 szczególne potrzeby, których nie spełnia żaden typ zalecanego zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano w tym przykładzie:

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])
MigratedSnippets.swift

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];
ObjCMigratedSnippets.m

Ustawianie domyślnych parametrów zdarzeń

Za pomocą metody setDefaultEventParameters możesz rejestrować parametry w różnych zdarzeniach. 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 zdarzeń, aby te parametry niestandardowe pojawiały się w raportach Analytics.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

Jeśli parametr jest określony w metodzie logEvent(), zamiast wartości domyślnej używana jest ta wartość.

Aby wyczyścić parametr domyślny, wywołaj metodę setDefaultEventParameters z parametrem ustawionym na nil.

Wyświetlanie zdarzeń w konsoli debugowania Xcode

Aby sprawdzić, czy zdarzenia są prawidłowo rejestrowane, możesz włączyć logowanie szczegółowe, aby monitorować rejestrowanie zdarzeń przez pakiet SDK. Dotyczy to zarówno zdarzeń rejestrowanych automatycznie, jak i ręcznie.

Logowanie szczegółowe możesz włączyć w ten sposób:

1. W Xcode kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
2. W menu po lewej stronie kliknij Run (Uruchom).
3. Kliknij kartę Arguments (Argumenty).
4. W sekcji Arguments Passed On Launch (Argumenty przekazywane przy uruchomieniu) dodaj -FIRAnalyticsVerboseLoggingEnabled.

Przy następnym uruchomieniu aplikacji zdarzenia będą wyświetlane w konsoli debugowania Xcode, co pozwoli Ci od razu sprawdzić, czy są wysyłane.

Wyświetlanie zdarzeń na panelu

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

Ważne informacje o tym panelu:

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

• Panel jest aktualizowany okresowo w ciągu dnia. Aby przeprowadzić natychmiastowe testy, użyj danych wyjściowych z konsoli debugowania Xcode zgodnie z opisem w poprzedniej sekcji tego przewodnika.