Rozpoczęcie korzystania z Google Analytics

Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o działaniu i użytkowaniu aplikacji. Pakiet SDK rejestruje 2 główne rodzaje informacji:

  • Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: atrybuty definiowane przez Ciebie, aby opisać 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. Aby je włączyć, nie musisz dodawać żadnego kodu.

Zanim zaczniesz

  1. Dodaj Firebase do swojego projektu Apple i sprawdź, czy usługa Google Analytics jest włączona w Twoim projekcie Firebase:

    • Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.

    • Jeśli korzystasz z istniejącego projektu Firebase, w którym nie masz włączonej usługi Google Analytics, otwórz kartę Integracje w sekcji > 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.

  2. (Zalecane) Dodaj do projektu platformę AdSupport, aby włączyć dodatkowe funkcje, takie jak odbiorcy i atrybucja kampanii.

Dodawanie pakietu SDK Analytics do aplikacji

Użyj menedżera pakietów Swift, aby zainstalować zależności Firebase i nimi zarządzać.

  1. Po otwarciu projektu aplikacji przejdź w Xcode do File > Add Packages (Plik > Dodaj pakiety).
  2. Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wybierz bibliotekę Analytics.
  4. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  5. Aby zapewnić optymalną jakość usługi 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 danych IDFA lub z zbieraniem identyfikatorów IDFA.
  6. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie zależności w tle.

Więcej informacji o IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple dotyczącej prywatności użytkownika i korzystania z danych oraz usługi App Tracking Transparency.

Następnie wykonaj kilka czynności konfiguracyjnych:

  1. Zaimportuj moduł FirebaseCore do obiektu UIApplicationDelegate, a także wszystkie inne moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć Cloud Firestore i Uwierzytelniania:

    Certyfikat SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Skonfiguruj współdzieloną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) przedstawiciela aplikacji:

    Certyfikat 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];
  3. Jeśli używasz SwiftUI, musisz utworzyć przedstawiciela aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Więcej informacji znajdziesz w instrukcjach SwiftUI.

    Certyfikat 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 ten pakiet SDK automatycznie rejestruje aplikację w usłudze Apple na potrzeby atrybucji sieci reklamowej w systemie 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.

Zacznij rejestrować zdarzenia

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ż. Sugerowane zdarzenia należy przesyłać wraz z określonymi parametrami, aby zapewnić maksymalną ilość szczegółów dostępnych w raportach oraz korzystać z przyszłych funkcji i integracji, gdy tylko będą dostępne. Ta sekcja pokazuje, jak logować wstępnie zdefiniowane zdarzenie. Więcej informacji o logowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.

Ten przykład pokazuje, jak zarejestrować zalecane zdarzenie, aby wskazać, że użytkownik kliknął określony element w aplikacji:

Swift

Uwaga: ta usługa Firebase jest niedostępna w miejscu docelowym macOS. 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

Uwaga: ta usługa Firebase jest niedostępna w miejscu docelowym macOS. 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

Aby wyświetlić to zdarzenie w konsoli debugowania Xcode, włącz debugowanie Analytics:

  1. W Xcode wybierz Product > Scheme > Edit schema... (Produkt > Schemat > Edytuj schemat...)
  2. W menu po lewej stronie kliknij Uruchom.
  3. Wybierz kartę Argumenty.
  4. W sekcji Arguments Passed On Launch (Argumenty przekazane przy uruchomieniu) dodaj parametr -FIRAnalyticsDebugEnabled.

Dalsze kroki