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

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

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

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

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

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

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

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

Шаг 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
38
39
40

<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', '***********************');


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']);
    } else if (params['roistat_visit']) {
        window.roistat.setVisit(params['roistat_visit']);
    }
    window.roistatPromoCodeRefresh();
};

window.roistatVisitCallback = function (visitId) {

    window.yclientsApi.setAdditionalOptions({
        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. На шаге Расширенные настройки вы можете:

   • Указать параметры для фильтрации сделок. Подробнее – в статье Фильтрация сделок.
   • Указать значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей.
   • Включить/отключить дополнительные настройки:
     • Не передавать комментарий и дополнительные поля заявки в комментарии к сделке
     • Загружать выручку сделки до вычета скидок
     • Загружать "Продажи товаров" (без записи) и "Пополнения счетов клиентов" как сделки в Roistat. По умолчанию в Roistat из CRM Yclients загружаются только сущность Запись (Визит). Включите эту настройку, если хотите, чтобы "Продажи товаров" (без записи) и "Пополнения счетов клиентов" (включая покупки абонементов и сертификатов) тоже загружались и учитывались в аналитике. После загрузки не забудьте распределить специальный статус для таких сделок "Пополнение счета" в группу статусов Оплаченные (пункт 5 этой инструкции).
     • Использовать дату продажи из CRM. Включите настройку, если хотите, чтобы дата продажи загружалась из вашей CRM системы. Данный механизм основывается на стандартном для CRM системы определении выигрыша сделки. Если вы используете свои статусы для определения продажи по сделке, используйте общий механизм определения даты продажи.

   

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

8. На шаге Распределение заявок между менеджерами можно указать определенных сотрудников, на которых нужно назначать сделки. Кликните по полю Ответственные за заявки и выберите нужных сотрудников из списка. В поле Компания ответственных выберите компанию, в которой состоят ответственные за заявки сотрудники. Нажмите Сохранить, чтобы применить изменения.

9. На шаге Настройки выгрузки можно указать конкретные Филиалы, по которым нужно выгружать информацию (по умолчанию выгружаются данные по всем доступным Филиалам). Для этого кликните по полю Филиалы для выгрузки и выберите нужные значения из списка.

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

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

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

После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами:

• Управление клиентами
• Дашборд
• Экспериментальные возможности
• Управление ставками
• Email-трекинг
• Когортный анализ
• Ловец лидов
• События
• Радар