欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

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

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