Начало работы с 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"
};
      1. Если вы ещё этого не сделали, установите Firebase JS SDK и инициализируйте Firebase. 2. Добавьте JS SDK Analytics и инициализируйте 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');

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