Z tego przewodnika dowiesz się, jak rejestrować zdarzenia w aplikacji.
Zdarzenia dają wgląd w aktualny ruch w Twojej aplikacji, np. w formie działań użytkowników, zdarzeń systemowych lub błędów.
Analytics automatycznie rejestruje niektóre zdarzenia. Nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli aplikacja musi zbierać dodatkowe dane, możesz w niej rejestrować maksymalnie 500 różnych Analytics rodzajów zdarzeń. Nie ma limitu łącznej ilości rejestrowanych przez aplikację zdarzeń. Pamiętaj, że w nazwach zdarzeń wielkość liter ma znaczenie. Rejestrowanie 2 zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje rejestrowanie 2 osobnych zdarzeń.
Zanim zaczniesz
Sprawdź, czy masz skonfigurowany projekt i czy masz dostęp do Analytics zgodnie z opisem w artykule Rozpoczęcie korzystania z Analytics.
Zdarzenia z dziennika
Po skonfigurowaniu instancji FirebaseApp
możesz zacząć rejestrować zdarzenia za pomocą metody logEvent()
.
Aby ułatwić Ci rozpoczęcie pracy, pakiet SDK Analyticsdefiniuje szereg polecanych zdarzeń, które są typowe dla różnych rodzajó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 Polecane zdarzenia.
Szczegółowe informacje o implementacji znajdziesz w dokumentacji referencyjnej stałych w przypadku języków Swift i Objective-C.
Poniższy przykład pokazuje, jak rejestrować 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" }];
Poza określonymi parametrami możesz dodać do dowolnego zdarzenia te parametry:
Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w Analyticsraportach. Wymiarów niestandardowych możesz używać w przypadku nienumerycznych danych parametrów zdarzeń, a danych niestandardowych – w przypadku danych parametrów, które lepiej przedstawiają wartości liczbowe. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub rodzaj danych, aby te parametry niestandardowe pojawiały się w raportach Analytics. Możesz to zrobić w sekcji Analytics > Zdarzenia > Zarządzaj definicjami niestandardowymi > Utwórz wymiary niestandardowe.
Parametry niestandardowe można stosować w definicjach list odbiorców, które można 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 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. Są to na przykład przychody, odległość, czas i punkty.
Jeśli Twoja aplikacja ma specyficzne potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano 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
Za pomocą setDefaultEventParameters
możesz rejestrować parametry w różnych zdarzeniach.
Domyślne parametry 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 te parametry niestandardowe pojawiał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 parametr jest określony w metodzie logEvent()
, używana jest ta wartość zamiast wartości domyślnej.
Aby wyczyścić parametr domyślny, wywołaj metodę
setDefaultEventParameters
z parametrem ustawionym na nil
.
Wyświetlanie zdarzeń w konsoli debugowania Xcode
Możesz włączyć szczegółowe logowanie, aby monitorować logowanie zdarzeń przez pakiet SDK i sprawdzać, czy zdarzenia są logowane prawidłowo. Obejmuje to zdarzenia rejestrowane automatycznie i ręcznie.
Logowanie szczegółowe możesz włączyć w ten sposób:
- W Xcode kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
- W menu po lewej stronie kliknij Uruchom.
- Kliknij kartę Arguments (Argumenty).
- W sekcji Arguments Passed On Launch (Argumenty przekazywane przy uruchamianiu) 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
Zagregowane statystyki dotyczące zdarzeń możesz wyświetlać w Firebasepanelach konsoli. Te panele są okresowo aktualizowane w ciągu dnia. Aby natychmiast przetestować aplikację, użyj danych wyjściowych logcat zgodnie z opisem w poprzedniej sekcji.
Dostęp do tych danych możesz uzyskać w panelu Wydarzenia w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są automatycznie tworzone dla każdego odrębnego typu zdarzenia rejestrowanego przez Twoją aplikację.