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 za Ciebie. Nie musisz dodawać żadnego kodu, aby je odbierać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej maksymalnie 500 różnych typów zdarzeń Analytics. 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óły implementacji znajdziesz w dokumentacji stałych dla Swift i Objective-C.
Ten przykład pokazuje, jak zarejestrować zalecane zdarzenie kFIRSelectContent
:
Swift
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [ AnalyticsParameterItemID: "id-\(title!)", AnalyticsParameterItemName: title!, AnalyticsParameterContentType: "cont", ])
Objective-C
[FIRAnalytics logEventWithName:kFIREventSelectContent parameters:@{ kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title], kFIRParameterItemName:self.title, kFIRParameterContentType:@"image" }];
Oprócz parametrów zalecanych możesz dodawać do dowolnego zdarzenia te parametry:
Parametry niestandardowe: w Analyticsraportach można używać parametrów niestandardowych jako wymiarów lub danych. Wymiarów niestandardowych możesz używać w przypadku niearytmetycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku dowolnych danych parametrów, które lepiej przedstawiają się w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj go lub dane, aby mieć pewność, że parametry niestandardowe pojawią się w raportach Analytics. Aby to zrobić, kliknij Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.
Parametry niestandardowe można stosować w definicjach odbiorców, które mają być stosowane do wszystkich raportów. 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
:kFIRParameterValue
to 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, ])
Objective-C
[FIRAnalytics logEventWithName:@"share_image" parameters:@{ @"name": name, @"full_text": text }];
Ustawianie domyślnych parametrów zdarzenia
Parametry możesz rejestrować w różnych zdarzeniach 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 rejestruj domyślne parametry zdarzeń, aby mieć pewność, że będą one widoczne 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świetl zdarzenia 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 wybierz Product > Scheme > Edit schema... (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 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.
Te dane są dostępne w panelu Zdarzenia w konsoli Firebase. Ten panel pokazuje raporty o zdarzeniach, które są tworzone automatycznie dla każdego rodzaju zdarzenia rejestrowanego przez Twoją aplikację.