Загрузка данных

Передача данных осуществляется на url https://mc.yandex.ru/collect POST|GET-запросами. Каждый параметр в запросе представляет собой пару ключ=значение. Есть обязательные параметры, которые зависят от типа взаимодействия, и дополнительные параметры, расширяющие возможности аналитики переданных данных. Все значения параметров должны быть URL-кодированы и закодированы в формате UTF-8 (см. пример передачи просмотра).

Поддерживаемые параметры

Параметр	Описание	Комментарий
`tid`	Номер счетчика	Обязательный
`cid`	Идентификатор клиента `ClientID`	Обязательный
`t`	Тип взаимодействия. Возможные значения: `pageview` — просмотр страницы `event` — Javascript-событие, ecommerce-события	Обязательный
`dr`	Реферер	Обязательный для события `pageview`
`dl`	Url страницы	Обязательный для события `pageview`, а также для любого события `event`, если включена опция «Принимать данные только с указанных адресов»
`dt`	Заголовок страницы	Обязательный для события `pageview`
`ea`	Цели	Обязательный для события `event`
`params`	Параметры визита	Отправляются вместе с событиями `pageview` или `event`. На передачу действуют ограничения
`ti`	Ecom транзакция	Обязательный для события `event` и `pa=purchase`
`tr`	Ecom доход транзакции	Обязательный для события `event` и `pa=purchase`
`tcc`	Ecom купон транзации	Обязательный для события `event` и `pa=purchase`
`et`	Время события в Timestamp	Если не передан — будет использовано время отправки данных. Допускается не более 12 часов назад от текущего времени.
`pa`	Ecom действие с товаром (расширенный ecom). Возможные значения: `detail` — просмотр информации `add` — добавление в корзину `remove` — удаление из корзины `purchase` — покупка	Обязательный для события `event`
`pr<productIndex>id`	Ecom код товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>nm`	Ecom название товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>br`	Ecom бренд товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>ca`	Ecom категория товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>pr`	Ecom цена товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>qt`	Ecom количество единиц товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>va`	Ecom разновидность товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>cc`	Ecom код купона товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`pr<productIndex>ps`	Ecom позиция товара	Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке
`sr`	Размер окна	Формат для значения параметра: `1440x900x30`
`cu`	Валюта	Поддерживается для целей с ценностью и для ecom-событий
`ev`	Ценность цели	Поддерживается при передаче целей
`ms`	Секретный токен	Генерируется при включении опции Measurement Protocol

Примеры передачи данных

Отправка просмотра

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=pageview&dr=https%3A%2F%2Fyandex.ru&dl=https%3A%2F%2Ftest.com&dt=Test&et=1632467908&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Достижение js-цели order-success

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&ea=order-success&et=1632467909&dl=https%3A%2F%2Ftest.com&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Достижение js-цели с параметрами визита

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&ea=order-success&params={"level1_1":{"level2_1":{"level3_1":"example1","level3_2":"example2"}}}&et=1632467909&dl=https%3A%2F%2Ftest.com&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Просмотр карточки товара Apple iPhone стоимостью 50000 с SKU 456

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&et=1632467910&pa=detail&pr1id=456&pr1nm=iphone&pr1br=apple&pr1pr=50000&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Добавление товара в корзину

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&et=1632467911&pa=add&pr1id=456&pr1nm=iphone&pr1br=apple&pr1pr=50000&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Покупка товара

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&et=1632467912&pa=purchase&pr1id=456&pr1nm=iphone&pr1br=apple&pr1pr=50000&ti=4555&tr=50000&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Покупка нескольких товаров

https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&et=1632467913&pa=purchase&pr1id=456&pr1nm=iphone&pr1br=apple&pr1pr=50000&pr2id=459&pr2nm=airpods&pr2br=apple&pr2pr=20000&ti=4555&tr=70000&ms=01c0a669-d38c-4385-9d22-47cf894ed687

Особенности

Через Measurement Protocol можно создать визит, либо дополнить существующий визит.
Для создания визита нужно обязательно указать ClientID пользователя.
Для формирования визита нужно передать как минимум один просмотр страницы (t=pageview) в начале визита.
Визиты формируются по тем же правилам и ограничениям, что и обычные визиты.
Данные можно отправить максимум на 12 часов назад от текущего времени. Если не отправлять параметр et — будет указано время отправки данных.
Обновить визит можно только в рамках тайм-аута визита, указанного в настройках счетчика, используя параметр et или отправляя данные без этого параметра в пределах тайм-аута визита. Если выйти за тайм-аут — начнется новый визит (после отправки pageview).

Была ли статья полезна?

Управление опцией и токенами

Генерация дополнительных токенов