Child pages
  • 11a. Item import
Skip to end of metadata
Go to start of metadata


Basic recommendation algorithms are statistic based and need only the ID of a product and the ID of a user. This information is provided by the event tracking as described in the chapter 8. Event Types. There are several use cases where the recommendation engine requires additional information linked to the products. Most important cases are:

  1. Filtering results based on the category the product is located in (see 7. Category Filter for more information)
  2. Filtering results based on price and product availability (see 9. General Filters)
  3. Sub-models based on custom attributes (see 10. Sub-Models).
  4. An additional export/import interface is designed to provide editor based models (see 5. Recommendation Models).

There are three different ways to import data into the recommendation system.

  • In-Event. In the event tracking process, where related data is attached to click event (e.g. category path information)
  • Push interface. Classic HTTP POST based import. It is suitable to upload single product or editor lists.
  • Pull interface. The recommendation engine loads an exported file from the specified location in the background. It was designed to upload big portions of information, for example a weekly update of the whole product catalog.

Push and Pull interfaces are available only for the advanced edition of the Recommender Engine.

Following is the overview table for all import/export interfaces. 

Available for Basic edition(tick)(error)(error)
Updates the category information of products(tick)(tick)(tick)
Updates prices and custom attributes(error)(tick)(tick)
Batch processing for big amount of data (more than 100 products)(error)(error)(tick)
Email reporting(error)(error)(tick)
Export from the recommendation engine(error)(tick)(error)
Editor based models update(error)(tick)(error)
Test tool with format validation and error handling(error)(tick)(error)
Deletes the given item from the item store(error)(tick)(error)

Specification for Import/Export interfaces one can find in the developer guide
Developer Guide Chapter 3a. Data Import, Items

Next chapter
11b. User Attribute Import















  • No labels