Z tego krótkiego przewodnika dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.
Google Analytics zbiera dane o używaniu aplikacji i zachowaniach użytkowników. Pakiet SDK rejestruje 2 główne typy informacji:
- Zdarzenia: co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: atrybuty, które definiujesz, aby opisywać 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; nie musisz dodawać żadnego kodu, aby je włączyć.
Zanim zaczniesz
Jeśli nie korzystasz jeszcze z tej usługi, dodaj Firebase do projektu Apple i upewnij się, że w projekcie Firebase włączona jest usługa Google Analytics:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.
Jeśli używasz dotychczasowego projektu Firebase bez włączonej usługi Google Analytics, otwórz kartę Integracje w sekcji
, aby ją włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w projekcie, Twoje aplikacje Firebase zostaną połączone ze strumieniami danych Google Analytics.
(Zalecane) Dodaj bibliotekę AdSupport do projektu, aby włączyć dodatkowe funkcje, takie jak listy odbiorców i przypisywanie kampanii.
Dodawanie pakietu SDK Analytics do aplikacji
Do instalacji zależności Firebase i do zarządzania nimi możesz używać menedżera pakietów Swift.
- Po otwarciu projektu aplikacji wybierz w Xcode opcję File > Add Packages (Plik > Dodaj pakiety).
- Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
- Wybierz bibliotekę Analytics.
- Dodaj flagę
-ObjC
do sekcji Other Linker Flags (Inne flagi linkera) w ustawieniach kompilacji projektu. - Aby w pełni korzystać z 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 identyfikatora IDFA lub z jego zbieraniem. Zapoznaj się z naszymi odpowiedziami na najczęstsze pytania dotyczące najnowszej organizacji modułów w Google Analytics dla pakietu SDK Firebase.
- Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać zależności w tle.
https://github.com/firebase/firebase-ios-sdk.git
Więcej informacji o identyfikatorze IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz App Tracking Transparency.
Następnie wykonaj kilka czynności konfiguracyjnych:
- Zaimportuj moduł
FirebaseCore
w plikuUIApplicationDelegate
, a także inne moduły Firebase, których używa delegat aplikacji. Aby na przykład użyć właściwości 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 udostępnioną instancję
FirebaseApp
w metodzieapplication(_:didFinishLaunchingWithOptions:)
delegata aplikacji: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ć delegata aplikacji i dołączyć go do struktury
App
za pomocąUIApplicationDelegateAdaptor
lubNSApplicationDelegateAdaptor
. Musisz też wyłączyć zamianę delegata aplikacji. Więcej informacji znajdziesz w instrukcjach dotyczących 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
Aby ułatwić Ci pracę, pakiet SDK automatycznie rejestruje Twoją aplikację w Apple na potrzeby atrybucji sieci reklamowych za pomocą SKAdNetwork.
Jeśli chcesz wyłączyć tę funkcję, ustaw w pliku info.plist aplikacji wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
na NO
(wartość logiczna).
Rozpoczęcie rejestrowania zdarzeń
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ż. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje oraz aby móc korzystać z przyszłych funkcji i integracji, gdy tylko zostaną udostępnione, zalecane zdarzenia należy wysyłać z określonymi parametrami. W tej sekcji pokazujemy, jak rejestrować wstępnie zdefiniowane zdarzenie. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.
Poniższy przykład pokazuje, jak rejestrować 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 kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)…
- W menu po lewej stronie kliknij Uruchom.
- Kliknij kartę Arguments (Argumenty).
- W sekcji Arguments Passed On Launch (Argumenty przekazywane przy uruchamianiu) dodaj
-FIRAnalyticsDebugEnabled
.
Dalsze kroki
- Poznaj każdy raport Analytics.
- Aby sprawdzić zdarzenia, użyj raportu DebugView.
- Poznaj swoje dane w Firebasekonsoli.
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkownika.
- Dowiedz się, jak eksportować dane do BigQuery.