Pierwsze kroki z Google Analytics na iOS+

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


Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.

Google Analytics zbiera dane o użytkowaniu i zachowaniu w 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ć.

Aby uzyskać pomoc AI, skopiuj poniższego prompta do asystenta kodowania AI (takiego jak Antigravity, Claude Code, Codex czy Cursor). Możesz dostosować prompta i wprowadzać zmiany z agentem. Szczegółowe informacje o instalacji znajdziesz w artykule Umiejętności agenta Firebase. 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Google Analytics for Firebase and log screen view events in my app.

Zanim zaczniesz

  1. Dodaj Firebase do projektu aplikacji na platformę Apple, jeśli nie korzystasz w nim jeszcze z tej usługi, i upewnij się, że w projekcie Firebase jest włączona usługa Google Analytics:

    • 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 w 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.

Dodaj pakiet SDK Analytics do aplikacji

Do instalowania zależności Firebase i zarządzania nimi używaj menedżera pakietów Swift.

  1. W Xcode, po otwarciu projektu aplikacji, kliknij 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 łączące) w ustawieniach kompilacji celu.
  5. Aby zapewnić optymalne działanie Analytics, zalecamy włączenie Google Analytics w projekcie w Firebase i dodanie do aplikacji pakietu SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę bez zbierania identyfikatorów IDFA lub ze zbieraniem identyfikatorów IDFA. Zapoznaj się z najczęstszymi pytaniami dotyczącymi najnowszej organizacji modułów w pakiecie SDK Google Analytics dla Firebase.
  6. Gdy skończysz, Xcode zacznie automatycznie przetwarzać i pobierać zależności w tle.

Więcej informacji o IDFA, czyli identyfikatorze wyświetlania reklam na poziomie urządzenia, znajdziesz w dokumentacji Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz zasad App Tracking Transparency.

Następnie wykonaj te czynności konfiguracyjne:

  1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także inne moduły Firebase, których używa delegat aplikacji. Aby na przykład użyć właściwości 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 udostępnioną instancję FirebaseApp 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ć obiekt delegowany 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 sieci reklamowej Apple

Dla Twojej wygody pakiet SDK automatycznie rejestruje aplikację w Apple na potrzeby atrybucji 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ą metody logEvent().

Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji, a inne – w przypadku konkretnych rodzajów działalności 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ń.

Poniższy przykład pokazuje, 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 kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (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 przy uruchamianiu) dodaj -FIRAnalyticsDebugEnabled.

Dalsze kroki