了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Rozpoczęcie korzystania z Google Analytics

W tym przewodniku Szybki Start dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o użytkowaniu i zachowaniu Twojej aplikacji. SDK rejestruje dwa podstawowe typy informacji:

  • Zdarzenia: co dzieje się w Twojej aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: atrybuty definiowane w celu opisania segmentów bazy użytkowników, takie jak preferencje językowe lub lokalizacja geograficzna.

Analytics automatycznie rejestruje niektóre zdarzenia i właściwości użytkownika ; nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

  1. 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, który nie ma włączonej usługi 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.

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

Dodaj pakiet Analytics SDK do swojej aplikacji

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

  1. W Xcode przy otwartym projekcie aplikacji przejdź do File > Add Packages .
  2. Po wyświetleniu monitu dodaj repozytorium Firebase Apple platforms SDK:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Wybierz bibliotekę Analytics.
  4. Aby optymalnie korzystać z Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie pakietu Firebase SDK dla Google Analytics do swojej aplikacji. Możesz wybrać bibliotekę bez kolekcji IDFA lub z kolekcją IDFA.
  5. Po zakończeniu Xcode automatycznie rozpocznie rozwiązywanie i pobieranie zależności w tle.

Dowiedz się więcej o IDFA, identyfikatorze reklamowym na poziomie urządzenia, w dokumentacji firmy Apple dotyczącej prywatności użytkownika i wykorzystania danych oraz przejrzystości śledzenia aplikacji .

Następnie wykonaj kilka kroków konfiguracyjnych:

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase, z których korzysta delegat aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:

    SwiftUI

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

    Szybki

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Cel C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Skonfiguruj udostępnioną instancję FirebaseApp w metodzie application application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

    SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Szybki

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Cel C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. Jeśli używasz SwiftUI, musisz utworzyć delegata aplikacji i dołączyć go do struktury App za pośrednictwem UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor . Musisz także wyłączyć przełączanie delegatów aplikacji. Aby uzyskać więcej informacji, zobacz instrukcje 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 w sieci reklamowej Apple

Dla Twojej wygody pakiet SDK automatycznie rejestruje Twoją aplikację w firmie Apple w celu atrybucji sieci reklamowej za pomocą SKAdNetwork . Jeśli chcesz wyłączyć tę funkcję, ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED na NO (Boolean) w pliku info.plist aplikacji.

Rozpocznij rejestrowanie zdarzeń

Po skonfigurowaniu instancji FirebaseApp możesz 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ż. Powinieneś wysyłać sugerowane zdarzenia wraz z ich zalecanymi parametrami, aby zapewnić maksymalną dostępność szczegółów w raportach i skorzystać 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 wskazujące, że użytkownik kliknął określony element w Twojej aplikacji:

Szybki

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie macOS.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Cel C

Uwaga: ten produkt Firebase nie jest dostępny w docelowym systemie 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 Produkt > Schemat > Edytuj schemat...
  2. Wybierz Uruchom z lewego menu.
  3. Wybierz kartę Argumenty .
  4. W sekcji Argumenty przekazywane podczas uruchamiania dodaj opcję -FIRAnalyticsDebugEnabled .

Następne kroki