Пример подключения, приведённый в данной инструкции является устаревшим и его поддержка прекращена, рекомендуем использовать подключение с помощью JS SDK 3.
1. Введение
Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе StoreLand.
2. Краткий план установки
- Зарегистрировать магазин в системе REES46.
- Установить модуль на сайт.
- Установить сбор данных.
- Настроить блоки рекомендаций.
- Проверить работоспособность.
3. Видео-инструкция по установке и настройке модуля
Самый простой способ провести подключение – это посмотреть данный видеоматериал и следовать инструкциям.
ВИДЕО В РАЗРАБОТКЕ
4. Пошаговая инструкция по установке
Если же вы из числа суровых программистов и не признаете видео, то читайте дальше.
4.1. Регистрация магазина
- Перейдите на сайт http://rees46.com.
- Зарегистрируйтесь и создайте новый магазин
- Запишите код магазина и секретный ключ (длинная бесмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46). И то и другое можно получить в разделе "Настройка магазина".
4.2. Установка модуля на сайт
- Перейдите в административный интерфейс вашего сайта.
- Зайдите в раздел API по ссылке:
http://имя_вашего_сайта/admin/api
- Нажмите кнопку "Добавить свое приложение".
- В появившемся текстовом поле напишите
REES46
(обязательно большими буквами) и нажмите "Сохранить". - В табличке вы увидите созданное приложение и поле "Ключ доступа". Сохраните этот ключ, скоро он вам пригодится.
- Справа в табличке нажмите иконку редактирования. Колонки в таблице изменятся на выпадающие списки. Уберите все права "Полный" и установите их так, как на скриншоте (это очень важно для безопасности вашего сайта):
- Сохраните изменения.
4.3. Подключение кода REES46
- Перейдите в меню "Сайт > Редактор шаблонов".
- В левой колонке под надписью "Шаблоны" выберите "HTML".
В открывшейся правой части перед закрывающим тегом
</body>
поставьте код:<script src="//cdn.rees46.com/rees46_script2.js" charset="UTF-8"></script> <script src="//cdn.rees46.com/rees46_storeland.js" charset="UTF-8"></script> <script type="text/javascript"> $(function () { var udata = {id: '{CLIENT_ID}', email: '{CLIENT_MAIL}'}; REES46.init("SHOP_ID" {% IF CLIENT_IS_LOGIN == 1%}, udata{% ENDIF %}); REES46.addReadyListener(function () { REES46.addStyleToPage(); }); }); </script>
где
- SHOP_ID – код магазина, который вы получили в пункте 4.1;- Сохраните шаблон.
4.4. Настройте отслеживание действий
4.4.1. Просмотр товара и добавление товара в корзину
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "Товар".
В редакторе шаблона в самом конце вставьте этот код:
<script type="text/javascript"> $(function () { REES46.addReadyListener(function() { // Track view REES46.pushData( 'view', { item_id: '{GOODS_ID}', price: '{GOODS_MIN_PRICE_NOW}', is_available: '{% IF GOODS_MOD_REST_VALUE>0 %}1{% ELSE %}0{% ENDIF %}', name: '{GOODS_NAME}', url: '{PAGE_CANONICAL}', {% IFNOT GOODS_IMAGE_EMPTY %} image_url: '{GOODS_IMAGE_MEDIUM}', {% ENDIF %} categories: [{% FOR upper_navigation %}{upper_navigation.ID},{% ENDFOR %}] } ); }); // Track cart $('.goodsDataForm').submit(function(){ REES46.pushData( 'cart', { item_id: '{GOODS_ID}', price: '{GOODS_MIN_PRICE_NOW}', is_available: '{% IF GOODS_MOD_REST_VALUE>0 %}1{% ELSE %}0{% ENDIF %}', name: '{GOODS_NAME}', categories: [{% FOR upper_navigation %}{upper_navigation.ID},{% ENDFOR %}] } ); }); }); </script>
- Сохраните шаблон.
4.4.2. Удаление товара из корзины
НЕТ ТЕХНИЧЕСКОЙ ВОЗМОЖНОСТИ
4.4.3. Оформление заказа
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "Просмотр заказа".
В редакторе шаблона в самом конце вставьте этот код:
<script type="text/javascript"> $(function () { REES46.addReadyListener(function() { // Track view REES46.pushData( 'purchase', [ {%FOR order_lines%} {% IF order_lines.TYPE_ID=1 %} { item_id: '{order_lines.GOODS_ID}', price: '{order_lines.LINE_PRICE}', is_available: '{% IF order_lines.GOODS_MOD_REST_VALUE>0 %}1{% ELSE %}0{% ENDIF %}', categories: [], amount: {order_lines.QUANTITY} }, {%ENDIF%} {%ENDFOR%} ], "{ORDER_NUM}" ); }); }); </script>
- Сохраните шаблон.
4.4.4. Что делать, если пользователь оформляет заказ без регистрации
Если вы хотите отправить нам информацию о e-mail клиента для последующих триггерных и дайджестных рассылок, а клиент оформляет заказ без регистрации, то вы можете передать нам его e-mail, используя этот способ: отправка дополнительных данных о пользователе.
4.5. Размещение блоков рекомендаций
4.5.1. Главная страница
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "HTML".
В редакторе шаблона найдите строчку
{% IF index_page %}
и сразу после нее поставьте этот код:<!-- Популярные товары --> <div class="rees46 rees46-recommend" data-type="popular"></div> <!-- Недавно просмотренные товары --> <div class="rees46 rees46-recommend" data-type="recently_viewed"></div> <!-- Возможно, вам это понравится --> <div class="rees46 rees46-recommend" data-type="interesting"></div>
- Сохраните изменения.
4.5.2. Страница категории
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "Товары".
В редакторе шаблона найдите строчку
{% IF CATEGORY_DESCRIPTION %}
и прямо перед ней поставьте этот код:{% IFNOT IS_FULL_CATALOG %} {% FOR upper_navigation %} {% IF upper_navigation.CURRENT %} <!-- Популярные товары в категории --> <div class="rees46 rees46-recommend" data-type="popular" data-id="{upper_navigation.ID}"></div> {% ENDIF %} {% ENDFOR %} {% ENDIF %} <!-- Недавно просмотренные товары --> <div class="rees46 rees46-recommend" data-type="recently_viewed"></div> <!-- Возможно, вам это понравится --> <div class="rees46 rees46-recommend" data-type="interesting"></div>
Сохраните изменения.
4.5.3. Страница товара
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "Товар".
В редакторе шаблона найдите строчку "
<!-- END Если в тарифном плане подключен модуль отзывов о товаре -->"
(то есть прямо под блоком комментариев) и поставьте этот код:<!-- С этим товаром покупают --> <div class="rees46 rees46-recommend" data-type="also_bought" data-id="{GOODS_ID}"></div> <!-- Похожие товары --> <div class="rees46 rees46-recommend" data-type="similar" data-id="{GOODS_ID}" data-cart="{% FOR cart_items %}{cart_items.GOODS_ID},{% ENDFOR %}"></div> <!-- Возможно, вам это понравится --> <div class="rees46 rees46-recommend" data-type="interesting"></div> <!-- Недавно просмотренные товары --> <div class="rees46 rees46-recommend" data-type="recently_viewed"></div>
- Сохраните изменения.
4.5.4. Страница корзины
- Перейдите в меню "Сайт > Редактирование шаблонов".
- Откройте в левой колонке шаблон "Товар".
В редакторе шаблона в самом конце файла поставьте этот код:
<div class="rees46 rees46-recommend" data-type="see_also" data-cart="{% FOR cart_items %}{cart_items.GOODS_ID},{% ENDFOR %}"></div>
- Сохраните изменения.
5. Проверка работоспособности
Проверка выполняется так:
- Включаете консоль разработчика в вашем браузере.
- Находите вкладку Network (или "Сеть"), в которой при обновлении страницы отображаются происходящие запросы.
- Включаете режим фильтрации только XHR-запросов.
- Проверяете, есть ли запросы, которые уходят на
api.rees46.com
.
5.1. Проверка отправки событий
- Перейдите на страницу просмотра товара.
- Убедитесь, что уходит запрос на адрес
api.rees46.com/push
5.2. Проверка запроса рекомендаций
- Перейдите на главную страницу и убедитесь, что уходит один запрос на
api.rees46.com/recommend.
- Перейдите на страницу категории и убедитесь, что уходят три запроса на
api.rees46.com/recommend
. - Перейдите на страницу товара и убедитесь, что уходят три запроса на
api.rees46.com/recommend
. - Перейдите на страницу корзины и убедитесь, что уходит один запрос на
api.rees46.com/recommend
.
6. Если рекомендации еще не появились
Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки по пунктам 5.1 и 5.2.
Если что-то не получается
Свяжитесь с нами по адресу support@rees46.com.