Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Rejestruj zdarzenia

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 pewne wydarzenia dla Ciebie; nie musisz dodawać żadnego kodu, aby je otrzymać. Jeśli Twoja aplikacja musi zbierać dodatkowe dane, można zalogować się do 500 różnych typów Analytics wydarzenie w swojej aplikacji. Nie ma limitu łącznej liczby zdarzeń rejestrowanych przez 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 ustawione projektu i mogą uzyskać dostęp do Analytics jak opisano w Pierwsze kroki z Analytics .

Rejestruj zdarzenia

Po skonfigurowaniu FirebaseApp instancji, można przystąpić do rejestrowania zdarzeń z logEvent() metody.

Aby ułatwić rozpoczęcie pracy, pakiet Analytics SDK definiuje szereg sugerowanych 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ć, przejrzyj artykuły [Wydarzenia i właściwości][suggested-events-hc] w Centrum pomocy Firebase.

Można znaleźć szczegóły realizacji w odniesieniu do stałych Swift i Objective-C .

Poniższy przykład pokazuje, jak zalogować sugerowaną kFIRSelectContent wydarzenie:

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:

  • Niestandardowe parametry: niestandardowe parametry mogą być rejestrowane za zgłoszenie w raportach Analytics. Mogą być również stosowane jako filtry w oglądalności definicji, które można zastosować do każdego raportu. Parametry niestandardowe są również zawarte w danych eksportowanych do BigQuery jeśli aplikacja jest powiązana z projektem BigQuery.

  • kFIRParameterValue parametr: kFIRParameterValue jest parametrem ogólnego przeznaczenia, które są przydatne do gromadzenia kluczowy parametr, który odnosi się do zdarzenia. Przykłady obejmują przychody, odległość, czas i punkty.

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

Parametry można zalogować całej imprez wykorzystujących setDefaultEventParameters . Parametry domyślne są powiązane ze wszystkimi przyszłymi zdarzeniami, które są rejestrowane.

Szybki

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

Cel C

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

Jeśli parametr jest specificed w logEvent() metodę, która wartość jest używana zamiast domyślnego.

Aby usunąć parametr domyślny, zadzwoń setDefaultEventParameters metodę z parametrem zestaw do 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 schemat produktu> Schemat> Edytuj ...
  2. Wybierz polecenie Uruchom z menu po lewej stronie.
  3. Wybierz zakładkę argumentów.
  4. W sekcji Argumenty przekazywane Launch, add -FIRAnalyticsDebugEnabled .

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 Zdarzenia desce rozdzielczej w konsoli Firebase. Ten panel zawiera raporty o zdarzeniach, które są tworzone automatycznie dla każdego typu zdarzenia zarejestrowanego przez Twoją aplikację.