Z tego krótkiego wprowadzenia dowiesz się, jak dodać usługę Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o korzystaniu z aplikacji i jej działaniu. Pakiet SDK rejestruje dwa główne typy informacji:
- Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeń lub błędów.
- Właściwości użytkownika: atrybuty, które określasz, by opisać segmenty swojej witryny bazy użytkowników, np. ich ustawień języka lub położenia geograficznego.
Analytics automatycznie rejestruje część wydarzeń i właściwości użytkownika, nie musisz dodawać żadnego kodu, aby je włączyć.
Zanim zaczniesz
Dodaj Firebase do swojego kodu JavaScriptu, chyba że masz to już za sobą projektu i sprawdź, czy usługa Google Analytics jest włączona w projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz funkcję Google Analytics podczas tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie zawiera Włączono Google Analytics, otwórz Integracje na karcie
, aby je włączyć. > Ustawienia projektu
Gdy włączysz Google Analytics w swoim projekcie, aplikacje internetowe Firebase są połączone z Google Analytics strumieniami danych powiązanymi z kontem Usługa Aplikacje + internet.
Dodaj do aplikacji pakiet SDK Analytics
W zależności od sposobu hostowania aplikacji internetowej konfiguracja może być obsługiwane automatycznie. Może też zaistnieć konieczność zaktualizowania Obiekt konfiguracji Firebase. Jeśli Twoja aplikacja internetowa korzysta już z Google Analytics, może być konieczne wykonanie dodatkowych konfigurację opisaną w artykule Używanie Firebase z tagami gtag.js.
Sprawdź, czy obiekt konfiguracyjny Firebase w kodzie zawiera
measurementId
Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestruj aplikację internetową. wymagane do korzystania z Analytics.Jeśli Twoja aplikacja używa Firebase Hosting oraz takich jak zarezerwowanych adresy URL dla pakietów SDK Firebase:
Firebase automatycznie konfiguruje Twoją aplikację. Aby zakończyć konfiguracji, dodaj skrypty z karty Twoje aplikacje w sekcji Ustawienia projektu w sekcji <body> tagu Twojej aplikacji, jeśli jeszcze nie zostało to zrobione.
Jeśli aplikacja nie używa zarezerwowanych adresów URL: Jeśli korzystasz z już istniejącej aplikacji internetowej, zaktualizuj konfigurację Firebase. w kodzie, aby zapewnić obecność pola
measurementId
. config 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: "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" };
Dodaj pakiet JS SDK Analytics 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();
Używanie Firebase z dotychczasowym tagowaniem gtag.js
Jeśli w Twojej aplikacji była już używana usługa Google Analytics za pomocą fragment kodu gtag.js, aplikacja może wymagać dodatkowej konfiguracji, jeśli planujesz:
- Dodaj do strony Google Analytics połączeń z Firebase, ale także zaplanuj te działania
nadal korzystaj z wywołań
gtag()
bezpośrednio na tej samej stronie. - Chcesz używać tego samego identyfikatora pomiaru zarówno w bezpośrednich wywołaniach
gtag()
, jak Dane (Google Analytics) zostały wysłane do Firebase.
Aby wszystkie usługi Firebase mogły korzystać ze zdarzeń, wykonaj wykonaj te dodatkowe kroki konfiguracji:
- Usuń linię
gtag('config', 'GA_MEASUREMENT_ID');
gdzieGA_MEASUREMENT_ID
tomeasurementId
aplikacji internetowej Firebase. Jeśli masz inne identyfikatory na potrzeby innych usług w Analytics na stronie, nie musisz usuwać wiersza config. - Przed wysłaniem jakichkolwiek zdarzeń skontaktuj się z firmą
firebase.analytics()
dziękigtag()
.
W przeciwnym razie zdarzenia wysłane na ten identyfikator z gtag()
wywołaniami nie będą powiązane
z Firebase i nie będą dostępne do kierowania w innych
Usługi Firebase.
Zacznij rejestrować zdarzenia
Po zainicjowaniu
Analytics, możesz
zaczynają rejestrować zdarzenia za pomocą
logEvent()
.
Niektóre wydarzenia zalecana w przypadku wszystkich aplikacji; inne są zalecane w przypadku określonych typów działalności lub branż. Należy wysłać zdarzeń z zalecanymi parametrami, aby zapewnić maksymalną dostępne szczegóły w raportach oraz możliwość korzystania z przyszłych funkcji i integracje, gdy tylko będą dostępne. W tej sekcji omawiamy logowanie wstępnie zdefiniowanego zdarzenia. Więcej informacji o logowaniu zdarzeń znajdziesz w materiałach na temat Rejestruj zdarzenia.
Poniższy przykład pokazuje, jak rejestrować zalecane zdarzenie, aby wskazać, użytkownik otrzymał powiadomienie w Twojej aplikacji:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Dalsze kroki
- Zapoznaj się z każdym raportem Analytics.
- Do weryfikowania zdarzeń służy DebugView.
- Przejrzyj swoje dane w konsoli Firebase.
- Przejrzyj przewodniki po wydarzeniach i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.