Z tego przewodnika Szybki start dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane dotyczące użytkowania i zachowania Twojej aplikacji. Zestaw SDK rejestruje dwa podstawowe typy informacji:
- Zdarzenia: co dzieje się w Twojej aplikacji, np. działania użytkownika, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: Atrybuty, które definiujesz 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 tworzenia projektu.
Jeśli korzystasz z istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w swoim
Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
(Zalecana) . Dodaj platformę AdSupport do swojego projektu, aby włączyć dodatkowe funkcje, takie jak odbiorcy i przypisywanie kampanii.
Dodaj pakiet SDK Analytics do swojej aplikacji
Użyj Menedżera pakietów Swift, aby zainstalować zależności Firebase i zarządzać nimi.
- W Xcode, przy otwartym projekcie aplikacji, przejdź do File > Add Packages .
- Po wyświetleniu monitu dodaj repozytorium SDK platform Firebase Apple:
- Wybierz bibliotekę Analytics.
- Dodaj flagę
-ObjC
do sekcji Inne flagi linkera w ustawieniach kompilacji celu. - Aby zapewnić optymalne działanie Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie pakietu SDK Firebase dla Google Analytics do swojej aplikacji. Można 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.git
Więcej informacji na temat identyfikatora IDFA, identyfikatora reklamowego na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników 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, których używa 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 aplikacji delegataapplication(_:didFinishLaunchingWithOptions:)
metoda: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, zapoznaj się z instrukcjami 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 zestaw SDK automatycznie rejestruje Twoją aplikację w Apple w celu przypisania sieci reklamowej w SKAdNetwork . Jeśli chcesz wyłączyć tę funkcję, ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
na NO
(boolean) w pliku info.plist swojej 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 określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i móc korzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanych zdarzeń. Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Rejestrowanie zdarzeń .
Poniższy przykład pokazuje, jak zarejestrować zalecane zdarzenie, aby wskazać, ż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 opcję Uruchom z lewego menu.
- Wybierz zakładkę Argumenty .
- W sekcji Argumenty przekazywane przy uruchomieniu dodaj
-FIRAnalyticsDebugEnabled
.
Następne kroki
- Zrozumienie każdego raportu Analytics .
- Użyj DebugView , aby zweryfikować swoje zdarzenia.
- Eksploruj swoje dane w konsoli Firebase.
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.