Page tree
Skip to end of metadata
Go to start of metadata

 

Пример подключения, приведённый в данной инструкции является устаревшим и его поддержка прекращена, рекомендуем использовать подключение с помощью JS SDK 3.

1. Введение

Этот документ описывает процесс установки модуля REES46 на ваш магазин на платформе StoreLand.

2. Краткий план установки

  1. Зарегистрировать магазин в системе REES46.
  2. Установить модуль на сайт.
  3. Установить сбор данных.
  4. Настроить блоки рекомендаций.
  5. Проверить работоспособность.

3. Видео-инструкция по установке и настройке модуля

Самый простой способ провести подключение – это посмотреть данный видеоматериал и следовать инструкциям.

ВИДЕО В РАЗРАБОТКЕ

4. Пошаговая инструкция по установке

Если же вы из числа суровых программистов и не признаете видео, то читайте дальше.

4.1. Регистрация магазина

  1. Перейдите на сайт http://rees46.com.
  2. Зарегистрируйтесь и создайте новый магазин
  3. Запишите код магазина и секретный ключ (длинная бесмысленная последовательность букв и цифр, которую вы получите после создания магазина на сайте REES46). И то и другое можно получить в разделе "Настройка магазина".

4.2. Установка модуля на сайт

  1. Перейдите в административный интерфейс вашего сайта.
  2. Зайдите в раздел API по ссылке: http://имя_вашего_сайта/admin/api
  3. Нажмите кнопку "Добавить свое приложение".
  4. В появившемся текстовом поле напишите REES46 (обязательно большими буквами) и нажмите "Сохранить".
  5. В табличке вы увидите созданное приложение и поле "Ключ доступа". Сохраните этот ключ, скоро он вам пригодится.
  6. Справа в табличке нажмите иконку редактирования. Колонки в таблице изменятся на выпадающие списки. Уберите все права "Полный" и установите их так, как на скриншоте (это очень важно для безопасности вашего сайта):
     
  7. Сохраните изменения.

4.3. Подключение кода REES46

  1. Перейдите в меню "Сайт > Редактор шаблонов".
  2. В левой колонке под надписью "Шаблоны" выберите "HTML".
  3. В открывшейся правой части перед закрывающим тегом </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.4.1. Просмотр товара и добавление товара в корзину

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "Товар".
  3. В редакторе шаблона в самом конце вставьте этот код:

    <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.4.2. Удаление товара из корзины

НЕТ ТЕХНИЧЕСКОЙ ВОЗМОЖНОСТИ

4.4.3. Оформление заказа

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "Просмотр заказа".
  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.4. Что делать, если пользователь оформляет заказ без регистрации

Если вы хотите отправить нам информацию о e-mail клиента для последующих триггерных и дайджестных рассылок, а клиент оформляет заказ без регистрации, то вы можете передать нам его e-mail, используя этот способ: отправка дополнительных данных о пользователе.

4.5. Размещение блоков рекомендаций

4.5.1. Главная страница

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "HTML".
  3. В редакторе шаблона найдите строчку {% 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. Сохраните изменения.

4.5.2. Страница категории

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "Товары".
  3. В редакторе шаблона найдите строчку {% 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. Сохраните изменения. 

4.5.3. Страница товара

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "Товар".
  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. Сохраните изменения.

4.5.4. Страница корзины

  1. Перейдите в меню "Сайт > Редактирование шаблонов".
  2. Откройте в левой колонке шаблон "Товар".
  3. В редакторе шаблона в самом конце файла поставьте этот код:

    <div class="rees46 rees46-recommend" data-type="see_also" data-cart="{% FOR cart_items %}{cart_items.GOODS_ID},{% ENDFOR %}"></div>
  4. Сохраните изменения.

5. Проверка работоспособности

Проверка выполняется так:

  1. Включаете консоль разработчика в вашем браузере.
  2. Находите вкладку Network (или "Сеть"), в которой при обновлении страницы отображаются происходящие запросы.
  3. Включаете режим фильтрации только XHR-запросов.
  4. Проверяете, есть ли запросы, которые уходят на api.rees46.com.

5.1. Проверка отправки событий

  1. Перейдите на страницу просмотра товара.
  2. Убедитесь, что уходит запрос на адрес api.rees46.com/push


5.2. Проверка запроса рекомендаций

  1. Перейдите на главную страницу и убедитесь, что уходит один запрос на api.rees46.com/recommend.
  2. Перейдите на страницу категории и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  3. Перейдите на страницу товара и убедитесь, что уходят три запроса на api.rees46.com/recommend.
  4. Перейдите на страницу корзины и убедитесь, что уходит один запрос на api.rees46.com/recommend.

6. Если рекомендации еще не появились

Рекомендации могут появиться не сразу – все зависит от посещаемости вашего сайта. Если на вашем сайте оформляются заказы, значит статистика собирается и скоро рекомендации начнут появляться. Но обязательно проверьте правильность установки по пунктам 5.1 и 5.2.

Если что-то не получается

Свяжитесь с нами по адресу support@rees46.com.

 

 

  • No labels