Перейти к содержанию

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

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

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

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

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

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

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

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

1.jpg

Необходимо заменить текущий скрипт виджета 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/

2.jpg

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

3.png

Если вы используете новую версию онлайн-записи YCLIENTS и не видите кнопку Инъекция скрипта, переключитесь на старую версию, кликнув по переключателю в столбце Новый дизайн:

3-1.png

В поле 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 в разделе Настройки → Код счетчика:

4.png

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

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

    4-1.png

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

Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле roistat данными об источнике сделки. Тогда информация об источнике сделки будет отображена в Аналитике.

Чтобы отнести сделку к определенному рекламному каналу, в поле roistat нужно ввести специальный маркер. Подробнее – в статье Разметка ссылок.

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

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

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

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

    5.png

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

    6.png

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

    7.png

  4. Не закрывая настройки интеграции, перейдите по ссылке и зарегистрируйтесь в Личном кабинете разработчика Маркетплейса YCLIENTS.

    8.png

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

    16.png

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

    17.png

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

    18.png

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

    19.png

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

    20.png

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

    21.png

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

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

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

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

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

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

    10.png

  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. Нажмите Сохранить.

    11.png

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

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

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

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

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

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

12.png

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

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

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

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

    13.png

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

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

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

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

    14.png

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

    15.png

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

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