Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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:

  • 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ę konfigurowaniem 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