Инструкция по настройке

Метрика+ CDP для МойСклад · версия 1.1 · обновлено 15 мая 2026

1. Что делает решение

«Метрика+ CDP для МойСклад» — серверное решение для МойСклад. Автоматически передаёт заказы и контакты клиентов из вашего аккаунта МойСклад в Яндекс.Метрика CDP, считает реальную окупаемость рекламы с учётом расходов из Яндекс.Директ, Google Ads и Яндекс.Промостраниц. В индустрии эту метрику называют ROAS или ROMI — мы используем «окупаемость рекламы» как более понятный для бизнеса термин.

Ключевые возможности:

• Передача заказов в Метрику в реальном времени через уведомления (webhook) МС.
• Автоматическое сопоставление статусов заказов МС с типами Метрики (PAID / IN_PROGRESS / CANCELLED / SPAM).
• Расчёт маржинальной аналитики через FIFO-себестоимость МС (то же что в нативном МС-отчёте «Прибыль» — берёт реальные приёмки товара, а не справочное поле buyPrice).
• Сегментация клиентов по выручке и истории покупок для похожих аудиторий в Яндекс.Аудиториях.
• Поддержка нескольких регионов: Россия, Казахстан, ОАЭ, Беларусь, Украина, Узбекистан.

1.1 Что критично для полноценной работы

По убыванию важности. Все пункты этого списка работают без программистов и без правок кода сайта — это устанавливается через UI в МС, Метрике или нашем виджете. Скрипты на сайте (см. §7) — отдельная история про улучшение качества матчинга, а не про базовую работоспособность.

2. Установка (3 минуты)

3. Подключение Яндекс.Метрики

1. На первом экране мастера нажмите «Подключить Метрику через OAuth».
2. Откроется окно Яндекс.OAuth — авторизуйтесь под аккаунтом, у которого есть доступ к нужному счётчику Метрики.
3. Дайте решению запрашиваемые права. Запрашиваются 6 scope:
   • metrika:read — чтение счётчиков и статистики
   • metrika:segments — создание/удаление API-сегментов для ретаргетинга
   • metrika:write — создание целей (внутри схемы CDP-статусов)
   • metrika:offline_data — загрузка заказов и контактов в CDP
   • metrika:expenses — чтение расходов из коннекторов Метрики
   • metrika:user_params — параметры визита для расширенной CRM-сегментации
4. После авторизации мастер автоматически вернётся к настройке. Если у вас один счётчик — он будет выбран автоматически. Если несколько — выберите нужный.

4. Сопоставление статусов

На втором шаге мастера решение автоматически загружает статусы заказов из вашего МойСклад и сопоставляет их с 5 типами статусов Метрики:

• PAID — Оплачен (заказ выполнен и деньги получены).
• IN_PROGRESS — В работе.
• CANCELLED — Отменён.
• SPAM — Спам, неполноценный лид.
• OTHER — Другой тип.

Автомаппинг работает по ключевым словам в названии статуса (например, «оплачен», «выдан клиенту» попадают в PAID; «отменён», «не оплачен» — в CANCELLED). Если результат вас устраивает, нажмите «Принять». Если хотите поправить — это можно сделать позже в разделе «Статусы».

5. Подключение источников расходов

Для расчёта окупаемости рекламы нужно подтянуть расходы рекламных кабинетов. Есть два пути — рекомендуемый через коннекторы Яндекс.Метрики, и резервный через прямой OAuth к рекламному аккаунту.

5.1 Расходы через коннекторы Метрики (рекомендуемый путь)

У Яндекс.Метрики есть встроенные коннекторы, которые сами тянут расходы из рекламных кабинетов и показывают их в отчёте «Источники → Сводка». Никаких токенов передавать нашему сервису не нужно — мы просто читаем уже собранные Метрикой данные.

Доступные коннекторы расходов в Метрике:

• Яндекс.Директ — нативно (включая Поиск, РСЯ, Бизнес)
• Google Ads (Search + Display) — нативно
• VK Реклама (ex-myTarget) — через бесплатный коннектор Albato (доступен из интерфейса Метрики)
• ВКонтакте (старый кабинет) — через Albato
• myTarget — через Albato
• Meta Ads (Facebook/Instagram) — через сторонний коннектор^*

