# Пользовательские параметры страницы

# Что такое пользовательский параметр страницы?

Помимо общих данных, которые 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