Журнал событий

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

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

Прежде чем начать

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics, как описано в разделе «Начало работы с Analytics» .

Журнал событий

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

Предопределенные события

Чтобы помочь вам начать работу, Analytics 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,
    },
);

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

Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах Google Analytics . Вы можете использовать специальные параметры для нечисловых данных параметров событий и специальные показатели для любых данных параметров, которые лучше представить в числовом виде. После того как вы зарегистрировали специальный параметр с помощью SDK, зарегистрируйте параметр или показатель, чтобы эти специальные параметры отображались в отчетах Analytics. Сделайте это, используя «Аналитика» > «События» > «Управление пользовательскими определениями» > «Создать специальные измерения» .
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Найдите примеры запросов и многое другое в Google Analytics 4 BigQuery Export .
Параметр value : параметр общего назначения, который полезен для сбора ключевой метрики, относящейся к событию. Примеры включают доход, расстояние, время и баллы.
Имена параметров могут иметь длину до 40 символов, должны начинаться с буквенного символа и содержать только буквенно-цифровые символы и символы подчеркивания. Поддерживаются строковые и числовые типы. Значения строковых параметров могут иметь длину до 100 символов. Префиксы «firebase », «google » и «ga_» зарезервированы и не должны использоваться в именах параметров.

Пользовательские события

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

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

Установить параметры события по умолчанию

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

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

Допустимые значения параметров: String и num. Установка значения ключа в null очищает этот параметр. Передача нулевого значения очищает все параметры.

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

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

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

Просматривайте события в панели управления

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

Вы можете получить доступ к этим данным на панели событий в консоли Firebase . На этой панели мониторинга отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, регистрируемых вашим приложением.