Measurement Protocol Google Аналитики позволяет отправлять офлайн-данные в поток данных сайта или приложения в дополнение к данным, которые вы уже собираете с помощью тегов или Firebase SDK.
В этом руководстве описаны распространенные сценарии использования Measurement Protocol для Google Аналитики и требования к ним.
Обзор требований
В таблице ниже приведены краткие сведения о необходимых условиях для каждого примера использования. Придерживайтесь следующих рекомендаций:
В качестве значения
timestamp_microsдля событий и свойств пользователей по умолчанию принимается время запроса. Передавая данные об изменившемся в прошлом событии или свойстве пользователя, переопределите временную метку, как описано в руководствах по отправке событий и свойств пользователей.Чтобы повысить точность отчетов в реальном времени и показателей взаимодействия, добавьте параметр события
engagement_time_msec, показывающий, сколько миллисекунд прошло после предыдущего события.
| Пример использования | Идентификатор сеанса | Требование ко времени запроса | Требование timestamp_micros |
|---|---|---|---|
| Присвоение событиям идентификатора User-ID | Обязательно | <= завершение сеанса и начало рабочего дня | >= начало сеанса и <= завершение сеанса |
| Атрибуция сеансов | Обязательно | <= начало сеанса + 24 часа | >= начало сеанса и <= завершение сеанса |
| Экспорт событий на рекламные платформы | Необязательно | <= день последнего сеанса + 63 дня | >= время запроса минус 72 часа и <= время запроса |
| Передача событий или свойств пользователей для создания аудиторий | Необязательно | Сайт: <= время последнего онлайн-события + 30 дней Приложение: <= время последнего онлайн-события + 42 дня |
>= время запроса минус 72 часа и <= время запроса |
Присвоение событиям идентификатора User-ID
Используйте Measurement Protocol, чтобы передавать онлайн- и офлайн-события с идентификатором пользователя.
Вот несколько примеров, когда может потребоваться добавить User-ID к событию:
В ваших онлайн-данных нет информации, необходимой для поиска идентификатора пользователя для онлайн-событий, но у вас есть конвейер обработки событий, который может связать онлайн-сеанс с идентификатором пользователя.
В этом сценарии вы используете Measurement Protocol, чтобы передавать онлайн-события с User-ID.
У вас нет User-ID для событий, которые вы отправляете с помощью Measurement Protocol, но вы хотите, чтобы эти события были связаны с User-ID, если пользователь вошел в аккаунт в течение сеанса.
В этом сценарии вы используете онлайн-события, чтобы передавать события Measurement Protocol с User-ID.
Чтобы добавить User-ID к событию, необходимо выполнить следующие требования:
- Добавьте
session_idв список параметров события. - Отправляйте события Measurement Protocol в тот же рабочий день, когда был онлайн-сеанс.
- Если вы переопределяете
timestamp_micros, задайте временную метку между началом и окончанием онлайн-сеанса. - Если вы хотите передавать идентификаторы User-ID для онлайн-событий, задайте в запросе параметр
user_id. - Если вы хотите, чтобы у каждого события Measurement Protocol был идентификатор пользователя из соответствующего онлайн-сеанса, задавать параметр
user_idне нужно.
Атрибуция сеансов
События Measurement Protocol, соответствующие определенным требованиям, появляются в отчетах с теми же атрибутами сеанса (например, географическими данными, источником, каналом и кампанией), что и онлайн-события из того же сеанса.
Вот требования к атрибуции сеансов:
- Добавьте
session_idв список параметров события. Запрос нужно отправить не позднее чем через 24 часа после начала онлайн-сеанса.
Например, если сеанс начался в понедельник в 11:15 по часовому поясу вашего ресурса, отправьте запрос до 11:15 во вторник.
Если вы переопределяете
timestamp_micros, задайте временную метку между началом и окончанием онлайн-сеанса.
Экспорт событий на рекламные платформы
Google Аналитика включает события, отправленные с помощью Measurement Protocol, в экспорт в связанные рекламные продукты, такие как Google Реклама или Менеджер кампаний 360.
Вот несколько распространенных сценариев, в которых это может быть полезно:
- У вас есть офлайн-события, которые вы хотите включить в атрибуцию и отчеты.
- В системе, которая не поддерживает теги или Firebase SDK, есть дополнительные события, которые вы хотите включить в связанные продукты.
Чтобы экспортировать события на рекламные платформы, необходимо выполнить следующие требования:
Отправьте запрос не позднее чем через 63 дня после последнего онлайн-события, даже если период атрибуции ключевого события превышает 63 дня. Кроме того, событие должно произойти в течение периода атрибуции ключевого события. Подробнее о том, как настроить период атрибуции…
Например, если последнее онлайн-событие для
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 часов.