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 zdefiniowane w celu opisania segmentów 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łączony w Twoim projekcie Firebase:

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

  • Jeśli masz istniejący projekt Firebase, który nie ma włączonej usługi Google Analytics, możesz włączyć Google Analytics na karcie Integracje w > Ustawienia projektu .

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 Analytics SDK do swojej aplikacji

W zależności od sposobu hostowania Twojej aplikacji internetowej konfiguracja może być obsługiwana automatycznie lub może być konieczna aktualizacja 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:

     firebase.analytics();
    

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 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 konfiguracji Firebase. Jeśli masz na stronie inne identyfikatory innych usług Analytics, nie musisz usuwać ich wiersza konfiguracji.

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

W przeciwnym razie zdarzenia wysyłane na ten identyfikator 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ępność szczegółów w raportach i korzystać z przyszłych funkcji i integracji, gdy staną się dostępne. W tej sekcji przedstawiono rejestrowanie wstępnie zdefiniowanego zdarzenia. 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:

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

Następne kroki