Catch up on highlights from Firebase at Google I/O 2023. Learn more

Rozpoczęcie korzystania z Google Analytics

W tym przewodniku Szybki Start dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o użytkowaniu i zachowaniu Twojej aplikacji internetowej. SDK rejestruje dwa podstawowe typy informacji:

  • Zdarzenia : to, co dzieje się w Twojej aplikacji, takie jak działania użytkowników, zdarzenia systemowe lub błędy.

  • Właściwości użytkownika : definiowane przez Ciebie atrybuty opisujące segmenty Twojej bazy użytkowników, takie 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 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 ją 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 Analytics SDK do swojej aplikacji

W zależności od tego, jak hostowana jest Twoja aplikacja internetowa, 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 .

  1. Sprawdź, czy Twój obiekt konfiguracyjny Firebase w kodzie zawiera measurementId . Ten identyfikator jest tworzony automatycznie, gdy włączysz Analytics w swoim projekcie Firebase i zarejestrujesz aplikację internetową, 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ę Twojej aplikacji. Aby zakoń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 zarezerwowanych 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 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"
};

  2. Jeśli jeszcze tego nie zrobiłeś, zainstaluj Firebase JS SDK i zainicjuj Firebase .

  3. Dodaj Analytics JS SDK i zainicjuj Analytics:

Modułowy interfejs API sieci 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);

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ł Google Analytics przy użyciu fragmentu kodu gtag.js , Twoja aplikacja może wymagać dodatkowej konfiguracji, jeśli planujesz wykonać jedną z następujących czynności:

  • Dodaj wywołania Google Analytics z Firebase do strony, ale zaplanuj dalsze używanie wywołań gtag() bezpośrednio na tej samej stronie.
  • Chcesz używać tego samego identyfikatora pomiaru między bezpośrednimi wywołaniami gtag() a danymi Google Analytics wysyłanymi do Firebase.

Aby upewnić się, że Twoje wydarzenia są dostępne do użytku przez wszystkie usługi Firebase, wykonaj te dodatkowe czynności konfiguracyjne:

  • Usuń linię gtag('config', ' GA_MEASUREMENT_ID '); gdzie GA_MEASUREMENT_ID to measurementId Twojej aplikacji internetowej Firebase. Jeśli masz inne identyfikatory dla innych usług Analytics na stronie, nie musisz usuwać ich wiersza konfiguracji.
  • Upewnij się, że wywołałeś firebase.analytics() przed wysłaniem jakichkolwiek zdarzeń za pomocą gtag() .

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 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 zalecanymi parametrami, aby zapewnić maksymalną dostępność szczegółów w raportach i skorzystać z przyszłych funkcji i integracji, gdy tylko staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanego zdarzenia. Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Rejestrowanie zdarzeń .

Poniższy przykład pokazuje, jak zarejestrować zalecane zdarzenie wskazujące, że użytkownik otrzymał powiadomienie w Twojej aplikacji:

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web namespaced API

firebase.analytics().logEvent('notification_received');
index.js

Następne kroki