Catch up on everthing we announced at this year's Firebase Summit. Learn more

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 internetowej. SDK rejestruje dwa podstawowe typy informacji:

  • Wydarzenia: co dzieje się w Twojej aplikacji, takich jak działania użytkowników, zdarzeń systemowych, lub błędów.

  • Właściwości użytkowników: atrybuty, które określają w celu opisania segmentów bazy użytkowników, takie jak preferowany język czy położenia geograficznego.

Analytics automatycznie rejestruje pewne zdarzenia i właściwości użytkownika ; nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Jeśli jeszcze nie masz, dodać Firebase do projektu JavaScript i upewnić się, że Google Analytics jest włączona w twojej Firebase projektu:

  • Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas procesu tworzenia projektu.

  • Jeśli używasz istniejącego projektu Firebase że nie ma włączonego Google Analytics, przejdź do Integrations karcie swoimi > Ustawienia projektu, aby ją włączyć.

Po włączeniu Google Analytics w projekcie, swoje internetowe aplikacje Firebase są powiązane z danymi Google Analytics strumienie skojarzone z własności App + Web .

Dodaj pakiet Analytics SDK do swojej aplikacji

W zależności od sposobu aplikacji internetowych jest gospodarzem, konfiguracja może być obsługiwane automatycznie lub być może trzeba zaktualizować Firebase obiektu konfiguracji . Jeśli Twoja aplikacja internetowa już korzysta z Google Analytics, może trzeba zrobić dodatkowej konfiguracji opisanej w Korzystanie Firebase z istniejących gtag.js tagging .

  1. Sprawdź, czy Firebase obiekt config 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.

    • Jeśli aplikacja używa Firebase Hosting i zastosowania zastrzeżone URL dla Firebase SDK:

      Firebase automatycznie zajmie się konfiguracją Twojej aplikacji. Aby zakończyć konfigurację, dodać skrypty z karty swoich aplikacji w swoich ustawieniach projektu do tagu <body> swojej aplikacji, jeśli nie masz.

    • 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 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"
      };
      
  2. Zainicjuj Firebase Analytics:

Wersja internetowa 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Wersja internetowa 8

const analytics = firebase.analytics();

Użyj Firebase z istniejącym tagowaniem gtag.js

Jeśli wcześniej systemem Google Analytics w swojej aplikacji za pomocą gtag.js snippet , aplikacja może wymagać dodatkowej konfiguracji, jeśli planujesz wykonać jedną z następujących czynności:

  • Dodaj połączeń Google Analytics Firebase do strony, ale również planujemy kontynuować korzystanie gtag() zwraca się bezpośrednio na tej samej stronie.
  • Chcesz używać tego samego identyfikatora pomiaru pomiędzy zarówno bezpośredniego gtag() połączeń i danych Google Analytics przesłanym 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ń korekty gtag('config', ' GA_MEASUREMENT_ID '); gdzie GA_MEASUREMENT_ID jest measurementId Twojego Firebase aplikacji internetowej. Jeśli masz na stronie inne identyfikatory innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.
  • Upewnij się, że nazywają firebase.analytics() Przed wysłaniem jakichkolwiek zdarzeń z gtag() .

W przeciwnym razie zdarzenia wysyłane do tego ID z gtag() połączenia nie będzie związany z Firebase i nie będą dostępne do kierowania innymi usługami Firebase.

Rozpocznij rejestrowanie zdarzeń

Po zainicjowaniu usługę Analytics , można przystąpić do rejestrowania zdarzeń z logEvent() metody.

Niektóre wydarzenia 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 zalogowaniu predefiniowanego zdarzenia, aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz dziennik zdarzeń .

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

Wersja internetowa 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Wersja internetowa 8

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

Następne kroki