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

JS API Roistat

Более гибкую настройку Roistat можно осуществлять с помощью добавления специальных функций. С их помощью можно добавлять свои скрипты и расширять возможности инструментов Roistat.

Внимание!

Рекомендуем использовать эти функции только в том случае, если вы уверены, что работа Roistat и ваших систем не будет нарушена.

Общее

Функция Описание
onRoistatAllModulesLoaded() Запускается после загрузки всех модулей счетчика.
onRoistatModuleLoaded() Вызывается после загрузки основного модуля счетчика, но перед дополнительными (Коллтрекингом, Ловцом лидов и др.). Используется, если хотите запустить свою функцию до того, как отработают дополнительные модули. То есть сразу, как только появляется объект window.roistat.
window.roistat.registerOnVisitProcessedCallback() Вызывается после того, как будет получен от сервера и установлен cookie roistat_visit (в коде window.roistat.visitj).
window.roistat.emailtracking.refresh() Принудительно подменяет емейлы на страницы, если используется емейлтрекинг. Функцию необходимо использовать внутри onRoistatAllModulesLoaded.

Коллтрекинг

Функция Описание
window.roistat.registerOnCalltrackingPhoneReceivedCallback() Вызывается после того, как от сервера получены телефоны для подмены на странице.
window.roistat.disableCallTracking() Отключает Коллтрекинг. Функцию необходимо использовать внутри onRoistatModuleLoaded.
window.roistat.setCallTrackingManualMode() Переключает Коллтрекинг в ручной режим. Например, для выдачи подменного номера по запросу. Функцию необходимо использовать внутри onRoistatModuleLoaded.
window.roistatCallTrackingRefresh() Запрашивает номера для подмены. Функцию необходимо использовать внутри onRoistatAllModulesLoaded.
window.roistatCalltrackingScripts = [1, 2]; В подмене на сайте будут участвовать только номера из сценариев, которые перечислены в массиве.

Номер визита

window.roistatPromoCodeRefresh. Перенаправляет значение промокода в элемент с классом roistat-promo. Пример использования: страница изменилась через AJAX, поэтому нужно изменить значение промокода на сайте. Функцию необходимо использовать внутри onRoistatModuleLoaded.

window.roistatVisitCallback = function(visitId) {
    alert(visitId);
};
Функция получает номер визита.

Свойства визита

window.roistat.getSource() - возвращает значение маркера roistat. Если маркера нет то возвращает null.

window.onRoistatModuleLoaded = function () {
    window.roistat.page.params.roistat_param1 = "asd";
};
Устанавливает переменные roistat_param. Настраивается максимум пять параметров: roistat_param1, ... , roistat_param5.

onRoistatAllModulesLoaded = function () {
    window.roistat.page.params.roistat_param1 = window.roistat.getSource();
};

Устанавливает в переменную roistat_param маркер roistat. Если маркера нет то устанавливает null.

onRoistatAllModulesLoaded = function () {
    window.roistat.page.params.roistat_param1 = "xyz";
}; 
Обновляет установленную переменную roistat_param.

window.onRoistatModuleLoaded = function () {
         window.roistat.authClientByEmail("test@example.com");
};
Присваивает email клиента к конкретному визиту, чтобы можно было объединить мультиканальные цепочки по нескольким устройствам.

window.onRoistatModuleLoaded = function () {
        window.roistat.authClientById("1234567");
};
Присваивает id клиента к конкретному визиту, чтобы можно было объединить мультиканальные цепочки по нескольким устройствам.