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

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

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

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

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

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

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

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

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

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

Методы регистрации событий для рекомендуемых типов можно найти в справочнике 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,
    },
);

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

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

    Пользовательские параметры можно использовать в определениях аудитории , которые могут применяться к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Примеры запросов и многое другое можно найти в разделе «Экспорт в Google Analytics 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() . Параметры по умолчанию связаны со всеми будущими событиями, которые будут зарегистрированы.

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

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

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

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

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