Zacznij korzystać z Google Analytics

iOS+ Android Web Flutter

W tym przewodniku Szybki Start dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o użytkowaniu i zachowaniu Twojej aplikacji. SDK rejestruje dwa podstawowe typy informacji:

• Zdarzenia: co dzieje się w Twojej aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
• Właściwości użytkownika: atrybuty definiowane w celu opisania segmentów bazy użytkowników, takie jak preferencje językowe lub lokalizacja geograficzna.

Analytics automatycznie rejestruje niektóre zdarzenia i właściwości użytkownika ; nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

1. Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu Apple i upewnij się, że Google Analytics jest włączone w Twoim projekcie Firebase:

   • Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas procesu tworzenia projektu.

   • Jeśli używasz istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w > Ustawienia projektu, aby ją włączyć.

   Ostrzeżenie: każdy projekt Firebase utworzony przed 31 lipca 2019 r. musi zostać uaktualniony do pełnej wersji Google Analytics 4, jeśli jeszcze tego nie zrobił. (Banery wyświetlają się na pulpicie nawigacyjnym Analytics, jeśli wymagana jest aktualizacja). Warunki korzystania z usługi muszą zostać zaakceptowane do 15 lutego 2022 r., aby zapewnić kontynuację gromadzenia danych. Zobacz najczęściej zadawane pytania dotyczące pomocy technicznej dotyczące aktualizacji, aby uzyskać pomoc w znalezieniu właścicieli projektów .

   Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.

2. (Zalecane) . Dodaj platformę AdSupport do swojego projektu, aby włączyć dodatkowe funkcje, takie jak odbiorcy i atrybucja kampanii.

Dodaj pakiet Analytics SDK do swojej aplikacji

Użyj Menedżera pakietów Swift, aby zainstalować i zarządzać zależnościami Firebase.

Odwiedź nasz przewodnik instalacji, aby poznać różne sposoby dodawania zestawów SDK Firebase do projektu Apple, w tym bezpośrednie importowanie frameworków i korzystanie z CocoaPods.

1. W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
2. Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:

  https://github.com/firebase/firebase-ios-sdk

Uwaga: nowe projekty powinny korzystać z domyślnej (najnowszej) wersji SDK, ale w razie potrzeby możesz wybrać starszą wersję.
3. Wybierz bibliotekę Analytics.
4. Aby optymalnie korzystać z Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie pakietu Firebase SDK dla Google Analytics do swojej aplikacji. Możesz wybrać bibliotekę bez kolekcji IDFA lub z kolekcją IDFA.
5. Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.

Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji firmy Apple dotyczącej prywatności użytkownika i wykorzystania danych oraz przejrzystości śledzenia aplikacji .

Następnie wykonaj kilka kroków konfiguracyjnych:

1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase, z których korzysta delegat aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Szybki

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Cel C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Skonfiguruj udostępnioną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Szybki

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Cel C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury App za pośrednictwem UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor . Musisz także wyłączyć przełączanie delegatów aplikacji. Aby uzyskać więcej informacji, zobacz instrukcje SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Jeśli śledzisz zakupy w aplikacji, musisz zainicjować obserwatora transakcji w application:didFinishLaunchingWithOptions: przed zainicjowaniem Firebase, w przeciwnym razie obserwator może nie otrzymywać wszystkich powiadomień o zakupach. Aby uzyskać więcej informacji, zobacz najlepsze praktyki Apple dotyczące zakupów w aplikacji .

(Opcjonalnie) Wyłącz rejestrację atrybucji w sieci reklamowej Apple

Dla Twojej wygody pakiet SDK automatycznie rejestruje Twoją aplikację w firmie Apple w celu atrybucji sieci reklamowej za pomocą SKAdNetwork . Jeśli chcesz wyłączyć tę funkcję, ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED na NO (Boolean) w pliku info.plist aplikacji.

Rozpocznij rejestrowanie zdarzeń

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

Niektóre zdarzenia są zalecane dla wszystkich aplikacji ; inne są zalecane dla określonych rodzajów działalności lub branż. Powinieneś wysyłać sugerowane zdarzenia wraz z ich zalecanymi parametrami, aby zapewnić maksymalną dostępność szczegółów w raportach i skorzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanego zdarzenia. Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Rejestrowanie zdarzeń .

Poniższy przykład pokazuje, jak zarejestrować zalecane zdarzenie wskazujące, że użytkownik kliknął określony element w Twojej aplikacji:

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie macOS.

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

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie macOS.

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

Aby wyświetlić to zdarzenie w konsoli debugowania Xcode, włącz debugowanie Analytics:

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

Następne kroki

• Użyj DebugView , aby zweryfikować swoje zdarzenia.
• Eksploruj swoje dane w konsoli Firebase.
• Zapoznaj się z przewodnikami po zdarzeniach i właściwościach użytkowników.
• Dowiedz się, jak wyeksportować swoje dane do BigQuery.