Playground Introduction

The playground is where the magic happens. Select your recommender logic, apply filters, test and create your API.
The 'Playground' is where the magic happens. It is the area where you can create and test your recommenders, see the output and generate the API.

Selecting your Recommender

Start by navigating to the 'Playground' and then select your recommender logic from the drop down. Logics you can select include:
  • Also viewed items
  • Frequently bought together
  • Recently added to cart items
  • Recently purchased
  • Recently viewed
  • Recommended for you
  • Similar items
  • Top in category
  • Top purchased items
Recommender logic dropdown
More information about each recommender and how to setup is available by clicking on the recommender in the list above.
Once you have selected the recommended you want to use, you will see a number of settings that you can adjust to configure your recommender. The settings are unique to each recommender.


Where you are able to insert a category, simply type in the category you wish to use in the recommender e.g. 'Dresses'.

Days Span

You can select the day span for the recommender. This controls the number of days that the recommender looks back at to produce the recommender. For example, if you wish to show the most viewed products in the last 24 hours, you would slide the day span slider to 1 day.

Select Attributes

This allows you to select the fields you require in the API taken from the product feed. Upon clicking on 'Select Attributes' a popup will appear containing all of the product fields from your product feeds plus any additional computed fields you have added to your product catalogue. Standard attributes to include are:
  • product title
  • product image
  • product link
  • price
  • sale price
  • stock level / availability
  • category
  • gender
  • item id
Notice that you can 'Select All' - this adds all fields to the API call.
You should select the fields you need to build out your live image or recommendation on site.
Example of 'Select Attributes' pop up
Attributes selected will appear like this:
Attributes selected from the product feed
You can also apply filters to the products. For more information about filtering, click here.
Running your Recommender
You can now click on the green play button and run your recommender. You will see 10 products appear in Graph View - these are the top 10 products that meet your criteria.
Playground Graph View
You can also see the products in Grid View:
Playground Grid View
And you can view the API call (note that you can also see the number of views each product has had in the set timeframe):
JSON View of recommender in Playground
You can view the actual API call by clicking on the 'API call' green button:
API call output
When you are happy with your recommender configuration, click on the 'Create Recommender' green button and work through the steps to create your recommender. It will now be available in the 'Recommenders' section of the UI.