Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.
Google Analytics zbiera dane o korzystaniu i zachowaniu Twojej aplikacji. 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 niektóre zdarzenia oraz 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 upewnij się, że usługa Google Analytics jest włączona w projekcie Firebase:
Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas tworzenia projektu.
Jeśli używasz istniejącego projektu Firebase, który nie zawiera włączona jest usługa Google Analytics, przejdź do Integracje karta na Twoim urządzeniu
. > Aby ją włączyć, Ustawienia projektu
Po włączeniu Google Analytics w projekcie Twoje aplikacje internetowe Firebase są połączone ze strumieniami danych Google Analytics powiązanymi z kontem Usługa Aplikacje + internet.
Dodawanie pakietu SDK Analytics do aplikacji
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 korzysta z Hostingu Firebase i korzysta z 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 połączenia Google Analytics z Firebase, ale także zaplanuj takie działania
nadal korzystaj z wywołań typu
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 wysył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.
- Przeglądaj dane w konsoli Firebase.
- Przejrzyj przewodniki po wydarzeniach i właściwości użytkownika.
- Dowiedz się, jak wyeksportować dane do BigQuery.