Catch up on everything we announced at this year's Firebase Summit. Learn more

Начать работу с Google Analytics

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

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

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

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

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

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

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

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

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

При включении Google Analytics в вашем проекте, ваши веб - приложения Firebase связаны с данными Google Analytics потоки , связанные с App + Web собственности .

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

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

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

    • Если ваше приложение использует Firebase хостинга и использует зарезервированный URL - адрес для Firebase SDKs:

      Firebase автоматически выполняет настройку вашего приложения. Для полной установки, добавьте сценарии с карты ваших приложений в ваших настройках проекта в теге <BODY> вашего приложения, если вы еще не сделали.

    • Если ваше приложение не использует зарезервированные адреса: Если вы работаете с существующим веб - приложение, обновить объект конфигурации 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 Analytics:

Веб-версия 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Веб-версия 8

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() .

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

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

После инициализации службы Analytics , вы можете начать запись событий с logEvent() методом.

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

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

Веб-версия 9

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

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

Веб-версия 8

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

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