Rozpoczęcie korzystania z Google Analytics


Z tego krótkiego wprowadzenia dowiesz się, jak dodać usługę Google Analytics do aplikacji oraz rozpocząć rejestrowanie zdarzeń.

Google Analytics zbiera dane o korzystaniu z aplikacji i jej działaniu. Pakiet SDK rejestruje dwa główne typy informacji:

  • Zdarzenia: informacje o tym, co dzieje się w aplikacji, np. o działaniach użytkowników, zdarzeń lub błędów.
  • Właściwości użytkownika: atrybuty, które określasz, by opisać segmenty swojej witryny bazy użytkowników, np. ich ustawień języka lub położenia geograficznego.

Analytics automatycznie rejestruje część wydarzeń i właściwości użytkownika, nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Dodaj Firebase do swojego kodu JavaScriptu, chyba że masz to już za sobą projektu i sprawdź, czy usługa Google Analytics jest włączona w projekcie Firebase:

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

  • Jeśli używasz istniejącego projektu Firebase, który nie zawiera Włączono Google Analytics, otwórz Integracje na karcie > Ustawienia projektu, aby je włączyć.

.

Gdy włączysz Google Analytics w swoim projekcie, aplikacje internetowe Firebase są połączone z Google Analytics strumieniami danych powiązanymi z Usługa Aplikacje + internet.

Dodaj do aplikacji pakiet SDK Analytics

W zależności od sposobu hostowania aplikacji internetowej konfiguracja może być obsługiwane automatycznie. Może też zaistnieć konieczność zaktualizowania Obiekt konfiguracji Firebase. Jeśli Twoja aplikacja internetowa korzysta już z Google Analytics, może być konieczne wykonanie dodatkowych konfigurację opisaną w artykule Używanie Firebase z tagami gtag.js.

  1. Sprawdź, czy obiekt konfiguracyjny Firebase w kodzie zawiera measurementId Ten identyfikator jest tworzony automatycznie po włączeniu Analytics w projekcie Firebase i zarejestruj aplikację internetową. wymagane do korzystania z Analytics.

    • Jeśli Twoja aplikacja używa Firebase Hosting oraz takich jak zarezerwowanych adresy URL dla pakietów SDK Firebase:

      Firebase automatycznie konfiguruje Twoją aplikację. Aby zakończyć konfiguracji, dodaj skrypty z karty Twoje aplikacje w sekcji Ustawienia projektu w sekcji <body> tagu Twojej aplikacji, jeśli jeszcze nie zostało to zrobione.

    • Jeśli aplikacja nie używa zarezerwowanych adresów URL: Jeśli korzystasz z już istniejącej aplikacji internetowej, zaktualizuj konfigurację Firebase. w kodzie, aby zapewnić obecność pola measurementId. config 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: "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. zainstaluj pakiet SDK Firebase JS i zainicjuj Firebase.

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

Używanie Firebase z dotychczasowym tagowaniem gtag.js

Jeśli w Twojej aplikacji była już używana usługa Google Analytics za pomocą fragment kodu gtag.js, aplikacja może wymagać dodatkowej konfiguracji, jeśli planujesz:

  • Dodaj do strony Google Analytics połączeń z Firebase, ale także zaplanuj te działania nadal korzystaj z wywołań gtag() bezpośrednio na tej samej stronie.
  • Chcesz używać tego samego identyfikatora pomiaru zarówno w bezpośrednich wywołaniach gtag(), jak Dane (Google Analytics) zostały wysłane do Firebase.

Aby mieć pewność, że zdarzenia będą dostępne do użycia we wszystkich usługach Firebase, wykonaj wykonaj te dodatkowe kroki konfiguracji:

  • Usuń linię gtag('config', 'GA_MEASUREMENT_ID'); gdzie GA_MEASUREMENT_ID to measurementId aplikacji internetowej Firebase. Jeśli masz inne identyfikatory na potrzeby innych usług w Analytics na stronie, nie musisz usuwać wiersza config.
  • Przed wysłaniem jakichkolwiek zdarzeń skontaktuj się z firmą firebase.analytics() dzięki gtag().

W przeciwnym razie zdarzenia wysłane na ten identyfikator z gtag() wywołaniami nie będą powiązane z Firebase i nie będą dostępne do kierowania w innych Usługi Firebase.

Zacznij rejestrować zdarzenia

Po zainicjowaniu Analytics, możesz zaczynają rejestrować zdarzenia za pomocą logEvent(). .

Niektóre wydarzenia zalecana w przypadku wszystkich aplikacji; inne są zalecane w przypadku określonych typów działalności lub branż. Należy wysłać zdarzeń z zalecanymi parametrami, aby zapewnić maksymalną dostępne szczegóły w raportach oraz możliwość korzystania z przyszłych funkcji i integracje, gdy tylko będą dostępne. W tej sekcji omawiamy logowanie wstępnie zdefiniowanego zdarzenia. Więcej informacji o logowaniu zdarzeń znajdziesz w materiałach na temat Rejestruj zdarzenia.

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

Web

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

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

Web

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

Dalsze kroki