Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Zacznij korzystać z Google Analytics

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

na

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

Google Analytics zbiera dane dotyczące użytkowania i zachowania Twojej aplikacji. SDK rejestruje dwa podstawowe typy informacji:

  • Zdarzenia: co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.
  • Właściwości użytkownika: atrybuty, które definiujesz, aby opisać segmenty bazy użytkowników, takie jak preferencje językowe 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. 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, w którym nie włączono 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 atrybucja odbiorców i 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 pliku > Dodaj pakiety .
  2. Po wyświetleniu monitu dodaj repozytorium SDK platformy Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Wybierz bibliotekę Analytics.
  5. Aby zapewnić optymalne działanie Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie pakietu SDK Firebase dla Google Analytics do swojej aplikacji. Możesz wybrać bibliotekę bez zbierania IDFA lub z kolekcją IDFA.
  6. 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 Apple dotyczącej prywatności użytkowników i wykorzystania danych oraz przejrzystości śledzenia aplikacji .

Następnie wykonaj kilka czynności konfiguracyjnych:

  1. Zaimportuj moduł FirebaseCore do swojego UIApplicationDelegate , a także wszelkie inne moduły Firebase używane przez delegata aplikacji. Na przykład, aby użyć Cloud Firestore i uwierzytelniania:

    Szybki

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Cel C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Skonfiguruj współużytkowane wystąpienie FirebaseApp , zwykle w inicjatorze App lub w metodzie application(_:didFinishLaunchingWithOptions:) delegata aplikacji:

    Szybki

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

    Cel C

    // Use Firebase library to configure APIs
    [FIRApp configure];


(Opcjonalnie) Wyłącz rejestrację atrybucji sieci reklamowej Apple

Dla Twojej wygody zestaw SDK automatycznie rejestruje Twoją aplikację w Apple w celu przypisania jej do 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.

Rozpocznij rejestrowanie zdarzeń

Po skonfigurowaniu instancji FirebaseApp można 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ż. Należy wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać 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, aby wskazać, że użytkownik kliknął określony element w Twojej aplikacji:

Szybki

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

Cel C

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

Następne kroki