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