Pierwsze kroki z Google Analytics w przypadku witryn

Wybierz platformę: iOS+ Android Web Flutter Unity C++


Z tego samouczka 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 dzieje się 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 zdarzenia i właściwości użytkownika. Nie musisz dodawać żadnego kodu, aby je włączyć.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do projektu JavaScript i upewnij się, że Google Analytics jest włączona w projekcie w Firebase:

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

  • Jeśli używasz dotychczasowego projektu Firebase bez włączonej usługi Google Analytics możesz ją włączyć na karcie Ustawienia > Integracje.

Gdy włączysz Google Analytics w projekcie, Twoje aplikacje internetowe Firebase zostaną połączone ze strumieniami danych Google Analytics powiązanymi z usługą usługa 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 aplikacja internetowa korzysta już z Google Analytics, może być konieczne wykonanie dodatkowej konfiguracji opisanej w sekcji Używanie Firebase z dotychczasowym tagowaniem gtag.js.

  1. Sprawdź, czy obiekt konfiguracji Firebase w kodzie zawiera measurementId. Ten identyfikator jest tworzony automatycznie, gdy włączasz Analytics w projekcie w Firebase i rejestrujesz aplikację internetową. Jest on wymagany do korzystania z Analytics.

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

      Firebase automatycznie konfiguruje aplikację. Aby dokończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w Ustawieniach projektu do tagu <body> aplikacji, jeśli nie zostały jeszcze dodane.

    • Jeśli aplikacja nie używa zarezerwowanych adresów URL: jeśli pracujesz z dotychczasową aplikacją internetową, zaktualizuj obiekt konfiguracji Firebase w kodzie, aby upewnić się, że pole measurementId jest obecne. 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"
};
      1. Jeśli nie masz jeszcze zainstalowanego pakietu Firebase JS SDK i zainicjowanego Firebase, zrób to teraz. 2. Dodaj pakiet Analytics JS SDK 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 wcześniej w aplikacji działała usługa Google Analytics za pomocą fragmentu kodu gtag.js, może być konieczne wykonanie dodatkowej konfiguracji, jeśli planujesz wykonać jedną z tych czynności:

  • Dodaj do strony wywołania Google Analytics z Firebase, ale planujesz też nadal używać 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 i w danych wysyłanych do Firebase.Google Analytics

Aby mieć pewność, że zdarzenia są dostępne do użycia we wszystkich usługach Firebase, wykonaj te dodatkowe czynności konfiguracyjne:

  • Usuń wiersz gtag('config', 'GA_MEASUREMENT_ID'); gdzie GA_MEASUREMENT_ID to measurementId 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 za pomocą gtag(), wywołaj firebase.analytics().

W przeciwnym razie zdarzenia wysyłane do tego identyfikatora za pomocą wywołań gtag() nie będą powiązane z Firebase i nie będą dostępne do kierowania w innych usługach Firebase.

Rozpocznij rejestrowanie zdarzeń

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

Niektóre zdarzenia są zalecane w przypadku wszystkich aplikacji; a inne – w przypadku określonych typów firm 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ń.

Ten przykład pokazuje, jak zarejestrować 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