Оформление

RetailCRM

В меню: Настройки → Интеграции → RetailCRM.

RetailCRM — источник заказов, статусов и справочников для целей Sales Ninja. Интеграция только читает данные; цели после подключения создаются вручную.

Уровни интеграции ​

УровеньДоступноГде настраивается
Project✅Настройки → Интеграции → RetailCRM
JS-действие——

Зачем подключать ​

  • Передавать в Sales Ninja реальные заказы и статусы из RetailCRM.
  • Строить цели по статусам / сайтам / полям и использовать их в моделируемых конверсиях.
  • Не зависеть от ручных выгрузок, если заказы уже живут в RetailCRM.

Подготовьте доступ ​

  1. Попросите администратора RetailCRM создать ключ в разделе «Администрирование → Интеграция → Ключи доступа к API».
  2. Разрешите чтение заказов, справочников и пользовательских полей — точные коды указаны ниже. В доступе ключа выберите все магазины, из которых нужны заказы. Права на изменение заказов для этого подключения не требуются.
  3. Скопируйте адрес своего кабинета RetailCRM и API-ключ. Используйте адрес кабинета целиком, без пути к отдельному заказу или методу API.

order_read — чтение заказов; reference_read — чтение справочников; custom_fields_read — чтение пользовательских полей.

Данные подключения ​

Откройте Настройки проекта → Интеграции → Добавить, выберите сервис и задайте понятное название подключения.

ПолеЧто вставить
Адрес RetailCRMАдрес вашего кабинета, например https://example.retailcrm.ru, без /api/ и пути к заказу.
API-токенКлюч с правами чтения и доступом к нужным магазинам.

Нажмите Сохранить. При редактировании оставьте скрытый сохранённый секрет без изменений, если не хотите заменить его.

После сохранения ​

После проверки и сохранения обновите справочники в карточке подключения. Затем создайте цель RetailCRM, выберите магазины и статусы заказов, настройте поля для связи с посещениями. Сохранение ключа само по себе не создаёт цели.

Если подключение не работает ​

Заказы могут быть недоступны из-за списка магазинов в ключе. Если нет статусов или пользовательских полей, проверьте права чтения справочников и полей, затем обновите справочники подключения.

Инструкции сервиса ​

Цель RetailCRM ​

  1. Откройте Данные → Цели → Создать → Звонки и CRM → RetailCRM и выберите подключение.
  2. Обновите каталог и задайте нужные фильтры. Пустые фильтры не ограничивают заказы; для цели «Оплаченный заказ» явно выберите соответствующие статусы.
ФильтрЧто отбирает
СайтыЗаказы нужного магазина или сайта
Статусы заказовФинальные или квалифицирующие статусы
Способы оформления / типы заказовНужные каналы и виды заказов
Типы доставкиЗаказы с выбранной доставкой
Статусы / типы оплатыЗаказы с нужными условиями оплаты
  1. В Выручка выберите Итоговая сумма заказа, Сумма заказа, Закупочная сумма или Не передавать. Это разные суммы; закупочная сумма не является готовой прибылью.
  2. Если известна прибыль заказа, выберите её поле в Прибыль. Передавайте готовую сумму в валюте выручки; убыток может быть отрицательным.
  3. Проверьте поля yclid и Yandex Client ID и при необходимости настройте UTM-поля. Убедитесь, что выбранные пользовательские поля реально заполнены. Если список полей недоступен, проверьте разрешение custom_fields_read и обновите каталог.
  4. Сохраните, дождитесь синхронизации и сравните конверсии с заказами источника: статусы, выбранный сайт и суммы должны совпадать с вашей задачей.

Несколько равнозначных статусов могут быть фильтром одной цели. Разные этапы, например оформление и покупка, измеряйте отдельно, если нужен путь клиента.

Общие настройки: выручка и прибыль. Далее: от интеграции к цели.

Ограничения и типичные ошибки ​

СимптомЧто проверить
Ошибка авторизацииАдрес кабинета, формат токена, права order_read
Каталог пустой / коды вместо названийreference_read, custom_fields_read, повторная синхронизация
Заказы есть, матча нетyclid / Client ID в заказе или клиенте
Цель без нужных статусовКаталог устарел — «Синхронизировать каталог»

Sales Ninja не пишет в RetailCRM и не меняет заказы.

Связано ​