^* Meta Platforms (Facebook, Instagram) признана экстремистской и запрещена на территории Российской Федерации (Решение Тверского районного суда г. Москвы от 21.03.2022). Подключение Meta-коннектора имеет смысл только для зарубежных кабинетов (AE / KZ / BY / UZ / другие).

Актуальный список коннекторов смотрите на странице «Источники, расходы и ROI» в Метрике — Яндекс периодически добавляет новые платформы.

Как настроить (1 раз на счётчик):

1. В виджете откройте Настройки → Подключения. У каждого подключённого счётчика в блоке «💰 Расходы рекламы → 🪙 Метрика-коннектор» нажмите кнопку с номером счётчика — откроется страница «Источники расходов» в Метрике.
2. Авторизуйтесь Яндекс-аккаунтом владельца кабинета Директа.
3. Для каждого нужного источника (Директ / Google Ads / VK / FB / myTarget) нажмите «Подключить» и подтвердите OAuth.
4. Метрика начнёт собирать расходы ежедневно автоматически. Первые данные появятся через 4–24 часа.
5. В нашем виджете ничего настраивать не нужно — мы каждые 6 часов автоматически синхронизируем эти данные. Кнопка «Обновить за 30 дней» в том же блоке дёрнет данные вручную.

5.2 Яндекс.Директ — автоматически через Метрику

Direct грузится автоматически через Метрика-токен (ym:ad:RUBConvertedAdCost + auto-discovery direct_client_logins). Отдельный OAuth Direct не нужен.

1. В Настройках → Подключения → конкретный счётчик → блок «💰 Расходы рекламы» → секция «🎯 Яндекс.Директ для этого счётчика».
2. Логин определяется автоматически по привязке Direct в Метрика-UI. Если нужно вручную — кнопка «Изменить логин».
3. Кнопка «Обновить расходы Директа» подтягивает данные за 30 дней.

5.3 Яндекс.Промостраницы

Промостраницы Метрика не тянет через коннекторы — мы сами грузим расходы в Метрика-счётчик через /management/v1/counter/{id}/expense/upload под нашим backend.

1. В Настройках → Подключения → конкретный счётчик → блок «💰 Расходы рекламы» → секция «📰 Яндекс.Промостраницы».
2. Кнопка «Подключить Яндекс.Промостраницы» — OAuth под аккаунтом с правами в Промо-редакции.
3. «Залить расходы (7 дней)» запускает асинхронную загрузку — данные появятся в Метрика-отчётах как источник yandex.promopages через ~30 минут.
4. Автозагрузка раз в 6 часов после первого ручного клика.

5.4 Холдинг с несколькими счётчиками (RU/AE/KZ и т.п.)

Каждый счётчик настраивается per-connection в блоке «Настройки → Подключения». В одном Яндекс-аккаунте может быть несколько счётчиков; кнопка «+ Счётчик» в шапке карточки паспорта добавляет ещё.

6. Что показывает панель аналитики

Раздел «Аналитика»

Основные KPI за выбранный период (7/30/90 дней): выручка, окупаемость рекламы, средний чек, конверсия заявка → оплата. Под графиком — журнал последних выгрузок в Метрику.

Раздел «Источники»

Таблица по каждой рекламной кампании с показателями: количество заказов, выручка, расход на рекламу, маржа (выручка − закупочная цена), прибыль, окупаемость рекламы и прибыль на рубль рекламы. Сортировка по любой колонке.

Раздел «Воронка»

Распределение заказов по 5 типам статусов Метрики и топ-30 ваших статусов МС с долей. Помогает увидеть, где теряются деньги в воронке продаж.

Раздел «Аудитории»

