Skip to end of metadata
Go to start of metadata
Оглавление

1. Введение

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

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

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

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

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

ВИДЕО НЕМНОГО УСТАРЕЛО – СЕЙЧАС ВСЕ ГОРАЗДО ПРОЩЕ

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

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

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

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

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

  1. Перейдите в административный интерфейс вашего сайта.
  2. Зайдите в раздел "Marketplace", затем в "Каталог решений".
  3. В поле поиска введите REES46 и найдите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  4. Выполните установку.
  5. Не забудьте включить модуль.

4.3. Первичная настройка

4.3.1 Коды доступа

  1. Перейдите в раздел "Настройки".
  2. Перейдите в подраздел "Настройки модулей" и выберите модуль "REES46: персональные рекомендации товаров в интернет-магазине".
  3. Вставьте в текстовые поля код магазина и секретный ключ, полученные в разделе 4.1.
  4. Сохраните изменения.


4.3.2 Обмен информацией о товарах

Там же в настройках перейдите во вкладку "Расширенный YML", скопируйте предоставленный URL:


И вставьте его в соответствующее поле в настройках вашего магазина на сайте REES46:

Функция YML доступна для Битрикс версии 15.0.2 и выше.

4.4. Установка сбора данных

Режим правки

Обратите внимание, что большинство операций по вставке блоков рекомендаций и кода отслеживания производится в режиме правки со стороны сайта, а не интерфейса администратора.

Включается режим в верхней панели переключателем, который находится в правом углу.

4.4.1. Отредактируйте текущий шаблон

Откройте на редактирование шаблон вашего сайта и вставьте перед закрывающим тегом </body> код:

<?php if(IsModuleInstalled("mk.rees46") ):
	$APPLICATION->IncludeComponent('rees46:handler', '.default');
endif; ?>

Сохраните.

Важно: если для главной страницы, карточки товара и других разделов у вас используются разные шаблоны, этот код необходимо поставить во все используемые шаблоны.

 

4.4.2. Отредактируйте шаблон компонента "Элемент каталога детально (bitrix:catalog.element)"

  1. Перейдите на страницу просмотра любого товара.
  2. Убедитесь, что режим "Правки" включен.
  3. Наведите мышь на карточку товара и подождите, пока не появится серый плавающий блок, у которого слева будет ссылка "Изменить товар", а справа шестеренка. Рядом с шестеренкой будет выпадающий список. Кликните в него и найдите в списке элемент "Элемент каталога детально (bitrix:catalog.element)". Кликните в него и выберите "Редактировать шаблон компонента". Если такого пункта нет, то выполните следующие действия:
    • выберите элемент списка "Каталог (bitrix:catalog)" и кликните "Копировать шаблон компонента".
    • в форме укажите любое имя шаблона, сохраните и, когда появится редактор кода, сохраните еще раз.
    • в итоге вы должны вернуться на просмотр страницы товара.
  4. Повторите пункт №3, пока не сможете попасть в редактирование (bitrix:catalog.element)
  5. Вставьте в конце шаблона bitrix:catalog.element код:
<?php if(IsModuleInstalled("mk.rees46") && $arResult["ID"]):
    $APPLICATION->IncludeComponent(
        'rees46:view-handler',
        '.default',
        array(
            'item_id' => $arResult["ID"]
        )
    );
endif ?>

Сохраните.

Обратите внимание, что в некоторых версиях 1С Битрикс переменная $arResult["ID"] может отсутствовать и вместо нее может быть переменная $ElementID либо другая. Важно в этом коде передавать именно идентификатор товара. Убедитесь в правильности имени переменной и ее существовании.

Если вы испытываете затруднения с установкой этого кода, свяжитесь с нами.

4.5. Установка блоков рекомендаций

4.5.1. Куда какие блоки ставить

