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

Интеграция Roistat с YCLIENTS

Внимание!

Интеграция YCLIENTS работает с записями и контактами. 

Внимание!

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

Шаг 1. Установите счетчик

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

О том, как установить счетчик на сайт, читайте статью Установка счетчика. Если на сайте уже есть счетчик, пропустите этот шаг.

Измените код формы YCLIENTS

Найдите следующий код YCLIENTS

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

Вместо wXXXXX вставьте ID вашей формы.

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

Дополнительное поля для интеграции включается в YCLIENTS в разделе Аналитика - Интеграция с Roistat.

Внимание!

Дополнительное поле обязательно должно иметь название roistat, иначе интеграция работать не будет.

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

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:

  • yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1.
  • direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
  • google{ID}, если хотите отнести сделку к каналу Google Adwords. Например, google3.
  • merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
  • vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
  • facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
  • mytarget{ID}, если хотите отнести сделку к каналу myTarget.
  • seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
  • seo_google, если хотите отнести сделку к каналу SEO - Google.

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

  1. Откройте Каталог интеграций.

  2. В блоке CRM выберите YCLIENTS и нажмите кнопку Настроить интеграцию.

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

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

Внимание!

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

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

  1. Необходимо проверить, какая сеть является главной у настраиваемого филиала. В интерфейсе филиала перейдите во вкладку "Настройки" - "Сети" 1.png

  2. Перейдите в настройки нужной сети, являющейся главной, (маркер 1) и перейдите во вкладку "Настройки" - "Пользователи" (маркер 2). Проверьте, что пользователь добавлен в настройки сети и имеет полные права.

Внимание!

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

2.png

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

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

  3. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.
  4. Нажмите кнопку Продолжить.
  5. Укажите параметры для расширенной настройки:     a. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.     b. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.     c. Нажмите кнопку Сохранить.
  6. В поле Ответственные за заявки введите через запятую идентификаторы сотрудников. С помощью этого списка Roistat автоматически распределяет сделки по указанным сотрудникам.

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

  1. В личном кабинете YCLIENTS раскройте раздел Сотрудники и нажмите на имя интересующего вас сотрудника.
  2. В адресной строке браузера после master_id= отображается идентификатор сотрудника: 3.jpg

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

  1. Нажмите Сохранить.
  2. В YCLIENTS откройте Онлайн-запись → Вебсайт → Инъекция скрипта.
  3. В поле 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";
       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) {
          console.log('visitId', visitId);

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

где вместо 'ключ счетчика' нужно ввести 'ключ счетчика Roistat' в кавычках (подробнее читайте в статье Установка счетчика: 4.png

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

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

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

Если отправка сделок с сайта в CRM уже настроена с помощью вашего кода (кроме виджета YCLIENTS), для обмена данными с Roistat вам необходимо заполнить дополнительное поле roistat сделки значением куки браузера roistat_visit.

Пример кода, с помощью которого можно получить значение этой куки:

`$roistatVisitId` `= ``array_key_exists``(``'roistat_visit'``, ``$_COOKIE``) ? ``$_COOKIE``[``'roistat_visit'``] : ``"неизвестно"``;`

Проверка работы

Внимание!

Выручка в Roistat считается из записи (как сумма за услуги + сумма за товары),поэтому если салон продает товары без привязки к записи, то сумма от товаров не попадает в Roistat из-за того, что отсутствует в записи клиента. Поэтому выручка в Roistat почти всегда будет меньше, чем выручка в Yclients.

Для проверки работы интеграции выполните следующие шаги:

  1. Создайте заявку на сайте.
  2. В проекте Roistat откройте Каталог интеграций.
  3. В блоке Сейчас подключено на виджете настроенной интеграции с YCLIENTS нажмите кнопку Настроить.
  4. В окне настройки интеграции пройдите по ссылке Список отправленных заявок и найдите созданную заявку.
  5. Проверьте, что в поле Промокод указан номер визита.
  6. Проверьте статус отправки заявки: в поле Отправлен должен появиться успешный статус отправки V, а в  YCLIENTS - новая запись на услугу с номером визита.

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