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

The Google Analytics Measurement Protocol lets you send offline data to your Web or App stream, in addition to the data you're already collecting with tagging or the Firebase SDK.

This guide describes common Google Analytics Measurement Protocol use cases and their requirements.

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

This table provides a quick reference of the requirements for each use case. Keep the following best practices in mind:

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

2. For accurate Realtime reports and engagement metrics, include the engagement_time_msec event parameter set to the milliseconds elapsed since the preceding event.

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

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

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

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

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

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

   In this scenario, you are using online events to provide Measurement Protocol events with a User-ID.

Here are the requirements to add a User-ID to an event:

• Include the session_id in the event's parameter list.
• Отправляйте события протокола измерений в тот же рабочий день , что и онлайн-сессия.
• Если вы переопределяете timestamp_micros , установите его значение равным временной метке между временем начала и окончания онлайн-сессии.
• If your goal is to provide User-ID for online events, set the user_id in the request.
• Если ваша цель состоит в том, чтобы каждое событие протокола Measurement Protocol имело идентификатор пользователя (User-ID) из соответствующей онлайн-сессии, вам не нужно устанавливать user_id .

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

События протокола измерения, отвечающие определенным требованиям, отображаются в отчетах с теми же атрибутами сессии (такими как географическая информация, источник, носитель и кампания), что и онлайн-события из той же сессии.

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

• Include the session_id in the event's parameter list.

• Send the request no later than 24 hours after the start of the online session.

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

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

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

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

A few common scenarios where this is useful include:

• Ваша компания проводит офлайн-мероприятия, которые вы хотите включить в анализ эффективности рекламы и отчетность.
• You have additional events in a system that is not available to tagging or the Firebase SDK, but you still want to include those events in linked products.

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

• Запрос необходимо отправить не позднее чем через 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 часов.