Z tego krótkiego wprowadzenia dowiesz się, jak dodać usługę Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o korzystaniu z aplikacji i jej działaniu. Pakiet SDK rejestruje dwa główne typy informacji:
- Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeń lub błędów.
- Właściwości użytkownika: atrybuty, które określasz, by opisać segmenty swojej witryny bazy użytkowników, np. ich ustawień języka lub położenia geograficznego.
Analytics automatycznie rejestruje część wydarzeń i właściwości użytkownika, nie musisz dodawać żadnego kodu, aby je włączyć.
Zanim zaczniesz
Dodaj Firebase do swojego projektu Apple, chyba że masz to już za sobą. i upewnij się, że usługa Google Analytics jest włączona w Firebase projekt:
Jeśli tworzysz nowy projekt Firebase, włącz funkcję Google Analytics podczas tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie zawiera Włączono Google Analytics, otwórz Integracje na karcie
, aby je włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w swoim projekcie, aplikacje Firebase są połączone z Google Analytics strumieniami danych.
(Zalecane) Dodaj platformę AdSupport do projektu, aby włączyć dodatkowe funkcje np. o odbiorcach i atrybucji kampanii.
Dodaj do aplikacji pakiet SDK Analytics
Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.
- W Xcode po otwarciu projektu aplikacji przejdź do File > 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ć optymalne działanie usługi Analytics, zalecamy włączam Google Analytics w projekcie Firebase i dodając do aplikacji pakiet SDK Firebase dla Google Analytics. Dostępne opcje wybrać bibliotekę bez zbierania danych IDFA lub z zbieraniem tych danych.
- Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub 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 Prywatność użytkownika i korzystanie z danych oraz Przejrzystość śledzenia aplikacji dokumentacji.
Następnie wykonaj kilka czynności konfiguracyjnych:
- Zaimportuj moduł
FirebaseCore
doUIApplicationDelegate
, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć atrybutów Cloud Firestore i Authentication: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
FirebaseApp
współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metodaapplication(_:didFinishLaunchingWithOptions:)
: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ć i dołączyć przedstawiciela aplikacji.
do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: więcej informacji znajdziesz w instrukcjach SwiftUI.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 pakiet SDK automatycznie
rejestracje
aplikacji za pomocą Apple.
SKAdNetwork.
Jeśli chcesz wyłączyć tę funkcję, ustaw wartość
Od GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
do NO
(wartość logiczna) w
do pliku info.plist aplikacji.
Zacznij rejestrować zdarzenia
Po skonfigurowaniu instancji FirebaseApp
możesz rozpocząć logowanie
wydarzenia z
logEvent()
.
Niektóre wydarzenia zalecana w przypadku wszystkich aplikacji; inne są zalecane w przypadku określonych typów działalności lub branż. Należy wysłać zdarzeń z zalecanymi parametrami, aby zapewnić maksymalną dostępne szczegóły w raportach oraz możliwość korzystania z przyszłych funkcji i integracje, gdy tylko będą dostępne. W tej sekcji omawiamy logowanie wstępnie zdefiniowane zdarzenie, aby dowiedzieć się więcej rejestrowanie zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.
Poniższy przykład pokazuje, jak rejestrować zalecane zdarzenie, aby wskazać, użytkownik kliknął określony element w Twojej 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 > (Produkt >) Schemat > Edytuj schemat...
- W menu po lewej stronie kliknij Uruchom.
- Wybierz kartę Argumenty.
- W sekcji Arguments Passed for Launch (Argumenty przekazane przy uruchomieniu) dodaj
-FIRAnalyticsDebugEnabled
Dalsze kroki
- Zapoznaj się z każdym raportem Analytics.
- Do weryfikowania zdarzeń służy DebugView.
- Przejrzyj swoje dane w konsoli Firebase.
- Przejrzyj przewodniki po wydarzeniach i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.