Z tego krótkiego wprowadzenia 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. SDK rejestruje dwa podstawowe typy informacji:
- Zdarzenia: co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.
- Właściwości użytkownika: atrybuty, które definiujesz, aby opisać segmenty bazy użytkowników, takie jak preferencje językowe 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 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, w którym nie włączono 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 atrybucja odbiorców i kampanii.
Dodaj pakiet Analytics SDK 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 pozycji Plik > Dodaj pakiety .
- Po wyświetleniu monitu dodaj repozytorium SDK platformy Firebase Apple:
- Wybierz bibliotekę Analytics.
- 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żesz wybrać bibliotekę bez zbierania IDFA lub z kolekcją IDFA.
- Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie twoich 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 Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz przejrzystości śledzenia aplikacji .
Następnie wykonaj kilka czynności konfiguracyjnych:
- Zaimportuj moduł
FirebaseCore
do swojegoUIApplicationDelegate
, a także wszelkie inne moduły Firebase używane przez delegata aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:Szybki
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Cel C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Skonfiguruj współużytkowane wystąpienie
FirebaseApp
, zwykle w inicjatorzeApp
lub w metodzieapplication(_:didFinishLaunchingWithOptions:)
:Szybki
// Use Firebase library to configure APIs FirebaseApp.configure()
Cel C
// Use Firebase library to configure APIs [FIRApp configure];
(Opcjonalnie) Wyłącz rejestrację atrybucji sieci reklamowej Apple
Dla Twojej wygody zestaw SDK automatycznie rejestruje Twoją aplikację w Apple w celu przypisania jej do sieci reklamowej za pomocą SKAdNetwork . Jeśli chcesz wyłączyć tę funkcję, ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
na NO
(wartość logiczna) w pliku info.plist aplikacji.
Rozpocznij rejestrowanie zdarzeń
Po skonfigurowaniu instancji FirebaseApp
można 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ż. Należy wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać 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, 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 Uruchom z lewego menu.
- Wybierz kartę Argumenty .
- W sekcji Argumenty przekazane podczas uruchamiania dodaj
-FIRAnalyticsDebugEnabled
.
Następne kroki
- Użyj DebugView , aby zweryfikować swoje zdarzenia.
- Przeglądaj swoje dane w konsoli Firebase.
- Zapoznaj się z przewodnikami po wydarzeniach i właściwościach użytkowników.
- Dowiedz się, jak wyeksportować swoje dane do BigQuery.