Zdarzenia w dzienniku

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

Zdarzenia dostarczają informacji o tym, co dzieje się w aplikacji, np. o użytkownikach czynności, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje niektóre wydarzenia dla Ciebie, Ty nie muszą dodać kod, żeby je otrzymać. Jeśli aplikacja ma zbierać dodatkowe możesz zarejestrować maksymalnie 500 różnych typów zdarzeń Analytics w swojej aplikacji. Nie ma limitu całkowitej liczby zdarzeń rejestrowanych przez aplikację. Pamiętaj, że zdarzenie wielkość liter w nazwach jest rozróżniana, a logowanie 2 zdarzeń, których nazwy różnią się tylko daje dwa różne zdarzenia.

Zanim zaczniesz

Upewnij się, że Twój projekt jest skonfigurowany i masz dostęp do Analytics jako opisane w Pierwsze kroki z Analytics

Zdarzenia w dzienniku

Po skonfigurowaniu instancji FirebaseApp możesz rozpocząć logowanie wydarzenia z Metoda logEvent().

Aby ułatwić rozpoczęcie pracy, pakiet SDK Analytics określa szereg zalecane zdarzenia, które są typowe w różnych typach aplikacji, na przykład aplikacje związane z handlem detalicznym, e-commerce, podróżami i grami. Więcej informacji o tych wydarzeniach i ich używanie znajdziesz w sekcji Zalecane zdarzenia.

Szczegóły implementacji znajdziesz w odniesieniu do stałych wartości Swift i Objective-C.

Poniższy przykład pokazuje, jak zapisać rekomendowaną kFIRSelectContent zdarzenie:

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 określonych parametrów możesz dodać następujące parametry: do dowolnego wydarzenia:

  • Parametry niestandardowe: jako wymiarów lub danych w raportach Analytics. Wymiarów niestandardowych możesz używać w przypadku danych parametrów zdarzeń nieliczbowych oraz niestandardowe dla dowolnego parametru lepiej przedstawionego w postaci liczbowej. Jednorazowo zarejestrowano parametr niestandardowy za pomocą pakietu SDK, zarejestruj wymiar lub aby mieć pewność, że te parametry niestandardowe pojawią się w Analytics raportów. Możesz to zrobić za pomocą: Analytics > Wydarzenia > Zarządzaj niestandardowymi definicjami > Tworzenie wymiarów niestandardowych

    Parametry niestandardowe można stosować odbiorcy definicje, które można zastosować w każdym raporcie. Parametry niestandardowe są też uwzględniane w danych wyeksportowane do BigQuery, jeśli Twoja aplikacja jest połączona z projektem BigQuery. Przykładowe zapytania i inne informacje o Google Analytics 4 BigQuery Export.

  • Parametr kFIRParameterValue: kFIRParameterValue to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowych danych. które mają związek ze zdarzeniem. Mogą to być na przykład przychody, odległość, czas pkt.

Jeśli Twoja aplikacja ma konkretne potrzeby, których nie obejmuje zalecany 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

Możesz rejestrować parametry w różnych zdarzeniach za pomocą setDefaultEventParameters Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.

Tak jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzeń, aby mieć pewność, parametrów niestandardowych.

Swift 

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

Objective-C 

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

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

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

Wyświetl zdarzenia w konsoli debugowania Xcode

Możesz włączyć logowanie szczegółowe, aby monitorować logowanie zdarzeń przez pakiet SDK. sprawdzać, czy zdarzenia są prawidłowo rejestrowane. Uwzględniane są zarówno automatycznie, zdarzeń rejestrowanych ręcznie.

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

  1. W Xcode wybierz Product > (Produkt >) Schemat > Edytuj schemat...
  2. W menu po lewej stronie kliknij Uruchom.
  3. Wybierz kartę Argumenty.
  4. W sekcji Arguments Passed for Launch (Argumenty przekazane przy uruchomieniu) dodaj -FIRAnalyticsVerboseLoggingEnabled

Przy następnym uruchomieniu aplikacji zdarzenia zostaną wyświetlone w debugowaniu Xcode , dzięki czemu możesz natychmiast sprawdzić, czy zdarzenia są wysyłane.

Wyświetlanie zdarzeń w panelu

Zbiorcze statystyki swoich zdarzeń możesz wyświetlać w Panele konsoli Firebase. Te panele są okresowo aktualizowane w ciągu dnia. Aby przeprowadzić natychmiastowe testy, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.

Dostęp do tych danych możesz uzyskać w Wydarzenia w panelu Firebase. Ten panel pokazuje raporty o zdarzeniach tworzone automatycznie dla poszczególnych typów zdarzeń rejestrowanych przez do aplikacji.