Rozpoczęcie korzystania z Google Analytics

iOS+ Android Sieć Flutter

Z tego samouczka dowiesz się, jak dodać do aplikacji Google Analytics i rozpocząć rejestrowanie zdarzeń.

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ć.

Zanim zaczniesz

1. Jeśli nie masz jeszcze dodanego Firebase do projektu Apple, zrób to i upewnij się, że w projekcie Firebase włączona jest opcja Google Analytics:

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

   • Jeśli używasz dotychczasowego projektu Firebase bez włączonej funkcji Google Analytics, otwórz kartę Integracje > Ustawienia projektu, aby ją włączyć.

   Ostrzeżenie: jeśli nie zrobiono tego wcześniej, każdy projekt Firebase utworzony przed 31 lipca 2019 r. musi zostać przekształcony w pełną wersję Google Analytics 4. (w razie konieczności uaktualnienia banery będą się wyświetlać w panelu Analytics). Powiązane Warunki korzystania z usługi muszą zostać zaakceptowane do 15 lutego 2022 r., aby zapewnić ciągłość gromadzenia danych. Aby dowiedzieć się, jak znaleźć właścicieli projektów, zapoznaj się z odpowiedziami na najczęstsze pytania dotyczące przekształcania kampanii.

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

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

Dodawanie do aplikacji pakietu SDK Analytics

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

Odwiedź nasz przewodnik instalatora, aby dowiedzieć się, jak dodać pakiety SDK Firebase do projektu Apple, m.in. za pomocą bezpośredniego importowania frameworków i CocoaPods.

1. Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.
2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:

  https://github.com/firebase/firebase-ios-sdk.git

Uwaga: nowe projekty powinny używać domyślnej (najnowszej) wersji pakietu SDK, ale w razie potrzeby możesz wybrać starszą wersję. Najnowsza wersja oferuje nowe funkcje i ulepszone struktury pakietu SDK, np. aktualizacje pomiaru konwersji na urządzeniu na iOS.
3. Wybierz bibliotekę Analytics.
4. Dodaj flagę -ObjC do sekcji Inne flagi linkera w ustawieniach kompilacji docelowej.
5. Aby uzyskać optymalne wyniki w przypadku Analytics, zalecamy włączenie Google Analytics w projekcie Firebase i dodanie do aplikacji pakietu SDK Firebase dla Google Analytics. Możesz wybrać bibliotekę z zbieraniem identyfikatorów IDFA lub bez niego. Zapoznaj się z odpowiedziami na najczęstsze pytania dotyczące najnowszej organizacji modułów w Google Analytics pakietu SDK Firebase.
6. Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.

Więcej informacji o identyfikatorze IDFA, czyli identyfikatorze reklam na poziomie urządzenia, znajdziesz w dokumentacji Apple dotyczącej prywatności użytkowników i użytkowania danych oraz przezroczystości w zakresie śledzenia aplikacji.

Następnie wykonaj czynności konfiguracyjne:

1. Zaimportuj moduł FirebaseCore w pliku UIApplicationDelegate, a także wszystkie inne moduły Firebase, których używa delegowany obiekt 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 współdzieloną instancję FirebaseApp w metodzie application(_:didFinishLaunchingWithOptions:) w delegacie 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 delegujący aplikacji i dołączyć go do struktury App za pomocą funkcji UIApplicationDelegateAdaptor lub NSApplicationDelegateAdaptor. Musisz też wyłączyć swizlowanie zastępników aplikacji. 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()
         }
       }
     }
   }
         

Jeśli śledzisz zakupy w aplikacji, przed zainicjowaniem Firebase musisz zainicjować obserwatora transakcji w application:didFinishLaunchingWithOptions:, ponieważ w przeciwnym razie obserwator może nie otrzymywać wszystkich powiadomień o zakupach. Więcej informacji znajdziesz w artykule Sprawdzone metody dotyczące zakupów w aplikacji firmy Apple.

(Opcjonalnie) Wyłącz rejestrowanie atrybucji sieci reklamowej Apple

Aby ułatwić Ci pracę, pakiet SDK automatycznie rejestruje Twoją aplikację w Apple na potrzeby atrybucji sieci reklamowej za pomocą SKAdNetwork. Jeśli chcesz wyłączyć tę funkcję, w pliku info.plist aplikacji ustaw wartość GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED na NO (wartość logiczna).

Rozpoczęcie rejestrowania zdarzeń

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

Niektóre zdarzenia są zalecane we wszystkich aplikacjach, a inne w przypadku określonych 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, sugerowane zdarzenia należy wysyłać z określonymi parametrami. Ta sekcja pokazuje rejestrowanie zdefiniowanego wstępnie zdarzenia. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w artykule Zdarzenia z dziennika.

Ten przykład pokazuje, jak rejestrować zdarzenie zalecane, aby wskazać, że użytkownik kliknął określony element w aplikacji:

Swift

Uwaga: ta usługa Firebase nie jest dostępna na platformie docelowej macOS.

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

Objective-C

Uwaga: ta usługa Firebase nie jest dostępna na platformie docelowej 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 kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat)….
2. W menu po lewej stronie kliknij Uruchom.
3. Kliknij kartę Argumenty.
4. W sekcji Argumenty przekazywane przy uruchamianiu dodaj -FIRAnalyticsDebugEnabled.

Dalsze kroki

• Poznaj każdy raport Analytics.
• Aby sprawdzić zdarzenia, użyj raportu DebugView.
• Poznaj swoje dane w konsoli Firebase.
• Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkowników.
• Dowiedz się, jak eksportować dane do BigQuery.