Loading...
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 40 Next »


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

Шаг 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.

(warning) Дополнительное поле обязательно должно иметь название 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 / CMS выберите YCLIENTS и нажмите кнопку Подключить.
  3. Заполните поля для авторизации в YCLIENTS:
    1. В поле Логин введите адрес электронной почти или номер телефона, на который зарегистрирован ваш аккаунт. Номер нужно вводить без знака +, скобок и пробелов. Например, 7xxxxxxxxxx.
      (warning) Необходимо убедиться, что данный пользователь добавлен в настройках главной сети и имеет администраторский доступ.

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

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

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

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

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

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

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

  9. Нажмите Сохранить.
  10. В YCLIENTS откройте Онлайн-запись → Вебсайт → Инъекция скрипта.
  11. В поле 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' в кавычках (подробнее читайте в статье Установка счетчика).

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

Шаг 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'] : "неизвестно";

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

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

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

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



  • No labels