Оформление
Пользовательские параметры страницы
Что такое пользовательский параметр страницы?
Помимо общих данных, которые Sales Ninja собирает для каждого пользователя автоматически — вы можете передавать дополнительные данные о клиенте вручную.
Например, у вас интернет-магазин, где у части товаров есть видеобзор, а у части — нет. Вы добавляете параметр страницы HasVideoReview. Затем вы делаете персонализацию "Показывать видеообзор или нет", где в условиях показа указываете, что персонализация должна срабатывать, только если параметр HasVideoReview равен True.
Как поможет указание параметров страницы?
Во-первых, вы сможете использовать указанные параметры в условиях показа.
Во-вторых, далее эти данные будут использоваться в обучении.
Сколько хранится параметр страницы?
Параметр страницы хранится до перезагрузки или перехода на другой путь URL (pathname). В SPA изменение только query или hash не очищает параметры. При таком переходе очистку и новые значения задаёт интеграция сайта; см. границу SPA-навигации.
Методы работы с пользовательскими параметрами
Записать параметр
Для записи параметра страницы внутри скрипта подключения используйте:
html
<script>
/** INIT_SCRIPT */
ninja('init','<project code>');
ninja('setPageParam', 'key', value) // "value" can be a string or number
ninja('start');
</script>INIT_SCRIPT - скрипт для скачивания Sales Ninja смотреть в разделе Установка скрипта на сайт
Для записи параметра страницы вне скрипта подключения используйте:
js
ninja('setPageParam', "key", value)Записанный параметр страницы начинает учитываться при передаче данных только после самой записи.
Если часть данных уже успело передаться на сервер и только потом был указан параметр страницы — то в уже переданных данных параметр страницы указан не будет.
Поэтому, мы рекомендуем указывать все параметры визита внутри скрипта подключения до вызова ninja('start');
Удалить параметр
Для удаления параметра используйте функцию:
js
ninja('deletePageParam', 'key')Получить параметр
Для получения одного параметра используйте функцию:
js
window.SalesNinja.getPageParam("key") // This synchronous function works only when window.SalesNinja.ready == trueПолучить все параметры
Для получения всех параметров используйте функцию:
js
window.SalesNinja.getPageParams() // This synchronous function works only when window.SalesNinja.ready == true