Zdarzenia w dzienniku

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Zdarzenia pozwalają uzyskać wgląd w to, 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, więc nie musisz dodawać żadnego kodu, aby je otrzymywać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz rejestrować w niej maksymalnie 500 różnych Analyticsrodzajów zdarzeń. Nie ma limitu łącznej ilości 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 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.

Jeśli chcesz zbierać dane o atrybucji w kampanii, dodaj do projektu bibliotekę AdSupport.

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óły 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("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

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

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. Aby to zrobić, w konsoli Firebase otwórz Analytics > Definicje 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. Przykłady to 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,
  "full_text": text,
])

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ć logowanie szczegółowe, 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:

  1. W Xcode kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
  2. W menu po lewej stronie kliknij Uruchom.
  3. Kliknij kartę Arguments (Argumenty).
  4. 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

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

Ważne informacje o tym panelu:

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

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