Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji i rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o działaniu i użytkowaniu aplikacji. Pakiet SDK rejestruje 2 główne rodzaje informacji:
- Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: atrybuty definiowane przez Ciebie, aby opisać segmenty użytkowników, np. ustawienia języka lub położenie geograficzne.
Analytics automatycznie rejestruje niektóre zdarzenia i właściwości użytkownika. Aby je włączyć, nie musisz dodawać żadnego kodu.
Zanim zaczniesz
Dodaj Firebase do swojego projektu Apple i sprawdź, czy usługa Google Analytics jest włączona w Twoim projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.
Jeśli korzystasz z istniejącego projektu Firebase, w którym nie masz włączonej usługi Google Analytics, otwórz kartę Integracje w sekcji
, aby ją włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
(Zalecane) Dodaj do projektu platformę AdSupport, aby włączyć dodatkowe funkcje, takie jak odbiorcy i atrybucja kampanii.
Dodawanie pakietu SDK Analytics do aplikacji
Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.
- Po otwarciu projektu aplikacji przejdź w Xcode do File > Add Packages (Plik > Dodaj pakiety).
- Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
- Wybierz bibliotekę Analytics.
- Dodaj flagę
-ObjC
do sekcji Inne flagi łączące w ustawieniach kompilacji celu. - Aby zapewnić optymalną jakość usługi Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie do aplikacji pakietu SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę bez zbierania danych IDFA lub z zbieraniem identyfikatorów IDFA.
- Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie zależności w tle.
https://github.com/firebase/firebase-ios-sdk.git
Więcej informacji o IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkownika i korzystania z danych oraz usługi App Tracking Transparency.
Następnie wykonaj kilka czynności konfiguracyjnych:
- Zaimportuj moduł
FirebaseCore
do obiektuUIApplicationDelegate
, a także wszystkie inne moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania:Certyfikat SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj współdzieloną instancję
FirebaseApp
w metodzieapplication(_:didFinishLaunchingWithOptions:)
przedstawiciela aplikacji:Certyfikat SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Jeśli używasz SwiftUI, musisz utworzyć przedstawiciela aplikacji i dołączyć go do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Więcej informacji znajdziesz w instrukcjach SwiftUI.Certyfikat SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
(Opcjonalnie) Wyłącz rejestrację atrybucji sieci reklamowej Apple
Dla Twojej wygody ten pakiet SDK automatycznie rejestruje
aplikację w usłudze Apple na potrzeby atrybucji sieci reklamowej w systemie SKAdNetwork.
Jeśli chcesz wyłączyć tę funkcję, ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
na NO
(wartość logiczna) w pliku info.plist aplikacji.
Zacznij rejestrować zdarzenia
Po skonfigurowaniu instancji FirebaseApp
możesz zacząć rejestrować zdarzenia za pomocą metody logEvent()
.
Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji, a inne w przypadku określonych rodzajów działalności lub branż. Sugerowane zdarzenia należy przesyłać wraz z określonymi parametrami, aby zapewnić maksymalną ilość szczegółów dostępnych w raportach oraz korzystać z przyszłych funkcji i integracji, gdy tylko będą dostępne. Ta sekcja pokazuje, jak logować wstępnie zdefiniowane zdarzenie. Więcej informacji o logowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.
Ten przykład pokazuje, jak zarejestrować zalecane zdarzenie, aby wskazać, że użytkownik kliknął określony element w aplikacji:
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" }];
Aby wyświetlić to zdarzenie w konsoli debugowania Xcode, włącz debugowanie Analytics:
- W Xcode wybierz Product > Scheme > Edit schema... (Produkt > Schemat > Edytuj schemat...)
- W menu po lewej stronie kliknij Uruchom.
- Wybierz kartę Argumenty.
- W sekcji Arguments Passed On Launch (Argumenty przekazane przy uruchomieniu) dodaj parametr
-FIRAnalyticsDebugEnabled
.
Dalsze kroki
- Zapoznaj się z każdym raportem Analytics.
- Do weryfikowania zdarzeń służy DebugView.
- Przeglądaj dane w konsoli Firebase.
- Przejrzyj przewodniki po zdarzeniach i właściwościach użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.