Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

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

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

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

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

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

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

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

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

  • Если у вас есть проект Firebase, в котором не включена Google Analytics, вы можете включить 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-адреса для пакетов SDK Firebase :

      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:

     firebase.analytics();
    

Используйте Firebase с существующими тегами gtag.js

Если раньше в вашем приложении был запущен Google Analytics с использованием фрагмента gtag.js , ваше приложение может потребовать дополнительной настройки, если вы планируете выполнить одно из следующих действий:

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

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

  • Удалите [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) в URL- [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) . Ваш фрагмент кода gtag должен быть похож на

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Удалите строку gtag('config', ' GA_MEASUREMENT_ID '); где GA_MEASUREMENT_ID является таким же , как measurementId в вашем Firebase конфигурации фрагменте. Если у вас есть другие идентификаторы для других ресурсов Google Analytics на странице, вам не нужно удалять их строку конфигурации.

  • Убедитесь, что вы вызываете firebase.analytics() прежде чем отправлять какие-либо события с помощью gtag() .

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

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

После инициализации службы аналитики с помощью firebase.analytics () можно начать регистрировать события с помощью метода logEvent () .

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

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

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

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