Google Analytics zbiera dane o użytkowaniu i zachowaniu Twojej aplikacji internetowej. SDK rejestruje dwa podstawowe typy informacji:
Zdarzenia : co dzieje się w Twojej aplikacji, na przykład działania użytkowników, zdarzenia systemowe lub błędy.
Właściwości użytkownika : atrybuty definiowane przez Ciebie w celu opisania segmentów Twojej bazy użytkowników, takie jak preferencje językowe 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 jeszcze tego nie zrobiłeś, dodaj Firebase do 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 procesu tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w > Ustawienia projektu, aby go włączyć.
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 Twojej 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 istniejącymi tagami gtag.js.
Sprawdź, czy obiekt konfiguracyjny Firebase w kodzie zawiera identyfikator
measurementId
. Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestrowaniu aplikacji internetowej i jest wymagany do korzystania z Analytics.Jeśli Twoja aplikacja korzysta z Hostingu Firebase i używa zarezerwowanych adresów URL dla pakietów SDK Firebase :
Firebase automatycznie obsługuje konfigurację aplikacji. Aby zakończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w ustawieniach projektu do tagu <body> aplikacji, jeśli jeszcze tego nie zrobiłeś.
Jeśli aplikacja nie korzysta zastrzeżone URL: Jeśli pracujesz z istniejącej aplikacji internetowej, zaktualizuj config obiekt Firebase w kodzie w celu zapewnienia
measurementId
pole jest obecny. Obiekt config 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" };
Zainicjuj Firebase Analytics:
Web v8
const analytics = firebase.analytics();
Web v9
import { getAnalytics } from "firebase/analytics"; const analytics = getAnalytics();
Użyj Firebase z istniejącymi tagami gtag.js.
Jeśli wcześniej w swojej aplikacji działał Google Analytics przy użyciu fragmentu kodu gtag.js , może ona wymagać dodatkowej konfiguracji, jeśli planujesz wykonać jedną z następujących czynności:
- Dodaj wywołania Google Analytics z Firebase do strony, ale planuj też nadal używać
gtag()
bezpośrednio na tej samej stronie. - Chcesz używać tego samego identyfikatora pomiaru między bezpośrednimi połączeniami
gtag()
i danymi Google Analytics wysyłanymi do Firebase.
Aby upewnić się, że Twoje wydarzenia są dostępne dla wszystkich usług Firebase, wykonaj następujące dodatkowe czynności konfiguracyjne:
Usuń
[?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID)
URL. Twój fragment kodu gtag powinien być podobny do<script async src="https://www.googletagmanager.com/gtag/js"></script>
Usuń wiersz
gtag('config', ' GA_MEASUREMENT_ID ');
gdzieGA_MEASUREMENT_ID
jest taki sam jakmeasurementId
we fragmencie kodu konfiguracji Firebase. Jeśli masz na stronie inne identyfikatory dla innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.Upewnij się, że wywołujesz
firebase.analytics()
przed wysłaniem jakichkolwiek zdarzeń za pomocągtag()
.
W przeciwnym razie zdarzenia wysłane do tego identyfikatora za pomocą 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 za pomocą „firebase.analytics ()” można rozpocząć rejestrowanie zdarzeń za pomocą metody „logEvent ()” .
Pewne zdarzenia są zalecane dla wszystkich aplikacji ; inne są zalecane dla określonych typów działalności lub branż. Powinieneś wysyłać sugerowane zdarzenia wraz z przypisanymi im parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać z przyszłych funkcji i integracji, gdy 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 v8
firebase.analytics().logEvent('notification_received');
Web v9
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Następne kroki
- Użyj DebugView, aby zweryfikować swoje zdarzenia.
- Przeglądaj swoje dane w konsoli Firebase .
- Zapoznaj się z przewodnikami po wydarzeniach i właściwościach użytkowników.
- Dowiedz się, jak wyeksportować dane do BigQuery.