--- metadata: - name: generator content: Diplodoc Platform v5.48.2 alternate: - https://yandex.com.tr/dev/metrika/en/data-import/measurement-upload.md - https://yandex.com.tr/dev/metrika/ru/data-import/measurement-upload.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/ru/llms.txt # Загрузка данных Передача данных осуществляется на url `https://mc.yandex.ru/collect` POST|GET-запросами. Каждый параметр в запросе представляет собой пару `ключ=значение`. Есть обязательные параметры, которые зависят от типа взаимодействия, и дополнительные параметры, расширяющие возможности аналитики переданных данных. Все значения параметров должны быть URL-кодированы и закодированы в формате UTF-8 (см. [пример передачи просмотра](#examples)). ## Поддерживаемые параметры {#parameters} #| || **Параметр** | **Описание** | **Комментарий** || || `tid` | Номер счетчика | Обязательный || || `cid` | Идентификатор клиента `ClientID` | Обязательный || || `t` | Тип взаимодействия. Возможные значения: - `pageview` — просмотр страницы - `event` — Javascript-событие, ecommerce-события | Обязательный || || `dr` | Реферер | Обязательный для события `pageview` || || `dl` | Url страницы | Обязательный для события `pageview`, а также для любого события `event`, если включена опция «Принимать данные только с указанных адресов» || || `dt` | Заголовок страницы | Обязательный для события `pageview` || || `ea` | Цели | Обязательный для события `event` || || `params` | Параметры визита | Отправляются вместе с событиями `pageview` или `event`. На передачу действуют [ограничения](https://yandex.ru/support/metrica/general/limits.html#limits__param) || || `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` || || `prid` | Ecom код товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prnm` | Ecom название товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prbr` | Ecom бренд товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prca` | Ecom категория товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prpr` | Ecom цена товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prqt` | Ecom количество единиц товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prva` | Ecom разновидность товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prcc` | Ecom код купона товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `prps` | Ecom позиция товара | Обязательный для события `event` и `pa!=null`. В `productIndex` указывать порядковый номер товара в списке || || `sr` | Размер окна | Формат для значения параметра: `1440x900x30` || || `cu` | Валюта | Поддерживается для целей с ценностью и для ecom-событий || || `ev` | Ценность цели | Поддерживается при передаче целей || || `ms` | Секретный токен | Генерируется при включении опции Measurement Protocol || |# ## Примеры передачи данных {#examples} #### Отправка просмотра ```http translate=no 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 ```http translate=no 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-цели с параметрами визита ```http translate=no https://mc.yandex.ru/collect/?tid=5564333&cid=1710232430899999999&t=event&ea=order-success¶ms={"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 ```http translate=no 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 ``` #### Добавление товара в корзину ```http translate=no 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 ``` #### Покупка товара ```http translate=no 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 ``` #### Покупка нескольких товаров ```http translate=no 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 ``` ## Особенности {#nuance} - Через Measurement Protocol можно создать визит, либо дополнить существующий визит. - Для создания визита нужно обязательно указать `ClientID` пользователя. - Для формирования визита нужно передать как минимум один просмотр страницы (`t=pageview`) в начале визита. - Визиты формируются по тем же правилам и ограничениям, что и обычные визиты. - Данные можно отправить максимум на 12 часов назад от текущего времени. Если не отправлять параметр `et` — будет указано время отправки данных. - Обновить визит можно только в рамках тайм-аута визита, указанного в настройках счетчика, используя параметр `et` или отправляя данные без этого параметра в пределах тайм-аута визита. Если выйти за тайм-аут — начнется новый визит (после отправки `pageview`).