Z tego krótkiego przewodnika dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.
Google Analytics zbiera dane o używaniu aplikacji i zachowaniach użytkowników. 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
Jeśli nie korzystasz jeszcze z tej usługi, dodaj Firebase do projektu JavaScript i upewnij się, że w projekcie Firebase włączona jest usługa 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 usługi Google Analytics, otwórz kartę Integracje w sekcji
, aby ją włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w projekcie, Twoje aplikacje internetowe Firebase zostaną połączone ze strumieniami danych Google Analytics powiązanymi z usługą Aplikacje + internet.
Dodawanie pakietu SDK Analytics do aplikacji
W zależności od sposobu hostowania aplikacji internetowej konfiguracja może być obsługiwana automatycznie lub może być konieczne zaktualizowanie obiektu konfiguracji Firebase. Jeśli Twoja aplikacja internetowa korzysta już z Google Analytics, może być konieczne przeprowadzenie dodatkowej konfiguracji opisanej w artykule Korzystanie z Firebase z dotychczasowym tagowaniem za pomocą gtag.js.
Sprawdź, czy obiekt konfigurujący Firebase w kodzie zawiera
measurementId
. Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestrowaniu aplikacji internetowej. Jest on wymagany do korzystania z Analytics.Jeśli Twoja aplikacja korzysta z Firebase Hosting i używa zarezerwowanych adresów URL dla pakietów SDK Firebase:
Firebase automatycznie konfiguruje aplikację. Aby dokończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w ustawieniach projektu do tagu <body> aplikacji, jeśli jeszcze tego nie zrobiono.
Jeśli Twoja aplikacja nie używa zarezerwowanych adresów URL: Jeśli pracujesz nad istniejącą aplikacją internetową, zaktualizuj obiekt konfiguracji Firebase w kodzie, aby upewnić się, że zawiera pole
measurementId
. Obiekt konfiguracji powinien wyglądać podobnie do tego przykładu:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "API_KEY", authDomain: "PROJECT_ID.firebaseapp.com", databaseURL: "https://PROJECT_ID.firebaseio.com", projectId: "PROJECT_ID", storageBucket: "
", messagingSenderId: "SENDER_ID", appId: "APP_ID", measurementId: "G-GA_MEASUREMENT_ID" };PROJECT_ID.firebasestorage.app
Jeśli nie masz jeszcze zainstalowanego pakietu Firebase JS SDK i zainicjowanego Firebase, zrób to.
Dodaj Analytics pakiet SDK w JavaScript i zainicjuj Analytics:
Web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Korzystanie z Firebase z dotychczasowym tagowaniem gtag.js
Jeśli wcześniej w aplikacji działała usługa Google Analytics z użyciem fragmentu kodu gtag.js, może być konieczne dodatkowe skonfigurowanie aplikacji, jeśli planujesz wykonać jedną z tych czynności:
- Dodaj na stronie wywołania Google Analytics z Firebase, ale planuj też dalsze używanie wywołań
gtag()
bezpośrednio na tej samej stronie. - Chcesz używać tego samego identyfikatora pomiaru zarówno w przypadku bezpośrednich wywołań
gtag()
, jak i danych Google Analytics wysyłanych do Firebase.
Aby mieć pewność, że zdarzenia są dostępne dla wszystkich usług Firebase, wykonaj te dodatkowe czynności konfiguracyjne:
- Usuń wiersz
gtag('config', 'GA_MEASUREMENT_ID');
, w którymGA_MEASUREMENT_ID
tomeasurementId
Twojej aplikacji internetowej Firebase. Jeśli na stronie masz inne identyfikatory innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji. - Zanim wyślesz jakiekolwiek zdarzenia z
gtag()
, wywołaj funkcjęfirebase.analytics()
.
W przeciwnym razie zdarzenia wysyłane na ten identyfikator za pomocą wywołań gtag()
nie będą powiązane z Firebase i nie będzie można ich używać do kierowania w innych usługach Firebase.
Rozpoczęcie rejestrowania zdarzeń
Po zainicjowaniu usługi Analytics możesz zacząć rejestrować zdarzenia za pomocą metody logEvent()
.
Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji, 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, 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 rejestrować zalecane zdarzenie, aby wskazać, że użytkownik otrzymał powiadomienie w aplikacji:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Dalsze kroki
- Poznaj każdy raport Analytics.
- Aby sprawdzić zdarzenia, użyj raportu DebugView.
- Poznaj swoje dane w Firebasekonsoli.
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkownika.
- Dowiedz się, jak eksportować dane do BigQuery.