Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o korzystaniu i zachowaniu Twojej aplikacji. 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 niektóre zdarzenia oraz 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ą. Upewnij się, że usługa Google Analytics jest włączona w Firebase projekt:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie zawiera włączona jest usługa Google Analytics, przejdź do Integracje karta na Twoim urządzeniu
. > Aby ją włączyć, Ustawienia projektu
Gdy włączysz Google Analytics w swoim projekcie, aplikacje Firebase są połączone ze strumieniami danych Google Analytics.
(Zalecane) Dodaj platformę AdSupport do projektu, aby włączyć dodatkowe funkcje np. o odbiorcach i atrybucji kampanii.
Dodawanie pakietu SDK Analytics do aplikacji
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ć optymalną wygodę korzystania z usługi Analytics, włączenie 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ć Cloud Firestore i Uwierzytelniania: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.
- Przeglądaj dane w konsoli Firebase.
- Przejrzyj przewodniki po wydarzeniach i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.