Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Начать работу с 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');

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