Z tego przewodnika Szybki start 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 internetowej. Zestaw SDK rejestruje dwa podstawowe typy informacji:
Zdarzenia : co dzieje się w Twojej aplikacji, np. działania użytkownika, zdarzenia systemowe lub błędy.
Właściwości użytkownika : atrybuty, które definiujesz w celu opisania segmentów bazy użytkowników, takich jak preferencje językowe lub lokalizacja geograficzna.
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 jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu JavaScript i upewnij się, że Google Analytics jest włączone w Twoim projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas tworzenia projektu.
Jeśli korzystasz z istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w swoim
Gdy włączysz Google Analytics w swoim projekcie, Twoje aplikacje internetowe Firebase zostaną połączone ze strumieniami danych Google Analytics powiązanymi z usługą Aplikacje + Internet .
Dodaj pakiet SDK Analytics do swojej aplikacji
W zależności od sposobu hostowania aplikacji internetowej konfiguracja może być obsługiwana automatycznie lub może być konieczna aktualizacja obiektu konfiguracyjnego Firebase . Jeśli Twoja aplikacja internetowa korzysta już z Google Analytics, może być konieczne wykonanie dodatkowej konfiguracji opisanej w artykule Używanie Firebase z istniejącym tagowaniem gtag.js .
Sprawdź, czy obiekt konfiguracyjny Firebase w kodzie zawiera
measurementId
. Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestrowaniu aplikacji internetowej. Jest wymagany do korzystania z Analytics.Jeśli Twoja aplikacja korzysta z Hostingu Firebase i używa zarezerwowanych adresów URL dla zestawów SDK Firebase :
Firebase automatycznie obsługuje konfigurację Twojej aplikacji. Aby dokończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w ustawieniach projektu do tagu <body> swojej aplikacji, jeśli jeszcze tego nie zrobiłeś.
Jeśli Twoja aplikacja nie korzysta z zastrzeżonych adresów URL : jeśli pracujesz z istniejącą aplikacją internetową , zaktualizuj obiekt konfiguracyjny Firebase w swoim kodzie, aby upewnić się, że pole
measurementId
jest obecne. Obiekt konfiguracyjny powinien wyglądać podobnie do poniższego przykładu:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Jeśli jeszcze tego nie zrobiłeś, zainstaluj pakiet SDK Firebase JS i zainicjuj Firebase .
Dodaj pakiet SDK Analytics JS i zainicjuj Analytics:
Modułowe API sieciowe
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);
Internetowy interfejs API z przestrzenią nazw
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();
Użyj Firebase z istniejącym tagowaniem gtag.js
Jeśli wcześniej w Twojej aplikacji działała usługa Google Analytics przy użyciu fragmentu kodu gtag.js , Twoja aplikacja może wymagać dodatkowej konfiguracji, jeśli planujesz wykonać jedną z poniższych czynności:
- Dodaj wywołania Google Analytics z Firebase do strony, ale planuj także dalsze korzystanie z wywołań
gtag()
bezpośrednio na tej samej stronie. - Chcesz używać tego samego identyfikatora pomiaru między bezpośrednimi wywołaniami
gtag()
i danymi Google Analytics wysyłanymi do Firebase.
Aby mieć pewność, że Twoje wydarzenia będą dostępne do użytku we wszystkich usługach Firebase, wykonaj następujące dodatkowe kroki konfiguracyjne:
- Usuń linię
gtag('config', ' GA_MEASUREMENT_ID ');
gdzieGA_MEASUREMENT_ID
tomeasurementId
Twojej aplikacji internetowej Firebase. Jeśli na stronie masz inne identyfikatory innych usług Analytics, nie musisz usuwać ich linii konfiguracyjnej. - Pamiętaj, aby wywołać
firebase.analytics()
przed wysłaniem jakichkolwiek zdarzeń za pomocągtag()
.
W przeciwnym razie zdarzenia wysyłane na ten identyfikator za pomocą wywołań gtag()
nie będą powiązane z Firebase i nie będą dostępne do kierowania w innych usługach Firebase.
Rozpocznij rejestrowanie zdarzeń
Po zainicjowaniu usługi Analytics możesz 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ż. Powinieneś wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i móc korzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanych zdarzeń. 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 otrzymał powiadomienie w Twojej aplikacji:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
Następne kroki
- Zrozumienie każdego raportu Analytics .
- Użyj DebugView , aby zweryfikować swoje zdarzenia.
- Eksploruj swoje dane w konsoli Firebase .
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.