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

Содержание

Передача данных из полей форм и служебной информации:Передача событий (необязательный пункт, можно пропустить):Проверьте себя Важные моменты Передача заявок с помощью Webhook Как передать roistat_visit в заявку

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

Откройте настройки 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. Данные из форм и служебная информация будут передаваться в список заявок (данные могут обновляться пару минут):

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

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

Выберите события из списка ниже, информацию о которых хотели бы передавать:

Посетитель открыл сайт

Переход по ссылке

Открыто окно

Добавлено в корзину

Кто-то начал заполнять форму

Заявка отправлена

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

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

Название: Название события из списка

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

ID: Название события из списка

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

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

Добавлен код счетчика Roistat

Добавлен скрипт в поле "Перед /head"

Добавлена какая-либо CRM в настройках Roistat

Добавлены события на стороне Roistat (необязательно)

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

Данные передаются только из форм Creatium.

Если вы переехали к нам с Платформы ЛП, формы рекомендуется заменить на новые.

Передаваемые данные могут быть заблокированы блокировщиком рекламы, например, AdBlock. Отключите его перед проверкой интеграции

(Для разработчиков) Для запуска интеграции в режиме отладки добавьте к адресу страницы 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.