Pierwsze kroki z Google Analytics na iOS+

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Z tego samouczka dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.

Google Analytics zbiera dane o użytkowaniu i zachowaniu w Twojej aplikacji. Pakiet SDK rejestruje 2 główne typy informacji:

  • Zdarzenia: co dzieje się w aplikacji, np. działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: atrybuty, które definiujesz, aby opisywać 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. Nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

  1. Dodaj Firebase do projektu Apple, jeśli jeszcze tego nie zrobiłeś(-aś), i upewnij się, że Google Analytics jest włączone w projekcie Firebase:

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

    • Jeśli używasz dotychczasowego projektu w Firebase bez włączonej usługi Google Analytics możesz ją włączyć na karcie Ustawienia > Integracje.

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

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

Dodawanie pakietu SDK Analytics do aplikacji

Do instalacji zależności Firebase i do zarządzania nimi możesz używać menedżera pakietów Swift.

  1. Po otwarciu projektu aplikacji wybierz w Xcode kolejno File > Add Packages (Plik > Dodaj pakiety).
  2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Wybierz bibliotekę Analytics.
  4. Dodaj flagę -ObjC do sekcji Other Linker Flags (Inne flagi konsolidatora) w ustawieniach kompilacji docelowej.
  5. Aby korzystać z Analytics w optymalny sposób, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie do aplikacji [pakietu] SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę bez zbierania identyfikatora IDFA lub z jego zbieraniem. Zapoznaj się z naszymi najczęstszymi pytaniami dotyczącymi najnowszej organizacji modułów w Google Analytics dla Firebase SDK.
  6. Gdy skończysz, Xcode zacznie automatycznie wyszukiwać i pobierać Twoje zależności w tle.

Więcej informacji o identyfikatorze IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystywania danych oraz przejrzystości śledzenia w aplikacjach.

Następnie wykonaj kilka czynności konfiguracyjnych:

  1. Zaimportuj moduł FirebaseCore w UIApplicationDelegate, a także inne moduły Firebase używane przez delegata aplikacji. Na przykład, aby używać 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ółdzieloną instancję w metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

    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ć delegata aplikacji i dołączyć go do struktury App za pomocą UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć swizzling delegata aplikacji. Więcej informacji znajdziesz w instrukcjach dotyczących 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łączanie rejestracji atrybucji w sieci reklamowej Apple

Dla Twojej wygody pakiet SDK automatycznie rejestruje Twoją aplikację w Apple w celu atrybucji w 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.

Rozpoczęcie rejestrowania zdarzeń

Po skonfigurowaniu instancji FirebaseApp możesz zacząć rejestrować zdarzenia za pomocą logEvent() metody.

Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji; a inne – w przypadku określonych typów firm lub branż. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje oraz aby móc korzystać z przyszłych funkcji i integracji, gdy tylko zostaną udostępnione, zalecane zdarzenia należy wysyłać z określonymi parametrami. W tej sekcji pokazujemy, jak rejestrować wstępnie zdefiniowane zdarzenie. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.

W tym przykładzie zobaczysz, jak zarejestrować zalecane zdarzenie, aby wskazać, że użytkownik kliknął określony element w aplikacji:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

  1. W Xcode wybierz kolejno Product > Scheme > Edit scheme... (Produkt > Schemat > Edytuj schemat...).
  2. W menu po lewej stronie kliknij Run (Uruchom).
  3. Kliknij kartę Arguments (Argumenty).
  4. W sekcji Arguments Passed On Launch (Argumenty przekazywane podczas uruchamiania) dodaj -FIRAnalyticsDebugEnabled.

Dalsze kroki