Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Zacznij korzystać z Google Analytics

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

Google Analytics zbiera dane o użytkowaniu i zachowaniu Twojej aplikacji internetowej. SDK rejestruje dwa podstawowe typy informacji:

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

  • Właściwości użytkownika : atrybuty definiowane przez Ciebie w celu opisania segmentów Twojej bazy użytkowników, takie jak preferencje językowe 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łączone w Twoim projekcie Firebase:

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

  • Jeśli używasz istniejącego projektu Firebase, który nie ma włączonej usługi Google Analytics, przejdź do karty Integracje w > Ustawienia projektu, aby go włączyć.

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

Dodaj pakiet SDK Analytics do swojej aplikacji

W zależności od sposobu hostowania Twojej 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 istniejącymi tagami gtag.js.

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

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

      Firebase automatycznie obsługuje konfigurację aplikacji. Aby zakończyć konfigurację, dodaj skrypty z karty Twoje aplikacje w ustawieniach projektu do tagu <body> aplikacji, jeśli jeszcze tego nie zrobiłeś.

    • Jeśli aplikacja nie korzysta zastrzeżone URL: Jeśli pracujesz z istniejącej aplikacji internetowej, zaktualizuj config obiekt Firebase w kodzie w celu zapewnienia measurementId pole jest obecny. Obiekt config powinien wyglądać podobnie do poniższego 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. Zainicjuj Firebase Analytics:

Web v8

const analytics = firebase.analytics();
index.js

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();
analytics_initialize.js

Użyj Firebase z istniejącymi tagami gtag.js.

Jeśli wcześniej w swojej aplikacji działał Google Analytics przy użyciu fragmentu kodu gtag.js , może ona wymagać dodatkowej konfiguracji, jeśli planujesz wykonać jedną z następujących czynności:

  • Dodaj wywołania Google Analytics z Firebase do strony, ale planuj też nadal używać gtag() bezpośrednio na tej samej stronie.
  • Chcesz używać tego samego identyfikatora pomiaru między bezpośrednimi połączeniami gtag() i danymi Google Analytics wysyłanymi do Firebase.

Aby upewnić się, że Twoje wydarzenia są dostępne dla wszystkich usług Firebase, wykonaj następujące dodatkowe czynności konfiguracyjne:

  • Usuń [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) URL. Twój fragment kodu gtag powinien być podobny do

    <script async src="https://www.googletagmanager.com/gtag/js"></script>

  • Usuń wiersz gtag('config', ' GA_MEASUREMENT_ID '); gdzie GA_MEASUREMENT_ID jest taki sam jak measurementId we fragmencie kodu konfiguracji Firebase. Jeśli masz na stronie inne identyfikatory dla innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.

  • Upewnij się, że wywołujesz firebase.analytics() przed wysłaniem jakichkolwiek zdarzeń za pomocą gtag() .

W przeciwnym razie zdarzenia wysłane do tego identyfikatora za pomocą 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 Analytics za pomocą „firebase.analytics ()” można rozpocząć rejestrowanie zdarzeń za pomocą metody „logEvent ()” .

Pewne zdarzenia są zalecane dla wszystkich aplikacji ; inne są zalecane dla określonych typów działalności lub branż. Powinieneś wysyłać sugerowane zdarzenia wraz z przypisanymi im parametrami, aby zapewnić maksymalną dostępną szczegółowość w raportach i korzystać z przyszłych funkcji i integracji, gdy staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanych zdarzeń. Aby uzyskać więcej informacji na temat rejestrowania zdarzeń, zobacz Rejestrowanie zdarzeń .

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

Web v8

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

Web v9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Następne kroki