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
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ć.
Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
(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.
- W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
- Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
- Wybierz bibliotekę Analytics.
- 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.
- Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.
https://github.com/firebase/firebase-ios-sdk
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:
- Zaimportuj moduł
FirebaseCore
do swojegoUIApplicationDelegate
, 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; // ...
- Skonfiguruj udostępnioną instancję
FirebaseApp
w metodzie applicationapplication(_: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];
- Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury
App
za pośrednictwemUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. 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() } } } }
(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
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" }];
Aby wyświetlić to zdarzenie w konsoli debugowania Xcode, włącz debugowanie Analytics:
- W Xcode wybierz Produkt > Schemat > Edytuj schemat...
- Wybierz Uruchom z lewego menu.
- Wybierz kartę Argumenty .
- W sekcji Argumenty przekazywane podczas uruchamiania dodaj opcję
-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.