Протокол Google Аналитики Measurement Protocol позволяет отправлять офлайн-данные в поток данных сайта или приложения в дополнение к данным, которые вы уже собираете с помощью тегов или 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.
Вот несколько примеров того, как можно добавить 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 из соответствующего онлайн-сеанса, вам не нужно задавать параметр
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 часам.