Measurement Protocol
Measurement Protocol — это инструмент, который позволяет передавать данные о взаимодействиях пользователей напрямую с вашего сервера на сервера Метрики через HTTP-запросы. Он расширяет возможности сбора и анализа данных — дополняет данные, собранные стандартным веб-счетчиком.
Применение
- Связывание онлайн-визитов с вашими данными
-
Measurement Protocol позволяет комбинировать данные, собранные счетчиком Метрики на вашем сайте, с данными, которые веб-счетчик не может отслеживать.
Например:
- дополнить визит пользователя информацией о тех страницах, где счетчик Метрики не установлен;
- отправить данные о качестве лида, который заполнил форму в визите, записанном веб-счетчиком. Добавьте в этот визит событие конверсии для более глубокого анализа.
- Отслеживание действий как на стороне клиента, так и на стороне сервера
-
С помощью Measurement Protocol вы можете передавать данные как с клиентской, так и с серверной стороны. Это особенно полезно, когда сбор данных с клиентской стороны ограничен из-за блокировщиков рекламы или настроек браузеров.
- Более точная передача данных о событиях электронной коммерции
-
Measurement Protocol позволяет передавать данные о событиях электронной коммерции напрямую с вашего сервера. Это полезно, когда пользователи не возвращаются на сайт после страницы эквайринга или когда веб-счетчик не может зафиксировать данные по другим причинам — например при наличии у пользователя сайта блокировщика сторонних скриптов.
Передаваемые данные
С помощью Measurement Protocol вы можете как создать на счетчике новые визиты, так и дополнить существующие.
Основной идентификатор для отправки данных — ClientID Метрики. Он позволяет связать передаваемые данные с историей и визитами пользователя на счетчике.
Вы можете отправить:
- посещения страниц;
- выполнения JavaScript-целей;
- события электронной коммерции (просмотры товаров, покупки, добавления или удаления из корзины).
Ограничение на дополнение веб-визитов
Данные, отправленные через Measurement Protocol, в отличие от офлайн-данных, могут быть записаны только в течение 12 часов с момента завершения визита. Дополнение визитов, завершенных более 12 часов назад, невозможно.
Если необходимо внести данные в более старые визиты, рекомендуем использовать передачу офлайн-данных. Единственный способ записать с помощью Measurement Protocol данные для пользователей, визиты которых завершились более 12 часов назад — это создать новый визит для этого пользователя и добавить в него необходимые данные.
Подробнее про правила отправки данных читайте в Справке API.
Как настроить передачу данных
Включите Measurement Protocol в настройках счетчика и получите авторизационный токен.
Чтобы получить возможность отправлять данные, в интерфейсе или API Метрики перейдите в раздел Безопасность и использование данных и включите в дополнительных настройках счетчика опцию Measurement Protocol. После этого будет сгенерирован токен, который нужно отправлять в запросах к mc.yandex.ru/collect. Дополнительно можно создать до 5 авторизационных токенов.
Подробнее про управление опцией и генерацию токенов через API
Запомните идентификатор ClientID пользователей.
Основной идентификатор для отправки данных Measurement Protocol — ClientID пользователя Метрики. Во время визита пользователя, записанного Метрикой, запомните этот идентификатор на своем сервере для дальнейшей отправки данных.
Отправьте данные.
Отправьте на URL-адрес mc.yandex.ru/collect POST- или GET-запрос с перечислением необходимых параметров и токена, полученного в пункте 1. В течение 20 минут данные будут записаны в счетчик.