Создание аудиторий для ретаргетинга в Директе. Кнопка «Создать недостающие» разворачивает 7 типовых шаблонов в Метрике (Все CDP-заказы / Оплачено / Отмена / Прочие / Средний чек / Выручка / Прибыль). Кнопка «+ Свой сегмент» открывает билдер с 7 параметрами и 7 операторами (= ≠ > ≥ < ≤ диапазон) для произвольных порогов в валюте счётчика. Важно: Direct показывает аудиторию в селекторе только когда в ней накопилось ≥ 100 уникальных посетителей за 90 дней. До этого порога аудитория создана и видна у нас, но в Direct её не будет. После создания аудитории автоматически появляются в Direct → Условия подбора аудитории (с задержкой 5–30 мин на синхронизацию Direct).

Раздел «Статусы»

Таблица сопоставления статусов МС с типами Метрики — можно править вручную. В нижней части страницы свёрнут блок «Фильтр сотрудников и менеджеров (по email-домену)» — туда можно добавить домены, заказы с которых не должны передавать ПДн клиентов в Метрику.

Раздел «Инструкция»

Эта страница в краткой форме — внутри виджета. Описывает основные сценарии настройки.

Раздел «Настройки»

Per-connection архитектура: один Яндекс-аккаунт может иметь несколько счётчиков (RU/AE/KZ и т.п.). Каждая карточка счётчика содержит блок «💰 Расходы рекламы» (3 подсекции: 🪙 Метрика-коннектор, 🎯 Яндекс.Директ, 📰 Яндекс.Промостраницы), блок «🌍 Регион» (автоматически определяет НДС и валюту), а также секции каналов продаж/юр.лиц/расширенных настроек. Кнопка «Удалить ВСЕ данные» в самом низу — необратимое действие.

7. Как увеличить % сопоставления ClientID (главное)

ClientID Метрики — это строка цифр вида 1778784550496063444 (19 цифр, превышает Number.MAX_SAFE_INTEGER — храните как строку, иначе JS округлит последние цифры и Метрика не свяжет заказ с визитом), идентификатор посетителя сайта, который Метрика выдаёт каждому пользователю при первом визите и хранит в cookie _ym_uid. Чтобы Метрика смогла построить связку «визит → оплата» и посчитать честную окупаемость рекламы, нам нужно знать ClientID для каждого заказа в МС.

Решение пытается найти ClientID четырьмя путями (от самого надёжного к best-effort):

1. В кастомном атрибуте заказа — самый надёжный.
2. В кастомном атрибуте контрагента — для повторных покупок.
3. Через purchase_id — обратный запрос в Метрику по номеру заказа.
4. Через хеш телефона/email — если в Метрике включены «Дополнительные настройки отслеживания» + «Запоминать маскированные данные» либо на сайте вызывается ym(N, 'firstPartyParams', ...).

7.1 На сайте: добавьте скрытое поле yandex_client_id

Самый эффективный способ. В формы заказа на сайте добавьте скрытое поле, которое автоматически заполняется ClientID-ом из Метрики. Это поле должно попадать в МС вместе с заказом (через API JSON или интеграцию вашего сайта с МС).

Вставьте этот код в <head> сайта (после кода счётчика Метрики):

<script>
// Получаем ClientID Метрики и кладём во все формы сайта
(function() {
  var COUNTER_ID = 12345678; // ваш номер счётчика
  function setClientId(cid) {
    document.querySelectorAll('form').forEach(function(form) {
      var input = form.querySelector('input[name="yandex_client_id"]');
      if (!input) {
        input = document.createElement('input');
        input.type = 'hidden';
        input.name = 'yandex_client_id';
        form.appendChild(input);
      }
      input.value = cid;
    });
  }
  function tryGet() {
    if (typeof ym === 'function') {
      ym(COUNTER_ID, 'getClientID', setClientId);
    } else {
      setTimeout(tryGet, 300);
    }
  }
  tryGet();
})();
</script>

ym(COUNTER_ID, 'userParams', {
  UserID: 12345,
  vip_status: true,
  segment: 'b2b'
});

7.2 По типу CMS — где поправить шаблон

7.3 amoCRM — что прокинуть в поле заказа

В amoCRM нет стандартного поля для ClientID — его нужно создать самостоятельно. Подробное руководство Яндекса по интеграции: yandex.ru/support/metrica/ru/crm/amocrm.

