Интеграция с Ройстат/Roistat

Содержание

Передача данных из полей форм и служебной информации:

  1. Откройте настройки Roistat на вкладке ”Код счетчика” и скопируйте код:

2. В Creatium создайте плагин "Свой код":

3. Добавьте скопированный код в поле "Перед <body>":

4. В этом же плагине, в поле "Перед </head>" добавьте строку:

<script src="https://files2.creatium.io/support-scripts/roistat.min.js" defer></script>

Что делает данный код:

  • Передает данные из полей отправленных форм
  • Передает служебную информацию о визите (адрес, utm, содержимое корзины и т.д.)
  • Передает информацию о событиях на странице

5. Перейдите к настройкам интеграций в Roistat и добавьте любую из CRM:

6. Данные из форм и служебная информация будут передаваться в список заявок (данные могут обновляться пару минут):

С передачей данных закончили

Передача событий (необязательный пункт, можно пропустить):

  1. Выберите события из списка ниже, информацию о которых хотели бы передавать:
  • Посетитель открыл сайт
  • Переход по ссылке
  • Открыто окно
  • Добавлено в корзину
  • Кто-то начал заполнять форму
  • Заявка отправлена

2. Перейдите в настройки событий на стороне Roistat

3. Добавьте каждое выбранное событие из списка по следующему шаблону:

  • Название: Название события из списка
  • Условие срабатывания: Передается через Javascript
  • ID: Название события из списка

С передачей событий закончили

Проверьте себя

  1. Добавлен код счетчика Roistat
  1. Добавлен скрипт в поле "Перед /head"
  1. Добавлена какая-либо CRM в настройках Roistat
  1. Добавлены события на стороне Roistat (необязательно)

Важные моменты

  1. Данные передаются только из форм Creatium.
  1. Если вы переехали к нам с Платформы ЛП, формы рекомендуется заменить на новые.
  1. Передаваемые данные могут быть заблокированы блокировщиком рекламы, например, AdBlock. Отключите его перед проверкой интеграции
  1. (Для разработчиков) Для запуска интеграции в режиме отладки добавьте к адресу страницы GET-параметр r_debug=1, тогда отладочная информация станет доступна в консоли. Если этой информации там нет, убедитесь, что вы подключили код по этой ссылке - https://code.creatium.site/roistat и правильно добавили GET-параметр

 

Передача заявок с помощью Webhook

Креатиум позволяет передавать данные заявки в другие сервисы посредством веб-хуков, для это в Roistat вам нужно настроить интеграцию, для этого

Перейдите в проект Roistat в раздел Интеграции . Нажмите Добавить интеграцию  и подключите интеграцию через Webhook:

Затем нажмите Настроить интеграцию:

В настройках интеграции указан адрес Webhook:

Копируете Webhook URL и переходите в личный кабинет Creatium, переходим в раздел Интеграции и уведомления

Создаем новую интеграцию, в выпадающем списке выбираем Webhook

  • Имя произвольное, например Roistat
  • В Url вставляем адрес, который скопировали в кабинете roistat
  • Тип запроса POST
  • Тип отправляемых данных: raw
  • Поле Заголовки оставляем пусты
  • Отправлять все значения - оставляем без изменений не активируя
  • Там, где Конструктор тела запроса составляем запрос данных, которые собираемся передавать, например:

Слева данные, которые ожидает Роистат, справа переменные, которые передаются из Креатиума.

Роистат ожидает набор параметров в следующем формате:

{
  "title" : "Название сделки",
  "name" : "Имя клиента",
  "email" : "test@test.test",
  "phone" : "+79876543210",
  "comment" : "Комментарий проксилида",
  "roistat_visit" : "123456", //значение куки roistat_visit у пользователя
  "fields": {
    "site": "example.com",
    "source": "vk"
  }
}

Данные должны передаваться в формате, указанном выше.

Для каждой заявки обязательно должно быть указано значение одного из параметров: email и/или phone. Остальные параметры можно передавать опционально: если значение отсутствует, можно передавать null или не передавать параметр совсем.

Если нужного вам поля нет справа для выбора В Креатиум, вам нужно использовать Указать поле по ID, а ID предварительно задать полю в редакторе в настройках поля:

Чтобы проверить работу интеграции, отправьте тестовую заявку через сервис, с которым настроена интеграция. Заявка должна появиться в проекте Roistat в разделе Диагностика проекта → Список отправленных заявок:

Если у вас настроена интеграция с CRM, в поле Отправлен будет указан успешный статус отправки, а в CRM будет создана новая заявка с номером визита клиента.

Как передать roistat_visit в заявку

Перейдите в раздел Плагины - Свой код - Код перед </body> и добавьте следующий код

<script type="text/javascript">

cr.api(page => {

  page.waitForAppear('.cr-form', form => {

    page.getComponent(form).on('before-submit', e => {


      e.fields.push({

        name: 'roistat_visit',

        value: getClientRoistat(),

        uid: 'roistat_visit'

      });

    })

  })

      function getClientRoistat() {

        return getCookie('roistat_visit') || ''

      }


      function getCookie(name) {

        name = name.replace(/([.$\/?*+\\{}|()\[\]^])/g, '\\$1')

        const regex = new RegExp('(?:^|[^\w])' + name + '=(.*?)(?:;|$)')

        const matches = document.cookie.match(regex)

        return matches ? decodeURIComponent(matches[1]) : undefined

      }

    })

</script>

Данный код будет добавлять в каждую форму roistat_visit.

ТЕХНИЧЕСКАЯ ПОДДЕРЖКА

Не можете найти то, что ищете?

Напишите нам. на связи 24/7. Среднее время ожидания ответа: 10-15 минут. Также вы можете вступить в наш Телеграм-чат, где собралось много специалистов и пользователей.

Поддержка Creatium

Агенты ответят через 10 минут

Агенты ответят

Блог, курсы и полезные материалы 

Платформа сайтов любой сложности