Модуль для StoreLand - RU Документация - REES46 Manual
RU Документация
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