1. В amoCRM откройте «Настройки → Поля → Сделки» (или «Контакты»)
2. Создайте новое поле — название произвольное, рекомендуем yandex_client_id или ClientID Метрики (тип «Короткий текст»). Запомните технический id поля (например cf123456)
3. В JS-формах вашего сайта добавьте скрытое поле и пробросьте его в API создания сделки amoCRM через параметр custom_fields_values[] с указанным id и значением из ym(COUNTER_ID, 'getClientID', cb)
4. В интеграции amoCRM → МойСклад настройте перенос этого поля сделки в кастомный атрибут заказа МС — название атрибута в МС должно совпадать с одним из распознаваемых (yandex_client_id, ClientID Метрики и т.п.)

7.4 Bitrix24 — настройка сквозной аналитики

В Bitrix24 готового поля для ClientID Метрики нет — нужно создать кастомное поле сделки и настроить передачу _ym_uid через сайт-CRM-форму или REST API. См. инструкцию Яндекса по интеграции с Битрикс24: yandex.ru/support/metrica/ru/crm/bitrix.

1. В Bitrix24 откройте «CRM → Настройки → Сделки → Пользовательские поля» и создайте поле «ClientID Метрики» (тип «Строка»). Запомните его UF-имя
2. В формах сайта (Bitrix24.Sites или встроенная CRM-форма) добавьте скрытое поле с указанным UF-именем и в JS заполняйте его значением из ym(COUNTER_ID, 'getClientID', cb)
3. В интеграции Bitrix24 → МойСклад настройте сопоставление UF-поля сделки с кастомным атрибутом заказа МС (рекомендуемое имя в МС: yandex_client_id или ClientID Метрики)

7.5 Телефония — какое поле от провайдера прокинуть в МС

Если клиент звонит вам через виртуальную АТС с коллтрекингом, провайдер уже знает ClientID Метрики посетителя на сайте (из своего скрипта на сайте). Решение поддерживает 9 провайдеров по умолчанию. Просто положите идентификатор сессии в атрибут заказа.

7.6 Чаты на сайте — какое поле прокинуть

7.7 Авто-обогащение карточки заказа МС

Решение автоматически заполняет 3 поля в карточке заказа МС: ClientID Метрики, Источник заказа, Кампания — и 2 в карточке контрагента: ClientID Метрики, Первый источник. Менеджер открывает заказ и сразу видит откуда пришёл клиент.

Четыре пути связки заказа с визитом

7.8 Сопоставление по purchase_id из e-commerce

Альтернативный путь сопоставления — через purchaseID цели «покупка» в Метрике. Если на сайте срабатывает цель E-commerce purchase с уникальным идентификатором заказа, и этот же ID есть в номере заказа МС — мы сопоставим автоматически.

На сайте при подтверждении заказа — рекомендованный способ через E-commerce dataLayer (официальная дока Яндекса):

window.dataLayer = window.dataLayer || [];
dataLayer.push({
  ecommerce: {
    purchase: {
      actionField: {
        id: '12345',            // ← это попадёт в purchase_id Метрики
        revenue: 5400,
        // currency, coupon, shipping — опционально
      },
      products: [/* ... */],
    },
  },
});

Альтернатива через reachGoal (legacy, если e-commerce dataLayer недоступен):

ym(COUNTER_ID, 'reachGoal', 'purchase', {
  order_id: '12345',           // ← попадёт в purchase_id
  order_price: 5400,           // ← поле называется order_price, не order_revenue
});

В виджете в «Настройки → Расширенные → Сопоставление заказов с purchaseID» выберите режим:

• Только цифры из имени заказа — если на сайте передаёте 12345, а в МС заказ называется «Заказ покупателя 12345 от 15.05.2026»
• Имя заказа целиком — если совпадение точное
• UUID заказа из МС — если сайт пишет UUID в Метрику
• Из кастомного атрибута заказа — самый гибкий: указываете имя атрибута, в нём лежит purchase_id, который сайт отправляет в Метрику
• Шаблон {number} / {any} — например, Gri_{number} для номеров вида Gri_55321

7.9 RetailCRM — нативная связка с Метрикой

