# Пользовательские параметры страницы
# Что такое пользовательский параметр страницы?
Помимо общих данных, которые Sales Ninja собирает для каждого пользователя автоматически — вы можете передавать дополнительные данные о клиенте вручную.
Например, у вас интернет-магазин, где у части товаров есть видеобзор, а у части — нет. Вы добавляете параметр страницы HasVideoReview. Затем вы делаете персонализацию "Показывать видеообзор или нет", где в условиях показа указываете, что персонализация должна срабатывать, только если параметр HasVideoReview равен True.
# Как поможет указание параметров страницы?
Во-первых, вы сможете использовать указанные параметры в условиях показа.
Во-вторых, далее эти данные будут использоваться в обучении.
# Сколько хранится параметр страницы?
Параметр страницы хранится на текущей странице до её перезагрузки или перехода на другую страницу сайта.
# Методы работы с пользовательскими параметрами
# Записать параметр
Для записи параметра страницы внутри скрипта подключения используйте:
<script>
/** INIT_SCRIPT */
ninja('init','здесь будет ваш уникальный код проекта');
ninja('setPageParam', 'ключ', значение) // "значение" может быть строкой или числом
ninja('start');
</script>
INIT_SCRIPT - скрипт для скачивания Sales Ninja смотреть в разделе Установка скрипта на сайт
Для записи параметра страницы вне скрипта подключения используйте:
ninja('setPageParam', "ключ", значение)
Записанный параметр страницы начинает учитываться при передаче данных только после самой записи.
Если часть данных уже успело передаться на сервер и только потом был указан параметр страницы — то в уже переданных данных параметр страницы указан не будет.
Поэтому, мы рекомендуем указывать все параметры визита внутри скрипта подключения до вызова ninja('start');
# Удалить параметр
Для удаления параметра используйте функцию:
ninja('deletePageParam', 'ключ')
# Получить параметр
Для получения одного параметра используйте функцию:
window.SalesNinja.getPageParam("ключ") // Это синхронная функция, будет работать только при window.SalesNinja.ready == true
# Получить все параметры
Для получения всех параметров используйте функцию:
window.SalesNinja.getPageParams() // Это синхронная функция, будет работать только при window.SalesNinja.ready == true