Ta strona została przetłumaczona przez Cloud Translation API.

Zacznij korzystać z Google Analytics

Z tego krótkiego wprowadzenia dowiesz się, jak dodać Google Analytics do swojej aplikacji i rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane dotyczące użytkowania i zachowania Twojej aplikacji. 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, które definiujesz, aby opisać segmenty 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 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, w którym nie włączono 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 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 wykonanie dodatkowej konfiguracji opisanej w artykule Używanie Firebase z istniejącym tagowaniem gtag.js .

Sprawdź, czy obiekt konfiguracyjny Firebase w kodzie zawiera measurementId . Ten identyfikator jest tworzony automatycznie, gdy włączysz Analytics w projekcie Firebase i zarejestrujesz aplikację internetową, i jest wymagany do korzystania z Analytics.
Uwaga: w przypadku aplikacji korzystających z pakietu Firebase JavaScript SDK w wersji 7.20.0 i nowszych Firebase dynamicznie pobiera identyfikator measurementId , gdy aplikacja inicjuje Analytics. Posiadanie tego identyfikatora w obiekcie konfiguracyjnym jest opcjonalne, ale służy jako rozwiązanie awaryjne w rzadkim przypadku niepowodzenia dynamicznego pobierania.
- Jeśli Twoja aplikacja korzysta z Hostingu Firebase i używa zarezerwowanych adresów URL dla pakietów SDK Firebase :
  Firebase automatycznie zajmie się konfigurowaniem Twojej aplikacji. Aby ukoń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 używa zarezerwowanych adresów URL : jeśli pracujesz z istniejącą aplikacją internetową , zaktualizuj obiekt konfiguracji Firebase w swoim kodzie, aby upewnić się, że pole measurementId jest obecne. Obiekt konfiguracyjny 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"
};
```
Zainstaluj pakiet Firebase JS SDK i zainicjuj Firebase , jeśli jeszcze tego nie zrobiłeś.
Dodaj pakiet Analytics JS SDK i zainicjuj Analytics:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
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 był uruchomiony Google Analytics z fragmentem kodu gtag.js , 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 też dalsze korzystanie z gtag() bezpośrednio na tej samej stronie.
Chcesz używać tego samego identyfikatora pomiaru między bezpośrednimi gtag() i 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 następujące dodatkowe czynności konfiguracyjne:

Usuń wiersz gtag('config', ' GA_MEASUREMENT_ID '); gdzie GA_MEASUREMENT_ID to identyfikator measurementId Twojej aplikacji internetowej Firebase. Jeśli masz na stronie inne identyfikatory innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.
Pamiętaj, aby wywołać 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 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ż. Należy wysyłać sugerowane zdarzenia wraz z ich określonymi parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać 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, aby wskazać, że użytkownik otrzymał powiadomienie w Twojej aplikacji:

Web version 9

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

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

Web version 8

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

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ć swoje dane do BigQuery.