Содержание
Передача данных из полей форм и служебной информации:
- Откройте настройки 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.
