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 Twojej 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 służące do opisywania segmentów Twoich użytkowników, np. ich ustawień języka lub położenia geograficznego.
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 masz jeszcze Firebase w projekcie JavaScript, dodaj Firebase do projektu JavaScript 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, w którym nie włączono funkcji Google Analytics, przejdź do karty Integracje
, 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 do aplikacji pakietu SDK Analytics
W zależności od tego, jak hostowana jest aplikacja internetowa, konfiguracja może zostać potraktowana automatycznie lub może być konieczne zaktualizowanie obiektu konfiguracji Firebase. Jeśli Twoja aplikacja internetowa korzysta już z Google Analytics, konieczne może być wykonanie dodatkowych czynności konfiguracyjnych opisanych w artykule Korzystanie z Firebase z dotychczasowym tagowaniem za pomocą gtag.js.
Sprawdź, czy obiekt konfiguracji Firebase w kodzie zawiera
measurementId
. Ten identyfikator jest tworzony automatycznie, gdy włączysz Analytics w projekcie Firebase i zarejestrujesz aplikację internetową. Jest on wymagany do korzystania z funkcji Analytics.Jeśli Twoja aplikacja korzysta z Firebase Hosting iz zarezerwowanych adresów URL dla pakietów SDK Firebase:
Firebase automatycznie skonfiguruje Twoją aplikację. Aby dokończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w ustawieniach projektu do tagu <body> w aplikacji.
Jeśli Twoja aplikacja nie używa zarezerwowanych adresów URL: jeśli pracujesz z dotychczasową aplikacją internetową, zaktualizuj obiekt konfiguracji Firebase w kodze, aby mieć pewność, że pole
measurementId
jest obecne. Obiekt ConfigMap powinien wyglądać podobnie do tego:// 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 zrobiono, zainstaluj pakiet SDK Firebase JS i zainicjuj Firebase.
Dodaj pakiet SDK JS Analytics i inicjuj 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 za pomocą gtag.js
Jeśli w swojej aplikacji masz uruchomiony Google Analytics za pomocą fragmentu kodu gtag.js, aplikacja może wymagać dodatkowej konfiguracji, jeśli chcesz wykonać jedną z tych czynności:
- Dodaj do strony wywołania Google Analytics z Firebase, ale nadal używaj wywołań
gtag()
bezpośrednio na tej samej stronie. - Chcesz używać tego samego identyfikatora pomiaru w przypadku bezpośrednich wywołań
gtag()
i danych Google Analytics wysyłanych do Firebase.
Aby mieć pewność, że zdarzenia są dostępne do użycia przez wszystkie usługi Firebase, wykonaj te dodatkowe czynności konfiguracyjne:
- Usuń wiersz
gtag('config', 'GA_MEASUREMENT_ID');
, gdzieGA_MEASUREMENT_ID
tomeasurementId
Twojej aplikacji internetowej Firebase. Jeśli na stronie masz inne identyfikatory dla innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji. - Przed wysłaniem zdarzeń za pomocą funkcji
gtag()
wywołaj funkcjęfirebase.analytics()
.
W przeciwnym razie zdarzenia wysyłane do tego identyfikatora 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 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. W tej sekcji pokazano rejestrowanie zdefiniowanego wstępnie zdarzenia. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w sekcji Zdarzenia z dziennika.
Ten przykład pokazuje, jak zarejestrować 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 konsoli Firebase.
- Zapoznaj się z przewodnikami dotyczącymi zdarzeń i właściwości użytkowników.
- Dowiedz się, jak eksportować dane do BigQuery.