Rozpoczęcie korzystania z Google Analytics

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

Google Analytics zbiera dane o korzystaniu i zachowaniu Twojej aplikacji internetowej. Pakiet SDK rejestruje dwa główne typy informacji:

  • Zdarzenia: co dzieje się w aplikacji, np. działania użytkowników, system zdarzeń lub błędów.

  • Właściwości użytkownika: atrybuty, które określasz, aby opisać segmenty użytkowników. takie jak preferowany język czy położenie geograficzne.

Analytics automatycznie rejestruje niektóre zdarzenia oraz 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 upewnij się, że usługa Google Analytics jest włączona w projekcie Firebase:

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

  • Jeśli używasz istniejącego projektu Firebase, który nie zawiera włączona jest usługa Google Analytics, przejdź do Integracje karta na Twoim urządzeniu > Aby ją włączyć, Ustawienia projektu.

Po włączeniu Google Analytics w projekcie Twoje aplikacje internetowe Firebase są połączone ze strumieniami danych Google Analytics powiązanymi z kontem Usługa Aplikacje + internet.

Dodawanie pakietu SDK Analytics do aplikacji

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 korzysta z Hostingu Firebase i korzysta z 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 połączenia Google Analytics z Firebase, ale także zaplanuj takie działania nadal korzystaj z wywołań typu 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 wysyłane do Firebase.

Aby wszystkie usługi Firebase mogły korzystać ze zdarzeń, 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');
analytics_log_event.js

Web

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

Dalsze kroki