Интеграция 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 вашей формы):

1
2
3
4
5
6
7
8

<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/¶

В HTML-код необходимо вставить вледующий код:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

<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.

   

5. В личном кабинете разработчика создайте приложение для маркетплейса.

   

   При создании приложения выберите тип Непубличное.

   

6. Перейдите в управление приложением.

   

   Перейдите в раздел Настройки для разработки. В поле Адрес, на который отправлять уведомления укажите URL для отправки вебхуков, скопированный в п.3.

   

7. В Личном кабинете разработчика снова перейдите в управление приложением. Откройте раздел Общая информация, скопируйте ссылку в поле Ссылка на приложение и перейдите по ней.

   

   На открывшейся странице приложения нажмите Подключить.

   

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

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

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

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

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

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

   

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

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

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

       Список переменных Виджет YCLIENTS

       Переменная	Значение
       {field_price}	Сумма
       {field_resource_id}	Идентификатор записи
       {field_data.datetime}	Дата записи
       {field_data.staff.id}	Идентификатор сотрудника
       {field_data.staff.name}	Имя сотрудника
       {field_data.client.id}	Идентификатор клиента
       {field_data.client.name}	Имя клиента
       {field_data.client.phone}	Телефон клиента
       {field_data.client.email}	Email клиента

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

    

Шаг 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, будет присвоен рекламный источник.

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