Интеграция Roistat с YCLIENTS без использования сторонней CRM

Данная инструкция подойдет, если вы используете YCLIENTS как CRM: клиенты оставляют заявки в виджете YCLIENTS или на отдельной странице записи вида https://ХХХХХХХ.yclients.com/, а затем в YCLIENTS создаются сделки.

Если вы используете YCLIENTS в связке с другой CRM, подключенной к проекту Roistat, следуйте инструкции Интеграция Roistat с YCLIENTS с использованием сторонней CRM.

Как работает интеграция¶

Roistat автоматически связывает визиты из рекламных источников со сделками из YCLIENTS. Вы сможете за несколько секунд построить аналитические отчеты и увидеть:

• Какие рекламные каналы приносят прибыль, а какие – впустую тратят бюджет;
• Какова реальная стоимость привлечения клиента;
• Откуда приходят клиенты с большим средним чеком;
• По каким ключевым словам клиенты находят вас;
• Сколько денег и сделок в итоге принесли конкретные рекламные кампании.

Интеграция YCLIENTS работает с Записями и Контактами YCLIENTS. Информация по Записям загружается в Аналитику Roistat. Данные по Клиентам – можно загружать в инструмент Управление клиентами.

Вы можете настроить создание Записей в YCLIENTS через инструменты Roistat – Коллтрекинг, Емейлтрекинг, Ловец лидов.

Вы можете настроить создание сделок по звонкам через Коллтрекинг Roistat: в YCLIENTS создается Запись с данными о звонке и со ссылкой на запись разговора в комментарии. При этом звонок не будет отображаться в разделе Звонки в YCLIENTS.

Шаг 1. Установите счетчик Roistat и скрипт для интеграции с YCLIENTS¶

Установка счетчика Roistat¶

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

О том, как установить счетчик на сайт, читайте в статье Установка счетчика. Если на сайте уже есть счетчик, перейдите сразу к установке скрипта для интеграции.

Установка скрипта для интеграции с YCLIENTS¶

Если на вашем сайте установлен виджет YCLIENTS¶

Необходимо заменить текущий скрипт виджета YCLIENTS на скрипт для интеграции с Roistat.

В коде сайта найдите существующий скрипт YCLIENTS (wXXXXX – ID вашей формы):

<script type="text/javascript" src="https://wXXXXX.yclients.com/widgetJS" charset="UTF-8"></script>

Замените его на следующий скрипт (вместо wXXXXX вставьте ID вашей формы.):

<script>
window.roistatVisitCallback = function(visitId) {
document.cookie = 'yextrafield_roistat=' + visitId;
var script = document.createElement('script');
script.src = "https://wXXXXX.yclients.com/widgetJS";
document.getElementsByTagName('body')[0].appendChild(script);
};
</script>

Если вы используете Онлайн-запись на отдельной странице вида https://ХХХХХХХ.yclients.com/¶

В YCLIENTS откройте Онлайн-запись → Вебсайт → Инъекция скрипта:

В поле HTML код удалите имеющийся код и вставьте следующий:

<script>
  (function(w, d, s, h, id) {
  w.roistatProjectId = id; w.roistatHost = h;
  var p = d.location.protocol == "https:" ? "https://" : "http://";
  var u = /^.*roistat_visit=[^;]+(.*)?$/.test(d.cookie) ? "/dist/module.js" : "/api/site/1.0/"+id+"/init?referrer="+encodeURIComponent(d.location.href);
  var js = d.createElement(s); js.charset="UTF-8"; js.async = 1; js.src = p+h+u; var js2 = d.getElementsByTagName(s)[0]; js2.parentNode.insertBefore(js, js2);
})(window, document, 'script', 'cloud.roistat.com', '***********************');
</script>

<script>
window.onRoistatModuleLoaded = function () {
var params = window
.location
.search
.replace('?','')
.split('&')
.reduce(
function(p,e){
var a = e.split('=');
p[ decodeURIComponent(a[0])] = decodeURIComponent(a[1]);
return p;
},
{}
);
if (params['yextrafield_roistat']) {
window.roistat.setVisit(params['yextrafield_roistat']);
}
};

window.roistatVisitCallback = function (visitId) {

window.yclientsAdditionalOptions = {
bookingCustomFields: {
roistat: visitId
}
};
};
</script>

************************ в начале скрипта – это идентификатор кода счетчика Roistat, который можно найти в проекте Roistat в разделе Настройки → Код счетчика:

Шаг 2. Добавьте дополнительное поле roistat¶

1. В интерфейсе YCLIENTS перейдите в раздел Аналитика → Настройки → Сквозная аналитика (Roistat):

   

2. Включите поле roistat.

Шаг 3. Подключите YCLIENTS в каталоге интеграций Roistat¶

1. В проекте Roistat перейдите в раздел Интеграции и нажмите Добавить интеграцию. В блоке Каталог CRM/CMS найдите YCLIENTS и нажмите Добавить:

   

2. Нажмите кнопку Настроить интеграцию:

   

3. Заполните поля для авторизации в YCLIENTS:

   • В поле Логин введите адрес электронной почти или номер телефона, на который зарегистрирован ваш аккаунт. Номер нужно вводить без знака +, скобок и пробелов. Например, 7xxxxxxxxxx.

   • В поле Пароль введите пароль для входа в ваш аккаунт.

   Обратите внимание:

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

   Как проверить, что пользователь добавлен в настройки главной сети

   • В интерфейсе YCLIENTS перейдите во вкладку Настройки → Сети и найдите сеть, которая является главной:

     

   • Откройте настройки главной сети (маркер 1) и перейдите в раздел Настройки — Пользователи (маркер 2). Проверьте, что пользователь добавлен в настройки сети и имеет полные права.

     

   Если вы не можете выбрать сеть в интерфейсе, обратитесь к администратору этой сети, чтобы он проверил настройки.

4. Нажмите кнопку Сохранить. Загрузятся статусы сделок из YCLIENTS.

5. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.

   Нажмите Продолжить.

6. Ознакомьтесь с инструкцией по включению отправки заявок. Вы можете настроить отправку заявок на этом этапе или после завершения настройки интеграции. Подробнее об отправке сделок в YCLIENTS через Roistat – в Шаге 4.

   Чтобы продолжить настройку интеграции, нажмите Следующий шаг.

7. На шаге Расширенные настройки вы можете:

   • Указать параметры для фильтрации сделок. Подробнее – в статье Фильтрация сделок.
   • Указать значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей.

   Нажмите кнопку Сохранить.

8. В поле Ответственные за заявки введите через запятую идентификаторы сотрудников. С помощью этого списка Roistat автоматически распределяет сделки по указанным сотрудникам.

   Как узнать идентификатор сотрудника

   • В личном кабинете YCLIENTS раскройте раздел Сотрудники и нажмите на имя интересующего вас сотрудника.

   • В адресной строке браузера после master_id= отображается идентификатор сотрудника:

   

   В поле Компания ответственных введите идентификатор компании, в которой состоят ответственные за заявки сотрудники.

   Как узнать идентификатор компании в YCLIENTS

   Нажмите Сохранить, чтобы применить изменения.

Шаг 4. Настройте автоматическую отправку сделок в YCLIENTS¶

Если вы на сайте используете сторонние формы, рекомендуем настроить передачу сделок в CRM через Roistat – механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

Если отправка сделок с сайта в CRM уже настроена, для обмена данными с Roistat воспользуйтесь инструкцией Использование собственной логики создания сделки (матчинг).