Варианты использования протокола измерений

Протокол измерения Google Analytics позволяет отправлять офлайн-данные в поток веб-сайта или приложения в дополнение к данным, которые вы уже собираете с помощью тегов или Firebase SDK.

В этом руководстве описаны распространенные варианты использования протокола измерений Google Analytics и их требования.

Краткое изложение требований

В этой таблице представлен краткий справочник требований для каждого варианта использования. Помните о следующих рекомендациях:

  1. timestamp_micros событий и свойств пользователя по умолчанию соответствует времени запроса. При отправке события или изменения свойств пользователя, произошедшего в прошлом, переопределите временную метку, как описано в руководстве по отправке событий и руководстве по свойствам пользователя .

  2. Для получения точных отчетов в реальном времени и показателей взаимодействия включите параметр события engagement_time_msec , равный миллисекундам, прошедшим с момента предыдущего события.

Вариант использования Идентификатор сеанса Требуемое время запроса требование timestamp_micros
Назначение User-ID событиям Необходимый <= конец сессии, начало рабочего дня >= начало сеанса и <= конец сеанса
Атрибуция сеанса Необходимый <= начало сеанса + 24 часа >= начало сеанса и <= конец сеанса
Экспорт событий на рекламные платформы Не требуется <= рабочий день последней сессии + 63 дня <= время запроса
Отправляйте события или свойства пользователя для создания аудитории. Не требуется Интернет: <= время последнего онлайн-события + 30 дней.
Приложение: <= время последнего онлайн-события + 42 дня.		 <= время запроса

Назначение User-ID событиям

Используйте протокол измерения, чтобы предоставить онлайн- или офлайн-событиям идентификатор пользователя .

Вот несколько примеров использования добавления User-ID к событию:

  1. В вашем онлайн-измерении отсутствует информация, необходимая для поиска User-ID для онлайн-событий, но у вас есть конвейер обработки событий, который может установить связь между онлайн-сеансом и User-ID.

    В этом сценарии вы используете протокол измерений для предоставления онлайн- событиям идентификатора пользователя.

  2. У вас нет идентификатора пользователя для событий, которые вы отправляете с помощью протокола измерений, но вы хотите, чтобы эти события были связаны с идентификатором пользователя, если пользователь вошел в систему в течение сеанса.

    В этом сценарии вы используете онлайн-события для предоставления событиям протокола измерений идентификатора пользователя.

Вот требования для добавления User-ID к событию:

  • Включите session_id в список параметров события.
  • Отправляйте события протокола измерений в тот же рабочий день , что и онлайн-сеанс.
  • Если вы переопределите timestamp_micros , установите для него метку времени между временем начала и окончания онлайн-сеанса.
  • Если ваша цель — предоставить User-ID для онлайн-мероприятий, установите user_id в запросе.
  • Если ваша цель состоит в том, чтобы каждое событие Measurement Protocol имело идентификатор пользователя из соответствующего онлайн-сеанса, вам не нужно устанавливать user_id .

Атрибуция сеанса

События протокола измерений, соответствующие определенным требованиям, отображаются в отчетах с теми же атрибутами сеанса (такими как географическая информация, источник, канал и кампания), что и онлайн-события из того же сеанса.

Вот требования для атрибуции сеанса:

  • Включите session_id в список параметров события.

  • Отправьте заявку не позднее, чем через 24 часа после начала онлайн-сессии.

    Например, если сеанс начался в 11:15 в понедельник в часовом поясе вашего объекта, отправьте запрос до 11:15 во вторник.

  • Если вы переопределите timestamp_micros , установите для него метку времени между временем начала и окончания онлайн-сеанса.

Экспорт событий на рекламные платформы

Google Analytics включает события, которые вы отправляете с помощью протокола измерений, при экспорте в связанные рекламные продукты, такие как Google Ads или Campaign Manager 360.

Вот несколько распространенных сценариев, в которых это полезно:

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

Вот требования для экспорта событий на рекламные платформы:

  • Отправьте запрос не позднее конца рабочего дня через 63 дня после последнего онлайн-события, даже если окно атрибуции ключевого события превышает 63 дня.

    Например, если последнее онлайн-событие для client_id или app_instance_id произошло 1 марта, отправьте событие Measurement Protocol не позднее конца рабочего дня 3 мая.

  • Если вы переопределяете timestamp_micros , установите для него метку времени, меньшую или равную времени запроса.

Отправляйте события или свойства пользователя для создания аудитории.

События и свойства пользователя, отправленные с помощью протокола измерений, включаются в оценку состояния аудитории , если вы соблюдаете несколько требований.

Ниже приведены требования для отправки событий или свойств пользователя для создания аудитории:

  • Отправьте запрос в веб-поток не позднее конца рабочего дня через 30 дней после последнего онлайн-события для того же client_id .

    Например, если последнее онлайн-событие для client_id произошло 1 марта, отправьте событие Measurement Protocol не позднее конца рабочего дня 31 марта.

  • Отправьте запрос в поток приложения не позднее конца рабочего дня через 42 дня после последнего онлайн-события для того же app_instance_id .

    Например, если последнее онлайн-событие для app_instance_id произошло 1 марта, отправьте событие Measurement Protocol не позднее конца рабочего дня 12 апреля.

  • Если вы переопределяете timestamp_micros , установите для него метку времени, меньшую или равную времени запроса.