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

JS SDK Колбэк-функций

Содержание

  • onRoistatModuleLoaded — колбэк-функция для инструментов: Коллтрекинг, Email-трекинг, А/Б тесты, События
  • onRoistatAllModulesLoaded — колбэк-функция, которая вызывается после загрузки модулей инструментов

onRoistatModuleLoaded

Вызывается после загрузки основного модуля, до загрузки дополнительных модулей инструментов – Коллтрекинга, Email-трекинга, А/Б тестов, Событий.

Используйте этот колбэк, чтобы повлиять на поведение дополнительных инструментов – например, отключить Коллтрекинг или Email-трекинг на странице.

window.onRoistatModuleLoaded = function () {
    window.roistat.emailtracking.enabled = false; // Отключить Email-трекинг
    window.roistat.setCallTrackingManualMode(); // Включить ручной режим для отображения номеров Коллтрекинга
};

Внутри этого колбэка специфичные дейcтвия для инструментов недоступны (т.к. они ещё не загрузились). Для управления возможностями дополнительных инструментов используйте колбэк onRoistatAllModulesLoaded.

onRoistatAllModulesLoaded

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

В этом колбэке доступны все возможности всех инструментов счётчика. После загрузки модулей инструменты начинают выполнять свою работу: отображение телефонов и email-ов, отправку и получение данных аналитики и т.п. 

window.onRoistatAllModulesLoaded = function () {
  window.roistat.emailtracking.refresh(); // Обновить адреса Email-трекиннга на странице
};

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

Колбэк Описание
registerOnCalltrackingPhoneReceivedCallback Колбэк, который вызывается после того, как от сервера получены телефоны для отображения на странице
registerOnVisitProcessedCallback Колбэк, который вызывается при работе с визитами — методы getSource(), getVisit(), setRoistatParams()

Примечание

Вызов колбэка onRoistatAllModulesLoaded необязательно означает полную загрузку данных на сайте. Например, сразу после загрузки модуля Коллтрекинга может быть неизвестен номер телефона, так как от сервера еще не получены номера для коллтрекинга на странице. Как только номера получены, вызывается колбэк registerOnCalltrackingPhoneReceivedCallback, и номер передается на сайт.

Отключить или включить инструмент на этом этапе уже поздно – для включения/выключения инструментов используйте колбэк onRoistatModuleLoaded.

Модули виджетов грузятся по отдельным колбэк-функциям: