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

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

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

Резюме требований

Эта таблица дает краткую справку по требованиям для каждого варианта использования. Имейте в виду следующие рекомендации:

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

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

Назначить 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 включает события, которые вы отправляете с помощью Measurement Protocol, в экспорт в связанные рекламные продукты, такие как Google Ads или Campaign Manager 360.

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

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

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

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

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

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

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

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

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

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

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

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

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

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