В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрировать события.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События. Что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя: атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое местоположение.
Аналитика автоматически регистрирует некоторые события и свойства пользователей ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем вы начнете
Если вы еще этого не сделали, добавьте Firebase в свой проект JavaScript и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включен Google Analytics, перейдите на вкладку «Интеграции» вашего
Добавьте Analytics SDK в свое приложение
Убедитесь, что ваш объект конфигурации Firebase в вашем коде содержит measurementId
. Этот идентификатор создается автоматически, когда вы включаете Analytics в своем проекте Firebase и регистрируете веб-приложение. Он необходим для использования Analytics.Если ваше приложение использует хостинг Firebase и использует зарезервированные URL-адреса для Firebase SDK : Firebase автоматически выполняет настройку вашего приложения. Чтобы завершить настройку, добавьте сценарии из карточки «Ваши приложения» в настройках проекта в тег <body> вашего приложения, если вы еще этого не сделали. Если ваше приложение не использует зарезервированные URL-адреса : если вы работаете с существующим веб-приложением , обновите объект конфигурации Firebase в своем коде, чтобы убедиться, что поле measurementId
присутствует. Объект конфигурации должен выглядеть примерно так, как показано в следующем примере:// 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" };
Установите Firebase JS SDK и инициализируйте Firebase , если вы еще этого не сделали. Добавьте Analytics JS SDK и инициализируйте 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();
Используйте Firebase с существующими тегами gtag.js.
Добавьте на страницу вызовы Google Analytics из Firebase, но также планируйте продолжать использовать вызовы gtag()
непосредственно на той же странице.Хотите использовать один и тот же идентификатор измерения как для прямых вызовов gtag()
так и для данных Google Analytics, отправляемых в Firebase.
Удалите строку gtag('config', ' GA_MEASUREMENT_ID ');
гдеGA_MEASUREMENT_ID
— этоmeasurementId
вашего веб-приложения Firebase. Если у вас есть другие идентификаторы для других свойств Google Analytics на странице, вам не нужно удалять их строку конфигурации.Обязательно вызывайте firebase.analytics()
перед отправкой каких-либо событий с помощьюgtag()
.
gtag()
не будут связаны с Firebase и не будут доступны для таргетинга в других сервисах Firebase.
Начните регистрировать события
logEvent()
.
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
Следующие шаги
Понимание каждого отчета Google Analytics . Используйте DebugView для проверки ваших событий. Просматривайте свои данные в консоли Firebase . Изучите руководства по событиям и свойствам пользователя. Узнайте, как экспортировать данные в BigQuery.