Важно установить максимальное количество блоков из предложенных. Может возникнуть соблазн поставить только 1-2 блока, потому что "не хочется портить дизайн". В этом случае помните: 1-2 блока не могут работать эффективно. Для достижения максимального эффекта блоки должны быть расположены по рекомендованной схеме:

  • Главная страница:
    • популярные товары (без категории).
  • Страница категории:
    • популярные товары (сверху);
    • вы недавно смотрели (снизу);
    • возможно, вам это понравится (снизу).
  • Детальный просмотр товара (все снизу):
    • с этим товаром покупают;
    • похожие товары;
    • возможно, вам это понравится.
  • Страница корзины:
    • не забудьте посмотреть.

4.5.2. Коды установки блоков

4.5.2.1. Блок "Популярные товары"

Показывает популярные товары в просматриваемой категории или на главной странице.

Из параметров содержит переменную category, которая должна содержать идентификатор просматриваемой категории. Если идентификатор не указан, то выводит популярные товары со всего сайта с применением персонализации.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'popular',
        'params' => array(
            'category' => ИДЕНТИФИКАТОР_КАТЕГОРИИ
        ),
    ));
endif ?>
4.5.2.2. Блок "Не забудьте посмотреть"

Анализирует содержимое корзины покупателя и дает персонализированные предложения сопутствующих товаров.

Как правило размещается на странице просмотра корзины. Не включает в себя те товары, которые уже добавлены в корзину.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'see_also',
        'params' => array()
    ));
endif ?>
4.5.2.3. Блок "Вы недавно смотрели"

Показывает товары, которые пользователь недавно просматривал, но которые еще не добавлены в корзину.

Желательно отображать на всех страницах сайта. Минимум в просмотре списка товаров категории и на главной странице сайта.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'recently_viewed',
        'params' => array()
    ));
endif ?>
4.5.2.4. Блок "С этим товаром также покупают"

Показывает сопутствующие товары к тому, который покупатель просматривает прямо сейчас. Похож на see_also, но относится только к одному товару.

Рекомендуется отображать на странице просмотра товара.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'also_bought',
        'params' => array(
            'item_id' => $arResult["ID"]
        ),
    ));
endif ?>
4.5.2.5. Блок "Похожие товары"

Выводит товары, которые похожи на просматриваемый. Выводить нужно на странице просмотра товара.

Не отображает товары, которые уже есть в корзине покупателя.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'similar',
        'params' => array(
            'item_id' => $arResult["ID"]
        ),
    ));
endif ?>
4.5.2.6. Блок "Возможно, вас это заинтересует"

Выводит товары, которые просто будут интересны покупателю. Имеет смысл выводить на главной странице и на странице просмотра товара.

Не требует параметров.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'interesting',
        'params' => array()
    ));
endif ?>
4.5.2.7. Блок "Прямо сейчас покупают"

Выводит персонализированную подборку товаров, которые другие покупатели, похожие на текущего пользователя, покупают прямо сейчас. Работает на сайтах с посещаемостью от 3000 человек в день. Имеет смысл выводить на главной странице и на страницах категорий.

<?php if(IsModuleInstalled("mk.rees46")):
    $APPLICATION->IncludeComponent('rees46:recommend', '.default', array(
        'recommender' => 'buying_now',
        'params' => array(),
    ));
endif ?>

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.

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

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

7. Участие в разработке модуля

REES46 является бесплатной профессиональной рекомендательной системой, цель которой – дать возможность персонализированного подхода к клиенту любому интернет-магазину. Если вы специалист в разработке модулей под 1С-Битрикс и желаете улучшить модуль, отправляйте pull request в репозиторий https://github.com/rees46/rees46_bitrix

8. Если вы используете систему контроля версий

Раздел для разработчиков

В связи с глубокой интеграцией модуля с CMS, установщик копирует часть своих файлов в публичную часть сайта. Чтобы исключить эти файлы из контроля версий, добавьте в список игнорируемых файлов:

%document_root%/bitrix/components/rees46
%document_root%/include/rees46-handler.php
  • No labels