RetailCRM из коробки сохраняет _ym_uid посетителя в кастомное поле сделки/клиента, если на сайте установлен Tracker RetailCRM. Также штатно интегрируется с Roistat и коллтрекинг-сервисами. Перенос в МС — настраивается в разделе «Интеграции → МойСклад» вашей RetailCRM.

1. В RetailCRM откройте «Настройки → Дополнительные поля → Заказы». Найдите поле, где сохраняется _ym_uid (обычно ya_client_id или yandex_client_id). Если поле не создано — создайте «Короткий текст» с именем yandex_client_id.
2. Убедитесь что RetailCRM Tracker подключён на сайте — он сам ловит ClientID Метрики и пишет в это поле при создании заказа.
3. В интеграции «RetailCRM ↔ МойСклад» (раздел «Интеграции» в RetailCRM) включите трансфер этого кастомного поля в атрибут заказа МС с именем yandex_client_id или ClientID Метрики.
4. Готово — все заказы, синхронизированные в МС, будут содержать ClientID; виджет подхватит его автоматически.

7.10 Мессенджеры — WhatsApp, Telegram, MAX

Если значимая часть заказов приходит через мессенджеры, ClientID нужно прокинуть при первом контакте через параметризованную прямую ссылку (deep-link) с вашего сайта. После этого все сообщения и заказы клиента в этом мессенджере будут привязаны к ClientID.

WhatsApp

Если вы используете Wazzup24, Chat2Desk, Wassenger, Texterra или другой WABA-сервис — они принимают первое сообщение через wa.me-ссылку и сохраняют UTM/параметры на карточке клиента. Передавайте ClientID в utm_content или в тексте первого сообщения:

<a id="wa-link" href="https://wa.me/79991234567?text=Здравствуйте">Написать в WhatsApp</a>

<script>
ym(COUNTER_ID, 'getClientID', function(cid) {
  var a = document.getElementById('wa-link');
  if (a) a.href += encodeURIComponent(' (cid:' + cid + ')');
});
</script>

В Wazzup24/RetailCRM/Bitrix24 этот текст сохраняется на сделке. В интеграции с МС перенесите его в кастомный атрибут заказа с именем yandex_client_id. Холодные WhatsApp-обращения (звонок без визита на сайт) матчатся только через Крипту или phone_md5.

Telegram

Telegram-бот (и платформы BotHelp, TextBack, ManyChat, Salebot) поддерживает ?start=PARAM в прямой ссылке. Бот получает параметр в первом сообщении и сохраняет на пользователе.

<a id="tg-link" href="https://t.me/yourbot?start=ANON">Написать в Telegram</a>

<script>
ym(COUNTER_ID, 'getClientID', function(cid) {
  var a = document.getElementById('tg-link');
  if (a) a.href = a.href.replace('?start=ANON', '?start=ym_' + cid);
});
</script>

В BotHelp/TextBack/ManyChat значение из ?start= сохраняется как параметр пользователя — точное имя переменной зависит от платформы (BotHelp использует start_param; в ManyChat это «User Refs»; уточните в текущей документации вашего сервиса). При оформлении заказа в МС из бота — пишите его в кастомное поле заказа.

MAX (мессенджер VK)

MAX поддерживает аналогичную прямую ссылку: https://max.ru/your_bot?start=ym_<cid>. Принцип и реализация — как у Telegram (см. фрагмент выше, замените домен).

Для MAX Mini Apps (мини-приложения внутри мессенджера): используйте JS SDK МАХ, получите идентификатор пользователя и передайте на сервер вместе с ClientID, который вы прокидываете в параметре запуска.

7.11 Как проверить что % сопоставления растёт

1. После настройки создайте тестовый заказ на сайте
2. Через 1–2 минуты в МС найдите этот заказ — в атрибуте «ClientID Метрики» должно быть число вроде 1748503210892
3. Через 30 минут в Метрике → «Посетители → Управление заказами» найдите этот заказ по purchase_id или uniq_id клиента
4. В карточке заказа должен быть привязан visit_id — это значит ClientID сматчился

7.12 Measurement Protocol — server-side обогащение визитов (продвинутый)

