---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/metrika/en/data-import/measurement-about.md
  - https://yandex.com/dev/metrika/ru/data-import/measurement-about.md
  - href: ru/data-import/measurement-about.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/metrika/ru/llms.txt

# Использование Measurement Protocol

Measurement Protocol — API для отправки данных о взаимодействиях пользователей напрямую на сервера Метрики через HTTP-запросы. Он расширяет возможности стандартного веб-счетчика, позволяя передавать дополнительные данные о визитах и действиях пользователей.

{% note info %}

Measurement Protocol рекомендуется использовать в дополнение к автоматическому сбору данных с веб-счетчика Метрики, а не вместо него.

{% endnote %}

## Применение {#use}

#### Объединение данных

Дополнение данных счетчика Метрики информацией о взаимодействиях, которые нельзя зафиксировать через веб-счетчик (например, данные с серверной стороны).

#### Отправка серверных данных

Передача данных с серверной стороны, когда клиентский сбор ограничен (например, из-за блокировщиков рекламы).

#### Передача данных электронной коммерции

Прямая отправка данных о событиях электронной коммерции (покупки, корзины), если клиентский сбор невозможен.

Данные, отправляемые через API:
- Посещения страниц
- Javascript-события
- События электронной коммерции
- Параметры визитов

## Ограничения {#restrictions}

#### Создание новых визитов c помощью открывающего события `pageview`

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

#### Ограничение по времени на дополнение визитов

Дополнять визиты можно только в течение 12 часов после их завершения, отправив для событий время, попадающее в тайм-аут визита, указанное в настройках счетчика. Если требуется передать данные для более старых визитов, используйте передачу офлайн-данных. Единственный способ записать данные через Measurement Protocol для пользователей, чьи визиты завершились более 12 часов назад, — это создать новый визит с нужным `ClientID` и добавить в него необходимые события, которые будут связаны с этим пользователем.

![alt](../../_images/graph1-ru.png =750x)

#### Постепенная доступность `ClientID` для обогащения истории

После включения опции Measurement Protocol Метрика начинает постепенно запоминать по `ClientID` историю пользователей, посещавших сайт, для возможности дальнейшего обогащения их истории новыми визитами через Measurement Protocol. Этот процесс происходит постепенно: сначала доступны `ClientID` за один день после включения фичи, затем за два, три и так далее, пока не будет достигнут 21 день. После этого самые старые данные удаляются, и сохраняется актуальная информация о `ClientID` за последний 21 день. Если визит пользователя произошел более 21 дня назад, невозможно продолжить его историю — будет создан новый пользователь с новым визитом.

![alt](../../_images/graph2-ru.png =750x)

## Настройка передачи данных {#config}

1. Активируйте Measurement Protocol в настройках.

   Включите опцию в интерфейсе или API Метрики, получите авторизационный токен. [Подробнее](https://yandex.com/dev/metrika/ru/data-import/manage-protocol.md) про управление опцией и токенами через API.
2. Сохраните `ClientID`.

   Сохраните идентификатор `ClientID` на своем сервере для последующей отправки данных.
3. Отправьте запрос.

   Отправьте POST- или GET-запрос на `https://mc.yandex.ru/collect` с параметрами и токеном. [Подробнее](https://yandex.com/dev/metrika/ru/data-import/measurement-upload.md) про загрузку данных.