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

JS SDK Ловца лидов

Содержание

  • onRoistatLeadHunterInited — колбэк-функция, которая вызывается после успешной загрузки модулей виджета Ловец лидов
  • leadHunter — объект с методами и атрибутам для работы с Ловцом лидов
  • roistatLeadHunterUpdate() — обновить размеры формы
  • roistatLeadHunterShow() — показать форму на странице

onRoistatLeadHunterInited

Вызывается после того, как модули виджета Ловец лидов зарегистрировали свои настройки и методы, с которыми можно взаимодействовать. 

window.onRoistatLeadHunterInited = function () {
   window.roistat.leadHunter.form.autoShowTime = 50; // Показывать Ловец лидов через 50 секунд
};

Колбэки, которые вызываются после onRoistatLeadHunterInited:

Колбэк Возвращаемый тип Описание
onAfterAppear function() Вызывается перед появлением формы Ловца лидов
onAfterSubmit function(lead) Вызывается перед отправкой формы Ловца лидов
onBeforeAppear function() Вызывается после появления формы Ловца лидов
onBeforeSubmit function(lead) Вызывается после отправки формы Ловца лидов

leadHunter

Объект с методами и атрибутам для работы с Ловцом лидов.

Метод / атрибут Возвращаемый тип Описание
additionalNotifyEmail string Дополнительный email для оповещения о лиде
form.autoShowTime int Количество секунд, через которое нужно автоматически показать форму Ловца лидов
form.buttonText string Текст на кнопке Ловца лидов
form.contactLabel string Текст в поле с номером телефона
form.isNameRequired boolean Флаг, показывающий, является ли поле с именем обязательным для заполнения
form.isNeedExplicitAgreement boolean Флаг, показывающий, является ли согласие на обработку персональных данных обязательным
form.nameLabel string Текст в поле с именем
form.subTitle string Подзаголовок формы Ловца лидов
form.thankYouText string Текст после отправки формы
form.title string Заголовок формы Ловца лидов
isEnabled boolean Флаг, показывающий, включен ли Ловец лидов
localization.translateToEnglish() void Функция для перевода формы Ловца лидов на английский язык
localization.translateToRussian() void Функция для перевода формы Ловца лидов на русский язык
onAfterAppear function() Вызывается перед появлением формы Ловца лидов
onAfterSubmit function(lead) Вызывается перед отправкой формы Ловца лидов
onBeforeAppear function() Вызывается после появления формы Ловца лидов
onBeforeSubmit function(lead) Вызывается после отправки формы Ловца лидов

При настройке текстов Ловца лидов с помощью JavaScript SDK можно использовать HTML-теги – например, для переноса строки:

window.roistat.leadHunter.form.subTitle = "Перва строка <br> Вторая строка";

additionalNotifyEmail

Дополнительный email для оповщения о лиде. Необходимо установить до отправки формы Лоцва лидов.

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeSubmit = function(lead) {
    window.roistat.leadHunter.additionalNotifyEmail = "[email protected]";
  }
};

form.autoShowTime

Количество секунд, через которое нужно автоматически показать форму Ловца лидов. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.form.autoShowTime = 10; //Показывать ловец лидов через 10 секунд
};

form.buttonText

Текст на кнопке Ловца лидов. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.buttonText = "Текст на кнопке";
  }
};

form.contactLabel

Текст в поле с номером телефона. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.contactLabel = "Введите номер телефона";
  }
};

form.isNameRequired

Флаг, определяющий, является ли поле с именем обязательным для заполнения. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.isNameRequired = true;
  }
};

form.isNeedExplicitAgreement

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

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.isNeedExplicitAgreement = true;
  }
};

form.nameLabel

Текст в поле с именем. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.nameLabel = "Введите ваше имя";
  }
};

form.subTitle

Подзаголовок формы Ловца лидов. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.subTitle = "Подзаголовок";
  }
};

form.thankYouText

Текст после отправки формы. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.thankYouText = "Спасибо, скоро мы с вами свяжемся";
  }
};

form.title

Заголовок формы Ловца лидов. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    window.roistat.leadHunter.form.title = "Заголовок";
  }
};

isEnabled

Флаг, определяющий, включен ли Ловец лидов. 

window.onRoistatLeadHunterInited = function () {
    window.roistat.leadHunter.isEnabled = false; //отключить ловец лидов на странице
};

localization.translateToEnglish()

Функция для перевода формы Ловца лидов на английский язык. 

window.onRoistatLeadHunterInited = function () {
    window.roistat.leadHunter.localization.translateToEnglish();
};

localization.translateToRussian()

Функция для перевода формы Ловца лидов на русский язык. 

window.onRoistatLeadHunterInited = function () {
    window.roistat.leadHunter.localization.translateToRussian();
};

onAfterAppear

Колбэк, который вызывается после появления формы Ловца лидов. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onAfterAppear = function() {
    console.log("Форма ловца лидов показана пользователю");
  }
};

onAfterSubmit

Колбэк, который вызывается после отправки формы Ловца лидов. В качестве атрибута функции используется объект lead, в котором находятся методы и атрибуты лида. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onAfterSubmit = function(lead) {
    console.log("Форма ловца лидов отправлена");
  }
};

onBeforeAppear

Колбэк, который вызывается перед появлением формы Ловца лидов.

Принимает параметр eventType, в котором указывается событие, по которому показалась форма Ловца Лидов. Возможные значения eventType: click, auto, exit.

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeAppear = function(eventType) {
    console.log("Сейчас будет показана форма ловца лидов по событию "+eventType);
  }
};

onBeforeSubmit

Колбэк, который вызывается перед отправкой формы Ловца лидов. В качестве атрибута функции используется объект lead, в котором находятся методы и атрибуты лида. 

window.onRoistatLeadHunterInited = function () {
  window.roistat.leadHunter.onBeforeSubmit = function(lead) {
    lead.isNeedCallback = 0; // Не совершать обратный звонок
    lead.callbackPhone = 79999999999 //Номер менеджера, куда совершить звонок

    console.log("Дополнительные поля лида: " + lead.fields );
    console.log("Имя лида: " + lead.name );
    console.log("Телефон лида: " + lead.phone );
  }
};

roistatLeadHunterUpdate()

Метод для принудительного обновления масштаба и размера формы Ловца лидов. Используйте его, если форма отображается некорректно при изменении масштаба и размера элементов на странице. Метод нужно вызывать после кода для изменения масштаба и размера. 

// Ваш код для изменения масштаба и размера элементов на странице:

async function addCustomZoom() {...}
async function customResize() {...}

await addCustomZoom();
await customResize();

// После окончания всех манипуляций с масштабом и размером принудительно обновите позиционирование формы:

window.roistatLeadHunterUpdate();

roistatLeadHunterShow()

Показывает форму Ловца лидов на странице.

window.onRoistatLeadHunterInited = function () {
    document.getElementById("button").onclick = function() {
        window.roistatLeadHunterShow();
    };
};