Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Rejestruj zdarzenia

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

na

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

Zdarzenia zapewniają wgląd w to, co dzieje się w Twojej aplikacji, takie jak działania użytkowników, zdarzenia systemowe lub błędy.

Analytics automatycznie rejestruje dla Ciebie niektóre zdarzenia ; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, możesz zarejestrować w niej do 500 różnych typów zdarzeń Analytics. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez Twoją aplikację. Należy pamiętać, że w nazwach zdarzeń rozróżniana jest wielkość liter, a rejestrowanie dwóch zdarzeń, których nazwy różnią się tylko wielkością liter, spowoduje powstanie dwóch odrębnych zdarzeń.

Zanim zaczniesz

Upewnij się, że masz skonfigurowany projekt i masz dostęp do Analytics zgodnie z opisem w artykule Pierwsze kroki z Analytics .

Rejestruj zdarzenia

Po skonfigurowaniu instancji FirebaseApp można rozpocząć rejestrowanie zdarzeń za pomocą metody logEvent() .

Aby ułatwić rozpoczęcie pracy, pakiet Analytics SDK definiuje szereg zalecanych zdarzeń, które są wspólne dla różnych typów aplikacji, w tym aplikacji do handlu detalicznego i e-commerce, podróży i gier. Aby dowiedzieć się więcej o tych zdarzeniach i kiedy ich używać, zobacz Polecane zdarzenia .

Szczegóły implementacji można znaleźć w dokumentacji stałych dla Swift i Objective-C .

Poniższy przykład pokazuje, jak zarejestrować zalecane zdarzenie kFIRSelectContent :

Szybki

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

Cel C

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

Oprócz określonych parametrów do dowolnego zdarzenia można dodać następujące parametry:

  • Parametry niestandardowe: parametry niestandardowe mogą być używane jako wymiary lub dane w raportach Analytics . Możesz użyć niestandardowych wymiarów w przypadku nieliczbowych danych parametrów zdarzeń, a niestandardowych danych w przypadku dowolnych danych parametrów lepiej przedstawionych w postaci liczbowej. Po zarejestrowaniu parametru niestandardowego za pomocą pakietu SDK zarejestruj wymiar lub dane, aby zapewnić wyświetlanie tych parametrów niestandardowych w raportach Analytics. W tym celu: Analytics > Zdarzenia > Zarządzaj niestandardowymi definicjami > Utwórz niestandardowe wymiary

    Parametry niestandardowe mogą być używane w definicjach odbiorców , które można zastosować do każdego raportu. 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 nie tylko znajdziesz w Google Analytics 4 BigQuery Export .

  • Parametr kFIRParameterValue : kFIRParameterValue to parametr ogólnego przeznaczenia, który jest przydatny do gromadzenia kluczowej metryki dotyczącej zdarzenia. Przykłady obejmują przychody, odległość, czas i punkty.

Jeśli Twoja aplikacja ma określone potrzeby, których nie obejmuje zalecany typ zdarzenia, możesz rejestrować własne zdarzenia niestandardowe, jak pokazano w tym przykładzie:

Szybki

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

Cel C

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

Ustaw domyślne parametry zdarzenia

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

Podobnie jak w przypadku parametrów niestandardowych, zarejestruj domyślne parametry zdarzeń, aby zapewnić wyświetlanie tych parametrów niestandardowych w raportach Analytics.

Szybki

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

Cel C

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

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

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

Wyświetl zdarzenia w konsoli debugowania Xcode

Możesz włączyć pełne rejestrowanie, aby monitorować rejestrowanie zdarzeń przez zestaw SDK, aby sprawdzić, czy zdarzenia są rejestrowane prawidłowo. Obejmuje to zarówno zdarzenia rejestrowane automatycznie, jak i ręcznie.

Pełne rejestrowanie można włączyć w następujący sposób:

  1. W Xcode wybierz Produkt > Schemat > Edytuj schemat...
  2. Wybierz Uruchom z lewego menu.
  3. Wybierz kartę Argumenty .
  4. W sekcji Argumenty przekazane podczas uruchamiania dodaj -FIRAnalyticsVerboseLoggingEnabled .

Przy następnym uruchomieniu aplikacji zdarzenia zostaną wyświetlone w konsoli debugowania Xcode, co pomoże natychmiast sprawdzić, czy zdarzenia są wysyłane.

Zobacz wydarzenia w desce rozdzielczej

Zagregowane statystyki dotyczące zdarzeń możesz wyświetlić w pulpitach nawigacyjnych konsoli Firebase. Te pulpity nawigacyjne aktualizują się okresowo w ciągu dnia. Do natychmiastowego testowania użyj danych wyjściowych logcat, jak opisano w poprzedniej sekcji.

Możesz uzyskać dostęp do tych danych z panelu Zdarzenia w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego typu zdarzenia zarejestrowanego przez Twoją aplikację.