Rozpoczęcie korzystania z Google Analytics


Z tego krótkiego przewodnika dowiesz się, jak dodać Google Analytics do aplikacji i zacząć rejestrować zdarzenia.

Google Analytics zbiera dane o użytkowaniu i zachowaniu w Twojej aplikacji internetowej. Pakiet SDK rejestruje 2 główne typy informacji:

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

  • Właściwości użytkownika: atrybuty, które definiujesz, aby opisywać segmenty użytkowników, np. ustawienia języka lub położenie geograficzne.

Analytics automatycznie rejestruje niektóre zdarzeniawłaściwości użytkownika. Nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Jeśli nie korzystasz jeszcze z tej usługi, dodaj Firebase do projektu JavaScript i upewnij się, że w projekcie Firebase włączona jest usługa Google Analytics:

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

  • Jeśli używasz dotychczasowego projektu Firebase bez włączonej usługi Google Analytics, otwórz kartę Integracje w sekcji > Ustawienia projektu, aby ją włączyć.

Gdy włączysz Google Analytics w projekcie, Twoje aplikacje internetowe Firebase zostaną połączone ze strumieniami danych Google Analytics powiązanymi z usługą Aplikacje + internet.

Dodawanie pakietu SDK Analytics do aplikacji

W zależności od sposobu hostowania 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 przeprowadzenie dodatkowej konfiguracji opisanej w artykule Korzystanie z Firebase z dotychczasowym tagowaniem za pomocą gtag.js.

  1. Sprawdź, czy obiekt konfigurujący Firebase w kodzie zawiera measurementId. Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestrowaniu aplikacji internetowej. Jest on wymagany do korzystania z Analytics.

    • Jeśli Twoja aplikacja korzysta z Firebase Hosting i używa zarezerwowanych adresów URL dla pakietów SDK Firebase:

      Firebase automatycznie konfiguruje aplikację. Aby dokończyć konfigurację, dodaj skrypty z karty Twoje aplikacjeustawieniach projektu do tagu <body> aplikacji, jeśli jeszcze tego nie zrobiono.

    • Jeśli Twoja aplikacja nie używa zarezerwowanych adresów URL: Jeśli pracujesz nad istniejącą aplikacją internetową, zaktualizuj obiekt konfiguracji Firebase w kodzie, aby upewnić się, że zawiera pole measurementId. Obiekt konfiguracji 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: "API_KEY",
        authDomain: "PROJECT_ID.firebaseapp.com",
        databaseURL: "https://PROJECT_ID.firebaseio.com",
        projectId: "PROJECT_ID",
        storageBucket: "PROJECT_ID.firebasestorage.app",
        messagingSenderId: "SENDER_ID",
        appId: "APP_ID",
        measurementId: "G-GA_MEASUREMENT_ID"
      };
      
  2. Jeśli nie masz jeszcze zainstalowanego pakietu Firebase JS SDK i zainicjowanego Firebase, zrób to.

  3. Dodaj Analytics pakiet SDK w JavaScript 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();

Korzystanie z Firebase z dotychczasowym tagowaniem gtag.js

Jeśli wcześniej w aplikacji działała usługa Google Analytics z użyciem fragmentu kodu gtag.js, może być konieczne dodatkowe skonfigurowanie aplikacji, jeśli planujesz wykonać jedną z tych czynności:

  • Dodaj na stronie wywołania Google Analytics z Firebase, ale planuj też dalsze używanie wywołań gtag() bezpośrednio na tej samej stronie.
  • Chcesz używać tego samego identyfikatora pomiaru zarówno w przypadku bezpośrednich wywołań gtag(), jak i danych Google Analytics wysyłanych do Firebase.

Aby mieć pewność, że zdarzenia są dostępne dla wszystkich usług Firebase, wykonaj te dodatkowe czynności konfiguracyjne:

  • Usuń wiersz gtag('config', 'GA_MEASUREMENT_ID');, w którym GA_MEASUREMENT_ID to measurementId Twojej aplikacji internetowej Firebase. Jeśli na stronie masz inne identyfikatory innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.
  • Zanim wyślesz jakiekolwiek zdarzenia z gtag(), wywołaj funkcję firebase.analytics().

W przeciwnym razie zdarzenia wysyłane na ten identyfikator za pomocą wywołań gtag() nie będą powiązane z Firebase i nie będzie można ich używać do kierowania w innych usługach Firebase.

Rozpoczęcie rejestrowania zdarzeń

Po zainicjowaniu usługi Analytics możesz zacząć rejestrować zdarzenia za pomocą metody logEvent().

Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji, a inne – w przypadku określonych rodzajów działalności lub branż. Aby w raportach pojawiały się jak najbardziej szczegółowe informacje oraz aby móc korzystać z przyszłych funkcji i integracji, gdy tylko zostaną udostępnione, zalecane zdarzenia należy wysyłać z określonymi parametrami. W tej sekcji pokazujemy, jak rejestrować wstępnie zdefiniowane zdarzenie. Więcej informacji o rejestrowaniu zdarzeń znajdziesz w artykule Rejestrowanie zdarzeń.

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

Web

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

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

Web

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

Dalsze kroki