Inspire Widget


epoq Inspire generates relevant recommendations that provide inspiration for the online shop. To this end, the click and purchase behavior of every shop visitor is recorded in a knowledge base and processed into a history. Using a self-learning technology, the shop visitor is presented with product or content recommendations that match the interest.

  1. For the setup of the Recommendation Engine we need your product catalog in XML or CSV format.
  2. We provide you with the tracking code for the connection to our knowledge base, which you integrate into your online shop.
  3. You will receive a code snippet as a placeholder for the front end of the relevant recommendations, which you integrate into your online shop. It does not matter which shop system you work with. The Inspire widgets can be integrated on different pages of your shop.
  4. The relevant recommendations are checked in detail in the test system and different strategies are set up in consultation with you.
  5. After a short learning phase, the relevant recommendations are personalized and activated in the online shop after your approval.

The relevant recommendations can not only be played out in the online shop, but also in print elements and emails.


Technical Integration

In order to display the epoq Inspire widget, a <div> placeholder must be created in your HTML templates, which is later dynamically filled with the relevant recommendations.

The widget file is supplied with the epoq tracking file (flow file) so that no further file needs to be integrated in the shop. 

This file can be integrated into both the live and staging systems. epoq can make a distinction between the live and staging systems so that you can view the recommendations on your staging system before they are taken live.

Depending on your requirements, the templates may differ slightly from the standard given below.


Page with recommendations

On the page where the recommendations are to be displayed, the following must be entered:


Inspire <div> Placeholder

//DIV placeholder 

<div id="epoq-widget-WIDGETID" class="epoq-recommendations-widget"></div>

Each Inspire widget has the DOM class "epoq-recommendations-widget". The DOM ID corresponds to the widget ID (assigned by us), which can optionally be prefixed (suggested, see above).


Display with shop-side HTML template via AJAX endpoint

There is a possibility that the Inspire widget will get the layout from your online shop.

To do this, the <div> placeholder must be entered as described above.


Inspire <div> Placeholder

//DIV placeholder 

<div id="epoq-widget-WIDGETID" class="epoq-recommendations-widget"></div>

epoq then calls up your endpoint, where the HTML template for the recommendations can be retrieved. The recommended product IDs are provided in the "id" parameter in the following form:,PRODUCT2,PRODUCT3&headline=HEADLINE


Parameters for AJAX endpoint:

type=widget The HTML for the complete widget (including headline, slider etc.) is expected.
layout The template for the passed widget ID is expected. Thus each widget can have its own layout on the shop side. The layout name can also be transferred from the shop.
id List of product IDs to be displayed.
headline It is possible to set the headline for the widget in the Control Desk. This can then be supplied by us for the template. (optional)

The response should be a JSON response in the following form, containing the actual product IDs returned, with the [data-ordernumber="PRODUCTID"] attribute for the product item in HTML:

JSON Response





 "markup":"<div><div class=\"my-product-item-class\" data-ordernumber=\"PRODUCT1\">ITEM_1_CONTENT<\/div>
<div class=\"my-product-item-class\" data-ordernumber=\"PRODUCT2\">ITEM_2_CONTENT<\/div>
<div class=\"my-product-item-class\" data-ordernumber=\"PRODUCT3\">ITEM_3_CONTENT<\/div>





Was this article helpful?