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

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