Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Начните работу с Google Аналитикой

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрацию событий.

Google Analytics собирает данные об использовании и поведении вашего веб-приложения. SDK регистрирует два основных типа информации:

  • События : что происходит в вашем приложении, например действия пользователя, системные события или ошибки.

  • Свойства пользователя : атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, такие как языковые предпочтения или географическое положение.

Analytics автоматически регистрирует некоторые события и свойства пользователя ; вам не нужно добавлять какой-либо код, чтобы включить их.

Прежде чем вы начнете

Если вы еще этого не сделали, добавьте Firebase в свой проект JavaScript и убедитесь, что Google Analytics включен в вашем проекте Firebase:

  • Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.

  • Если вы используете существующий проект Firebase, в котором не включен Google Analytics, перейдите на вкладку « Интеграция » в > Настройки проекта, чтобы включить его.

Когда вы включаете Google Analytics в своем проекте, ваши веб-приложения Firebase связываются с потоками данных Google Analytics, связанными с ресурсом типа « Приложение и сайт » .

Добавьте Analytics SDK в свое приложение

В зависимости от того, как размещено ваше веб-приложение, ваша конфигурация может обрабатываться автоматически или вам может потребоваться обновить объект конфигурации Firebase . Если ваше веб-приложение уже использует Google Analytics, вам может потребоваться дополнительная настройка, описанная в разделе Использование Firebase с существующими тегами gtag.js .

  1. Убедитесь, что ваш объект конфигурации Firebase в вашем коде содержит measurementId . Этот идентификатор создается автоматически, когда вы включаете Analytics в своем проекте Firebase и регистрируете веб-приложение, и он необходим для использования Analytics.

    • Если ваше приложение использует Firebase Hosting и использует зарезервированные 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"
      };
      
  2. Если вы еще этого не сделали, установите Firebase JS SDK и инициализируйте Firebase .

  3. Добавьте Analytics JS SDK и инициализируйте Analytics:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
firebase.initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = firebase.analytics();

Используйте Firebase с существующими тегами gtag.js

Если вы ранее использовали Google Analytics в своем приложении с помощью фрагмента кода gtag.js , вашему приложению может потребоваться дополнительная настройка, если вы планируете выполнить одно из следующих действий:

  • Добавьте вызовы Google Analytics из Firebase на страницу, но также планируйте продолжать использовать gtag() непосредственно на той же странице.
  • Хотите использовать один и тот же идентификатор измерения как для прямых gtag() так и для данных Google Analytics, отправляемых в Firebase.

Чтобы ваши события были доступны для использования всеми службами Firebase, выполните следующие дополнительные шаги настройки:

  • Удалите строку gtag('config', ' GA_MEASUREMENT_ID '); где GA_MEASUREMENT_ID — это measurementId вашего веб-приложения Firebase. Если у вас есть другие идентификаторы для других ресурсов Google Analytics на странице, вам не нужно удалять их строку конфигурации.
  • Убедитесь, что вы вызываете firebase.analytics() , прежде чем отправлять какие-либо события с помощью gtag() .

В противном случае события, отправленные на этот идентификатор с помощью вызовов gtag() , не будут связаны с Firebase и не будут доступны для таргетинга в других службах Firebase.

Начать регистрацию событий

После того как вы инициализировали службу Analytics , вы можете начать регистрировать события с помощью logEvent() .

Определенные события рекомендуются для всех приложений ; другие рекомендуются для определенных типов бизнеса или вертикалей. Вы должны отправлять предлагаемые события вместе с их заданными параметрами, чтобы обеспечить максимально доступную информацию в ваших отчетах и ​​извлечь выгоду из будущих функций и интеграций по мере их появления. В этом разделе демонстрируется запись в журнал предопределенного события. Дополнительные сведения о регистрации событий см. в разделе События в журнале.

В следующем примере показано, как зарегистрировать рекомендуемое событие, чтобы указать, что пользователь получил уведомление в вашем приложении:

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web version 8

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

Следующие шаги