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

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

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

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

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

1. The timestamp_micros of events and user properties defaults to the request time. When sending an event or user property change that occurred in the past, override the timestamp as described in the sending events guide and the user properties guide.

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

Присвойте идентификатор пользователя событиям.

Используйте протокол Measurement Protocol для предоставления информации о событиях в режиме онлайн или офлайн с помощью идентификатора пользователя (User-ID) .

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

1. Your online measurement lacks the information needed to look up the User-ID for online events, but you have an event-processing pipeline that is able to make the association between an online session and a User-ID.

   В данном сценарии вы используете протокол Measurement Protocol для предоставления онлайн- событий с идентификатором пользователя (User-ID).

2. You don't have the User-ID for events you are sending with the Measurement Protocol, but you want those events to be associated with a User-ID if the user logged in online over the course of the session.

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

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

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

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

Measurement Protocol events that meet specific requirements appear in reports with the same session attributes (such as geographic information, source, medium, and campaign) as online events from the same session.

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

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

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

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

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

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

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

Вот несколько распространенных ситуаций, когда это может быть полезно:

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

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

• Send the request no later than 63 days after the latest online event, even if the key event's attribution window is more than 63 days. The event must also arrive within the key event's attribution window. See how to configure attribution window settings .

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

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

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

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

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

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

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

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

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

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