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 Twojej aplikacji internetowej i jej działaniu. 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 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');
analytics_log_event.js

Web

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

Dalsze kroki