Zdarzenia w dzienniku

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

Zdarzenia dają wgląd w to, co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe i błędy.

Analytics automatycznie rejestruje niektóre zdarzenia. Aby je otrzymywać, nie musisz dodawać kodu. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej maksymalnie 500 różnych Analyticstypów zdarzeń. 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, spowoduje zarejestrowanie 2 różnych zdarzeń.

Zanim zaczniesz

Sprawdź, czy masz skonfigurowany projekt i czy możesz uzyskać dostęp do usługi Analytics zgodnie z opisem w artykule Początkujący: korzystanie z usługi Analytics.

Zdarzenia z dziennika

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

Aby ułatwić Ci rozpoczęcie korzystania z pakietu SDK, Analytics definiuje on kilka zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym 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.

Szczegółowe informacje o wdrożeniu znajdziesz w dokumentacji referencyjnej dotyczącej stałych w Swift i Objective-C.

Ten przykład pokazuje, jak rejestrować zalecane zdarzenie kFIRSelectContent:

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

Parametry niestandardowe: w raportach Analytics możesz używać parametrów niestandardowych jako wymiarów lub danych. 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. Gdy zarejestrujesz parametr niestandardowy 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.

Parametry niestandardowe możesz stosować w definicjach 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.
Parametr kFIRParameterValue: kFIRParameterValueto ogólny parametr, który służy do gromadzenia kluczowych danych dotyczących zdarzenia. Mogą to być na przykład przychody, odległość, czas i punkty.

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:

Swift

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

Objective-C

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

Ustawianie domyślnych parametrów zdarzenia

Parametry możesz rejestrować w przypadku różnych zdarzeń za pomocą parametru 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.

Swift

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

Objective-C

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

Jeśli w metodzie logEvent() podany jest parametr, to jego wartość jest używana zamiast wartości domyślnej.

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

Wyświetlanie zdarzeń w konsoli debugowania Xcode

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

Aby włączyć logowanie szczegółowe, wykonaj te czynności:

W Xcode kliknij Produkt > Schemat > Edytuj schemat….
W menu po lewej stronie kliknij Uruchom.
Kliknij kartę Argumenty.
W sekcji Argumenty przekazywane podczas uruchamiania dodaj:-FIRAnalyticsVerboseLoggingEnabled.

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

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ć natychmiastowe testowanie, 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ę.