Appearance
Попапы для сайта
JS SDK показывает попапы автоматически. Отдельного кода для вставки попапов на сайт не нужно: после запуска сессии SDK получает список попапов проекта, следит за событиями на странице и показывает попап, когда срабатывают его условия.
Разметка, стили и скрипт попапа приходят из личного кабинета вместе с попапом, поэтому оформление не зависит от CSS сайта и от опции load_css.
Что должен получать SDK
Условия показа строятся на стандартных событиях и профиле посетителя. Передавайте в SDK:
| Что | Зачем |
|---|---|
| Просмотр товара | условие «на страницах товаров», «только для товаров…», «только для категорий…» |
| Просмотр категории | условие «на страницах категорий», «только для категорий…» |
| Поисковый запрос | условие «на странице поиска» |
| Корзина, удаление | триггеры «добавил в корзину», «удалил из корзины», условие «в корзине» |
| Избранное, удаление | триггеры «добавил в избранное», «удалил из избранного» |
| Покупка | условие «на странице покупки»; после покупки список попапов обновляется |
| Данные профиля | сегменты и статус подписки на рассылки |
Отправляйте события как можно раньше после загрузки страницы: SDK определяет тип страницы по ним. Пока события нет, страница считается «прочей» (или «главной», если открыт корень сайта).
Типы попапов
| Тип | Где показывается | Особенности |
|---|---|---|
| Окно | по центру экрана поверх страницы | одновременно показывается только одно окно |
| Полоса | у верхнего или нижнего края | одновременно не больше трех полос и виджетов |
| Виджет | в левом или правом нижнем углу | одновременно не больше трех полос и виджетов |
| Встроенный | внутри элемента страницы по CSS-селектору | если элемента на странице нет, попап не показывается |
Если слот занят, попап ждет, пока посетитель закроет предыдущий, и показывается следом. Новое окно не открывается поверх попапа, показанного старым способом.
Устройства
У попапа для сайта можно ограничить устройства: только компьютеры или только мобильные. Мобильным считается экран шириной до 767 px или браузер с мобильным User-Agent.
Одностраничные приложения (SPA)
SDK отслеживает навигацию через History API (pushState, replaceState, popstate). После перехода условия по страницам проверяются заново, а триггеры запускаются с начала. Как и при обычной загрузке, после перехода нужно отправить событие страницы: просмотр товара, категории и т.д.
Тестовый режим
Попап в статусе «Тест» виден только в тестовом режиме SDK. Чтобы включить его на 24 часа, откройте сайт с параметром:
https://example.com/?rees46_testmode=1В тестовом режиме показы не учитываются в частоте показов: попап можно открывать сколько угодно раз.
Свой домен личного кабинета
Список попапов и события по ним SDK запрашивает у личного кабинета. Если вы работаете в режиме white label со своим доменом личного кабинета, укажите его при инициализации SDK — так же, как кастомные API-домены:
javascript
const options = {
app_host: 'app.custom.com',
}
r46('init', 'SHOP_ID', 'STREAM', success_callback, failure_callback, options);Если домен не указан, используется домен личного кабинета по умолчанию.