События журнала

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


Аналитика автоматически регистрирует некоторые события, поэтому вам не нужно добавлять код, чтобы получать их. Если приложению нужно собирать дополнительные данные, вы можете регистрировать в нем до 500 типов событий Аналитики. Общее количество регистрируемых событий не ограничено. Обратите внимание, что в названиях событий учитывается регистр. Два события, названия которых отличаются только регистром, считаются разными.

Подготовка

Убедитесь, что у вас настроен проект и есть доступ к Аналитике, как описано в статье Начало работы с Google Аналитикой.

Если вы хотите собирать данные об атрибуции в кампаниях для приложений на платформе Apple, добавьте в проект фреймворк AdSupport.

Как регистрировать события

После создания экземпляра FirebaseAnalytics вы можете использовать его для регистрации событий с помощью методов библиотеки log.

Стандартные события

Чтобы вам было проще начать работу, в SDK Аналитики определено несколько рекомендуемых событий, которые часто встречаются в приложениях разных типов, в том числе в приложениях для розничной торговли и электронной коммерции, путешествий и игр. Подробнее об этих событиях и о том, когда их следует использовать, рассказывается в статье Рекомендуемые события.

Методы регистрации для рекомендуемых типов событий можно найти в документации по API.

В примере ниже показано, как зарегистрировать событие select_content:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

Вы также можете зарегистрировать то же событие с помощью logEvent():

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

Это может быть полезно, если вы хотите указать дополнительные параметры, помимо обязательных. Вы можете добавить к любому событию следующие параметры:

  • Специальные параметры, которые могут использоваться в качестве параметров или показателей в отчетах Аналитики. Вы можете использовать специальные параметры для нечисловых данных по параметрам событий, а специальные показатели – для данных по параметрам, которые удобнее представлять в числовом виде. После того как вы зарегистрируете специальный параметр с помощью SDK, чтобы он отображался в отчетах Аналитики, вам нужно зарегистрировать соответствующий ему параметр или показатель. Сделать это можно в меню Аналитика > События > Настроить пользовательские определения > Создать специальный параметр.

    Специальные параметры можно использовать в определениях аудиторий, которые можно применять ко всем отчетам. Если ваше приложение связано с проектом BigQuery, то пользовательские параметры также будут включены в данные, экспортируемые в BigQuery. Примеры запросов и другую информацию можно найти в статье Экспорт данных Google Аналитики 4 в BigQuery.

  • Параметр общего назначения value, удобный для сбора данных по ключевому показателю, относящемуся к событию. Примеры: доход, расстояние, время и баллы.

  • Название параметра может содержать не больше 40 символов (буквы, цифры, знаки подчеркивания) и должно начинаться с буквы. Поддерживаются типы string и num. Значения строковых параметров могут содержать до 100 символов. Префиксы firebase, google и ga_ зарезервированы и не должны использоваться в названиях параметров.

Специальные события

Если предлагаемые типы событий не подходят для вашего приложения, вы можете регистрировать собственные специальные события, как показано в примере ниже:

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

Как настроить параметры по умолчанию для событий

Вы можете регистрировать параметры различных событий с помощью setDefaultEventParameters(). Параметры по умолчанию связаны со всеми событиями, которые будут регистрироваться в будущем.

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

Допустимые значения параметров – String и num. Если задать для ключа значение null, параметр будет удален. Если передать нулевое значение, все параметры будут удалены.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

Если в методе logEvent() или log указан параметр, вместо значения по умолчанию используется его значение.

Чтобы удалить значение параметра по умолчанию, вызовите метод setDefaultEventParameters(), задав для параметра значение null.