Начало работы с Google Аналитикой для сайтов

Выберите платформу: iOS+ Android Веб Flutter Unity C++


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

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

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

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

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

Подготовка

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

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

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

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

Как добавить в приложение Analytics SDK

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

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

    • Если ваше приложение использует Firebase Hosting и зарезервированные URL для Firebase SDK:

      Firebase настраивает приложение автоматически. Чтобы завершить настройку, добавьте скрипты, доступные на карточке Your apps (Ваши приложения) в настройках проекта, в тег <body> приложения, если вы этого ещё не сделали.

    • Если вы работаете с существующим веб-приложением, которое не использует зарезервированные URL, добавьте в объект конфигурации Firebase в своем коде поле measurementId. Объект конфигурации должен выглядеть приблизительно так:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};
      <0 Если вы ещё этого не сделали, установите Firebase JS SDK и инициализируйте Firebase. 2. Добавьте 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 Аналитику в своем приложении с помощью тега gtag.js, возможно, вам понадобится выполнить дополнительную настройку. Это нужно в следующих случаях:

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

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

  • Удалите строку gtag('config', 'GA_MEASUREMENT_ID');, где GA_MEASUREMENT_ID – это measurementId веб-приложения Firebase. Если на странице есть идентификаторы для других ресурсов Аналитики, не нужно удалять строку конфигурации для этих ресурсов.
  • Убедитесь, что вызов 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');

Дальнейшие действия