Интеграция Roistat с retailCRM¶
Интеграция CRM retailCRM с Roistat. Как настроить отправку заявок в CRM через Roistat и загрузку из CRM контактов клиентов, выручки по заказу и себестоимости заказов.
Внимание!
Перед интеграцией необходимо установить счетчик Roistat!
Как работает интеграция¶
Отправка заявок в CRM¶
Если заявка не была помечена как дубль, то:
- Осуществляется поиск контактов (по всем контактам в CRM-системе) по номеру телефона или email-адресу.
- Если контакт найден, то создается привязанная к нему новая сделка. Если контакт не найден, создается новый контакт и новая сделка.
Если значение из поля Roistat будет случайно удалено, то при загрузке заявок (лидов и сделок) наша система самостоятельно определит источник обращения, чтобы сделка попала в нужный рекламный канал. Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.
Roistat передает в CRM ссылку на запись телефонного разговора вашего менеджера с клиентом.
Roistat поддерживает поля retailCRM с типом Справочник.
Внимание!
В retailCRM можно настроить автоматическое создание дополнительных задач и комментариев в сделке, с которой работает менеджер, чтобы менеджер не пропускал заявки-дубли.
Загрузка данных из CRM¶
Из CRM-системы в аналитику Roistat выгружаются данные по заказам и клиентам:
- Из CRM в Аналитику загружается выручка по заказу. Выручка рассчитывается по следующей формуле: сумма товаров + стоимость доставки.
- Загружается информация по себестоимости заказа по следующей формуле: себестоимость товаров + дополнительные статьи расходов.
- Загружается контактная информация по клиентам для Управления клиентами.
Шаг 1. Добавьте дополнительное поле roistat¶
В настройках сделки добавьте дополнительное текстовое поле с символьным кодом roistat. Для этого нужно:
-
В retailCRM перейти на вкладку Настройки (на панели слева), раскрыть список Системные, выбрать пункт Пользовательские поля и нажать Добавить:
-
Ввести параметры поля:
- Поле для: Заказ
- Название: roistat
- Символьный код: roistat
- Тип поля: Строка
- Отображение: Редактируется
-
Нажать Сохранить.
Внимание!
Дополнительное поле обязательно должно иметь название roistat, иначе интеграция работать не будет.
Внимание!
Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле roistat данными об источнике сделки. Тогда информация об источнике сделки будет отображена в Аналитике.
Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:
- yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID – идентификатор рекламного канала. Например, yamarket1.
- direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
- google{ID}, если хотите отнести сделку к каналу Google Ads. Например, google3.
- merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
- vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
- facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
- mytarget{ID}, если хотите отнести сделку к каналу myTarget.
- seo_yandex, если хотите отнести сделку к каналу SEO – Яндекс.
- seo_google, если хотите отнести сделку к каналу SEO – Google.
Шаг 2. Подключите retailCRM в каталоге интеграций¶
- В интерфейсе Roistat откройте раздел Интеграции.
- В блоке CRM выберите retailCRM и нажмите кнопку Настроить интеграцию.
-
Заполните поля для авторизации в retailCRM:
- В поле Адрес введите URL-адрес вашего проекта в retailCRM. Обычно он выглядит так: https://<название проекта>.retailcrm.ru.
- В поле API-ключ введите API-ключ. Для этого скопируйте его в разделе retailCRM Настройки → Интеграция → Ключи доступа к API:
Внимание!
Обратите внимание на тип доступа в настройках API-ключа. Если вы хотите, чтобы заказы загружались для всех магазинов, в настройках API-ключа в retailCRM укажите тип доступа Доступ ко всем магазинам.
-
Нажмите кнопку Сохранить.
- Откроется окно распределения статусов. При этом из retailCRM загрузятся статусы сделок. Перетаскивая статусы сделок, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.
- Прочитайте Инструкцию по включению отправки заявок и нажмите Следующий шаг.
-
Откроется окно расширенных настроек:
В расширенных настройках интеграции вы можете:
- Указать параметры для фильтрации сделок. Для этого прочитайте статью Фильтрация сделок.
- Указать значения полей бизнес-показателей (поле с выручкой, поле себестоимости, поле с прибылью). Для этого прочитайте статью Поля бизнес-показателей.
По умолчанию Roistat использует собственный алгоритм определения даты продажи сделки. Если вы хотите использовать дату продажи из CRM, перетащите ползунок Использовать дату продажи из CRM вправо.
-
На шаге Отправка заявок в CRM-систему: базовые настройки выберите из выпадающего списка магазин, в котором будут создаваться заказы, и имена ответственных за заявки. Нажмите кнопку Сохранить:
-
Откроется окно Отправка заявок в CRM-систему: создание задач:
Чтобы включить данный механизм, активируйте переключатель Создавать задачи при создании сделки. Автоматическое создание задач нужно для того, чтобы менеджеры оперативно реагировали на поступающие заявки.
Время на выполнение задачи – время, за которое задача должна быть выполнена. По умолчанию устанавливаются сутки, если в поле ничего не введено. Текст задачи – текст, который будет отображаться в CRM.
Шаг 3. Настройте автоматическую отправку сделок в retailCRM¶
Рекомендуем настроить передачу сделок в CRM через Roistat – механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.
Если отправка сделок с сайта в CRM уже настроена с помощью вашего кода, для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat значением куки roistat_visit.
Пример кода, с помощью которого можно получить значение этой куки:
`$roistatVisitId` `= ``array_key_exists``(``'roistat_visit'``, ``$_COOKIE``) ? ``$_COOKIE``[``'roistat_visit'``] : ``"неизвестно"``;`
Внимание!
В retailCRM можно создавать заявки сразу в нескольких магазинах. Для этого в прокси-лиде в fields передайте параметр site с одним из символьных кодов магазина, и заказ будет создан в нужном магазине.
Проверка работы¶
После того, как на сайте отправлена заявка, в retailCRM создается новая сделка с заполненным полем Roistat ID. Сделки также отображаются и в Roistat:
- В проекте Roistat откройте раздел Интеграции.
- На виджете настроенной интеграции с retailCRM нажмите кнопку Настроить интеграцию.
- В окне настройки интеграции пройдите по ссылке Список отправленных заявок.
Если значение из поля Roistat будет случайно удалено, то при загрузке сделок наша система самостоятельно определит источник обращения, чтобы сделка попала в нужный рекламный канал.
После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами: