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

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


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

Подготовка

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

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

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

После создания экземпляра 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,
    },
);

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

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

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

  • Параметр общего назначения 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.