Your customers expect high quality recommendations. They want to be supported in their purchasing decision and selection process. By using Yoochoose recommendations you increase the usability and the level of professionalism in your online shop. The recommendations present products to the customer he did not anyhow expect to find - in contrast to search.
If you are not familiar with the usage of recommendations, please read at least the two first pages of the Yoochoose User Guide . Otherwise you can proceed with the following steps.
OXID eShop version
- CE 4.7.x - 4.8.x or
- EE, PE 5.0 4.7.x/5.0.x - 4.8.x/5.1.x
First of all the Yoochoose module package must be downloaded from the OXID eXchange  website (search for "yoochoose").
The installation itself includes three steps.
- Execute the SQL script using the
/Service/Toolmenu of the OXID admin backend.
- Copy the module code into the modules folder of the OXID installation. The folder
modulesmust get a new subfolder
- Insert the PHP code from the
install.txtinto the file
OXID Recommendation module needs permanent connection to the Yoochoose recommendation engine. There are three servers:
- Event tracking:
- Recommendation controller:
- Configuration server (used only in the admin backend):
Both http (port 80) and https (port 443) ports must be open for outbound TCP connections. One must not build the firewall rule based on IP. The Yoochoose infrastructure is located in the AWS cloud and the IP addresses can be changed.
The OXID recommendation module does not provide recommendation caching internally, but the recommendation controller does support modification end expiration headers. Therefore one can configure a local caching proxy for recommendation results. More information to recommendation caching can be found in the Developer Guide , chapter Fetching Recommendations.
Before the recommendation engine can be enabled for your web shop, one must register a new OXID Connect account on the Yoochoose web page.
An account contains a default scenario configuration for an average web shop. If you are configuring a highly visited web shop (over a million page requests per month), it makes sense to ask for the special consulting and phone support by Yoochoose GmbH.
After a new Yoochoose account is created, you need to transfer the credentials from the Yoochoose dashboard
Yoochoose customer ID and license key must be first entered into the plug-in configuration. Then the plugin must be activated.
Structure and Functionality
The recommendation module is configured with 5 recommendation boxes throughout the OXID shop:
- Landing-Page recommendations with most popular products
- Category-Page recommendations with the most popular products in the selected category
- Product Detail Page 1 recommendations with the products that were bought with the currently displayed product
- Product Detail Page 2 recommendations with the alternative products that were bought together or instead of the displayed product
- Checkout recommendation with the products that are bought with the products from the shopping cart.
Basic configuration can be also done in the OXID admin backend. There you can select the recommendation engine scenario for every recommendation box, specify the amount of recommended products for every box, or disable single boxes.
Extended configuration of recommendation scenarios (for example enabling of personalized recommendations) can be done in the Yoochoose Configuration Backend . For more information about different scenarios and configuration options see the User Guide .
Replacing Recommendation Box Title
If you reconfigure several or all the recommendation scenarios, it is useful to rename the default titles of the recommendation boxes to state the purpose of the recommendations. For example rename "Customers Who Bought This Item Also Bought" into "Our special selection personally for you". Texts can be changed using the standard OXID feature in
/Customer Info/CMS Pages/Search for "yoochoose"
Disabling Embedded Recommendation
Several cross selling boxes are available in OXID out of the box. In most cases it makes sense to deactivate the ones, which are duplicated by the Yoochoose recommendations. It can be done in the OXID admin backend in
/Master Settings/Core Settings/Performance/Enhanced Performance Settings
Submodels belong to the extended configurations. Please check, if you will get advantages from using it. See the User Guide for more information or ask for consulting.
The OXID recommendation module allows to provide a single attribute during the recommendation request. It must be the same attribute the submodel is configured for.
In order to use submodels, please check that the submodel usage is activated and configured in
the OXID admin backend
the Recommendation Scenario configuration
the Recommendation Model configuration
Enabling the search in OXID is done by including some .js files in the header section of the OXID theme's base.tpl.
Please make sure to use the correct customer ID which you received after registering your product ...
After cleaning the cache, and a successful import It should look like following after relaoding the page
- Yoochoose Recommendation Engine User Guide
- Yoochoose Recommendation Engine Developer Guide
- OXID eXchange. Marketplace for OXID eShop extensions
- Yoochoose Configuration Backend