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

Следуйте этой инструкции, если вы используете YCLIENTS в связке с другой CRM, подключенной к Roistat (amoCRM, Битрикс24 и т.д).

Шаг 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 в каталоге интеграций¶

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

   

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

   

3. Скопируйте Webhook URL:

   

4. Не закрывая настройки интеграции, перейдите в интерфейс YCLIENTS и откройте раздел Настройки. В блоке Системные настройки нажмите WebHook:

   

5. В настройках WebHook:

   • Переключите поле Отправлять хуки в состояние Отправлять.

   • В поле Адрес, на который отправлять уведомления вставьте вебхук, указанный в настройках интеграции.

   • В блоке Отправлять события по сущностям отметьте галочкой Событие по записям.

   • Нажмите Сохранить.

   

6. Вернитесь в проект Roistat в настройки интеграции и нажмите Следующий шаг.

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

   • Настроить отправку заявок в CRM. Если вы хотите, чтобы данные, полученные через YCLIENTS, сначала попадали в Roistat, а затем по ним создавались сделки в CRM, оставьте включенной опцию Отправлять заявки в CRM. Если у вас уже настроена отправка даннных напрямую из YCLIENTS в CRM, отключите эту опцию.

   • Создать сценарии отправки заявок в CRM;

   • Создать сценарии отправки целей в Google Аналитику и Яндекс.Метрику.

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

   

8. При необходимости вы можете настроить передачу значений в дополнительные поля сделки в CRM. Для этого на шаге Настройка доп. полей нажмите Добавить поле:

   

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

   • В поле ниже введите значение дополнительного поля сделки в виде текста или переменной.

   • Нажмите Сохранить.

Шаг 4. Настройте обмен данными между YCLIENTS, Roistat и CRM¶

Обмен данными между YCLIENTS, Roistat и CRM может происходить одним из способов:

• Создание сделок через Roistat. Данные по записям, полученным через виджет или страницу записи YCLIENTS, сначала попадают в Roistat, а затем отправляются в CRM. В Аналитику Roistat попадут все данные по записи, а также рекламный источник.

• Совмещение данных по сделке из CRM с рекламным источником из Roistat. Сделки по записям сразу создаются в CRM. Одновременно с этим данные по записи отправляются в Roistat. Затем данные из CRM загружаются в Roistat и при помощи матчинга совмещаются с рекламным источником, полученным системой Roistat. Таким образом, в аналитике Roistat каждой сделке присваивается рекламный источник. Данный способ подходит, если у вас уже настроена отправка данных из виджета/страницы записи напрямую в CRM.

Создание сделок через Roistat¶

В настройках интеграции с виджетом YCLIENTS на шаге Настройка поведения включите опцию Отправлять заявки в CRM:

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

Чтобы проверить работу интеграции:

1. Создайте заявку с помощью виджета/страницы записи YCLIENTS.

2. В проекте Roistat перейдите в раздел Диагностика проекта → Список отправленных заявок и найдите созданную заявку. В поле Промокод должен быть указан номер визита, а в поле Отправлен – успешный статус отправки:

   

3. В YCLIENTS также должна появиться новая запись с номером визита.

Совмещение данных по сделке из CRM с рекламным источником из Roistat¶

Воспользуйтесь этим способом, если у вас уже настроена отправка данных из YCLIENTS напрямую в CRM.

1. В настройках интеграции с виджетом YCLIENTS перейдите к шагу Настройка поведения и отключите опцию Отправлять заявки в CRM:

   

2. Раскройте меню Roistat в левом верхнем углу и перейдите в раздел Настройки. Затем откройте вкладку Экспериментальные возможности и в блоке Интеграции включите опцию Связывать источник визита со сделками при собственной логике создания заявок:

   

После этого данные по записям YCLIENTS, полученные из CRM, при помощи матчинга будут совмещаться с рекламным источником, полученным системой Roistat. Таким образом, каждой сделке, загруженной в Roistat из CRM, будет присвоен рекламный источник.

Подробнее о матчинге – в статье Использование собственной логики создания сделки (матчинг).