Если у вас есть кейсы где веб-счётчик не видит данные (блокировщики рекламы, эквайринг без redirect назад на «спасибо за заказ», server-side events) — Метрика поддерживает Measurement Protocol: отправка событий напрямую с вашего сервера в mc.yandex.ru/collect по HTTP.

Что можно отправить:

• Просмотры страниц (даже без кода Метрики)
• JavaScript-цели (reachGoal)
• События электронной коммерции (просмотр товара, покупка, корзина)
• Параметры визитов

Как включить:

1. В Метрике → Настройки → Безопасность и использование данных → включите опцию «Measurement Protocol». Будет сгенерирован OAuth-токен (до 5 токенов на счётчик).
2. На своём сервере запомните ClientID пользователя (берётся через ym(N, 'getClientID', cb) во время визита и сохраняется в БД для последующей отправки).
3. Отправляйте POST/GET-запросы на https://mc.yandex.ru/collect?tid=<counter_id>&cid=<clientID>&... с авторизационным токеном. Данные появятся в Метрике через ~20 минут.

Подробности — официальная документация Yandex Metrika Measurement Protocol. Наш сервис эту фичу не использует (мы шлём CDP-данные через `/data/contacts/json` и `/data/orders/json`), но если у вас есть собственный backend для специфических кейсов — это альтернативный канал.

8. Расширенные настройки

8.1 Модель атрибуции

По какой модели Метрика связывает заказы с источниками трафика и считает окупаемость и прибыль на рубль. Выбирается в «Настройки → Расширенные → Модель атрибуции».

8.2 Прочие расширенные настройки

9. Решение проблем

Заказы не передаются в Метрику

1. Проверьте раздел «Аналитика» → «Журнал выгрузок». Если статусы «PASSED» — данные передаются, ищите в Метрике через сутки (агрегаты обновляются с задержкой).
2. Если статусы «FAILED» — обычно причина в неподтверждённой OAuth-сессии Метрики. В разделе «Настройки» нажмите «Переподключить».
3. Если журнал пустой — проверьте что webhook-и зарегистрированы (это происходит автоматически при установке).

Окупаемость = 0 (нет данных)

1. Подождите 1 час после подключения рекламного кабинета — нужна первая синхронизация расходов.
2. Проверьте что в Метрике есть UTM-метки заказов — без них невозможно сопоставить заказ с кампанией.
3. Убедитесь что номера заказов в МС попадают в Метрику как purchaseID при срабатывании цели «покупка» на сайте.

Маржа = выручке (закупочная цена не учитывается)

В МС должны быть проведены приёмки товаров с указанной закупочной ценой — себестоимость рассчитывается по методу FIFO от реальных партий приёмок (так же как в нативном МС-отчёте «Прибыль»). Поле «Закупочная цена» в карточке товара само по себе на расчёт не влияет (это справочное значение для подстановки при создании Приёмки). Если у товара никогда не было приёмок — себестоимость = 0, и маржа = выручке. Решение: создайте Приёмку с фактическими закупочными ценами; следующая синхронизация подтянет реальный COGS.

Хочу отключить решение

В разделе «Настройки» → раскройте карточку Яндекс-аккаунта → удалите подключение Метрики (или отключите Промостраницы внутри блока «Расходы рекламы»). Webhook-и в МС остановятся автоматически. Удаление приложения через интерфейс МС не требуется.

10. Тарифы и оплата

Решение предоставляется по подписке через биллинг МойСклад. После 7-дневного пробного периода оплата производится ежемесячно. Скидки за длительные периоды — на странице решения в каталоге МойСклад.

Подробное описание и оплата — на странице решения в каталоге МойСклад.

11. Поддержка

• Telegram (быстрее всего): @etokrutobot — напишите боту, мы получим уведомление и ответим
• Email: support@etokruto.ru
• Документация: metrika.etokruto.ru/help
• Политика обработки ПДн: metrika.etokruto.ru/privacy

Время ответа на запросы: до 48 часов в рабочие дни (для тарифов «Старт» и «Бизнес»), до 24 часов («Премиум»).