Rozpoczęcie korzystania z Google Analytics


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

Google Analytics zbiera dane o korzystaniu z aplikacji i jej działaniu. Pakiet SDK rejestruje dwa główne typy informacji:

  • Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeń lub błędów.
  • Właściwości użytkownika: atrybuty, które określasz, by opisać segmenty swojej witryny bazy użytkowników, np. ich ustawień języka lub położenia geograficznego.

Analytics automatycznie rejestruje część wydarzeń i właściwości użytkownika, nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

  1. Dodaj Firebase do swojego projektu Apple, chyba że masz to już za sobą. i upewnij się, że usługa Google Analytics jest włączona w Firebase projekt:

    • Jeśli tworzysz nowy projekt Firebase, włącz funkcję Google Analytics podczas tworzenia projektu.

    • Jeśli używasz istniejącego projektu Firebase, który nie zawiera Włączono Google Analytics, otwórz Integracje na karcie > Ustawienia projektu, aby je włączyć.

    .

    Gdy włączysz Google Analytics w swoim projekcie, aplikacje Firebase są połączone z Google Analytics strumieniami danych.

  2. (Zalecane) Dodaj platformę AdSupport do projektu, aby włączyć dodatkowe funkcje np. o odbiorcach i atrybucji kampanii.

Dodaj do aplikacji pakiet SDK Analytics

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

  1. W Xcode po otwarciu projektu aplikacji przejdź do File > 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
  4. Wybierz bibliotekę Analytics.
  5. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  6. Aby zapewnić optymalne działanie usługi Analytics, zalecamy włączam Google Analytics w projekcie Firebase i dodając do aplikacji pakiet SDK Firebase dla Google Analytics. Dostępne opcje wybrać bibliotekę bez zbierania danych IDFA lub z zbieraniem tych danych.
  7. Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.

Więcej informacji o IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji firmy Apple Prywatność użytkownika i korzystanie z danych oraz Przejrzystość śledzenia aplikacji dokumentacji.

Następnie wykonaj kilka czynności konfiguracyjnych:

  1. Zaimportuj moduł FirebaseCore do UIApplicationDelegate, jak i wszelkie inne Moduły Firebase używane przez przedstawiciela aplikacji. Aby na przykład użyć atrybutów 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;
    // ...
          
  2. Skonfiguruj FirebaseApp współdzielonej instancji w uprawnieniach przedstawiciela aplikacji Metoda application(_:didFinishLaunchingWithOptions:):

    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ć i dołączyć przedstawiciela aplikacji. do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor Musisz też wyłączyć przełączanie przekazywania dostępu do aplikacji. Dla: więcej informacji znajdziesz w instrukcjach 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 pakiet SDK automatycznie rejestracje aplikacji za pomocą Apple. SKAdNetwork. Jeśli chcesz wyłączyć tę funkcję, ustaw wartość Od GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED do NO (wartość logiczna) w do pliku info.plist aplikacji.

Zacznij rejestrować zdarzenia

Po skonfigurowaniu instancji FirebaseApp możesz rozpocząć logowanie wydarzenia z logEvent(). .

Niektóre wydarzenia zalecana w przypadku wszystkich aplikacji; inne są zalecane w przypadku określonych typów działalności lub branż. Należy wysłać zdarzeń z zalecanymi parametrami, aby zapewnić maksymalną dostępne szczegóły w raportach oraz możliwość korzystania z przyszłych funkcji i integracje, gdy tylko będą dostępne. W tej sekcji omawiamy logowanie wstępnie zdefiniowane zdarzenie, aby dowiedzieć się więcej rejestrowanie zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.

Poniższy przykład pokazuje, jak rejestrować zalecane zdarzenie, aby wskazać, użytkownik kliknął określony element w Twojej 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",
])

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"
                                 }];

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

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

Dalsze kroki