Rozpoczęcie korzystania z Google Analytics

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

Google Analytics zbiera dane o korzystaniu i zachowaniu Twojej aplikacji. 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 niektóre zdarzenia oraz 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ą. Upewnij się, że usługa Google Analytics jest włączona w Firebase projekt:

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

    • Jeśli używasz istniejącego projektu Firebase, który nie zawiera włączona jest usługa Google Analytics, przejdź do Integracje karta na Twoim urządzeniu > Aby ją włączyć, Ustawienia projektu.

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

  2. (Zalecane) Dodaj platformę AdSupport do projektu, aby włączyć dodatkowe funkcje np. o odbiorcach i atrybucji 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. 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
  3. Wybierz bibliotekę Analytics.
  4. Dodaj flagę -ObjC do sekcji Inne flagi łączące w ustawieniach kompilacji celu.
  5. Aby zapewnić optymalną wygodę korzystania z usługi Analytics, włączenie 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.
  6. 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ć Cloud Firestore i Uwierzytelniania:

    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",
])
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 > (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