Recoms using Javascript SDK

Usage

To load any recommendations from Hello Retail you need to use the loadRecom method.

hrq = window.hrq || [];
hrq.push([
    "loadRecom",
    requests,
    callback
]);

The different arguments shown above are described below.

Argument	Description
requests	A list of RecomRequest for product recommendations. Each request will be processed, and the response will contain a list of responses in the same order as the given requests. Products will not be repeated within the responses to one API call
callback(result)	A callback function that is called with the result of the request

The loadRecom method uses the recom REST API un under the hood. Each RecomRequest in the list must follow the structure that is documented in the documentation for the REST API. The method can be used to load both managed and unmanaged recoms

Examples

General example

hrq = window.hrq || [];
hrq.push([
    "loadRecom",
    // requests:
    [
        {
            // Managed recom
            "key": "k6449296dbbc4cd233cac2276",
            "format":"html",
            "context": {
                "hierarchies":[["Clothing","Women"]],
                "brand": "Nike",
                "urls": ["https://kevinvapes.test/"]
            }
        },
        // Unmanaged recom
        {
            "trackingKey":"frontpage-1",
            "fields":["title","url"],
            "hideAdditionalVariants":true,
            "count":8,
            "context":{
                "urls": ["https://kevinvapes.test/"]
            },
            "sources":[
                {
                    "type":"RETARGETED",
                    "limit": 2
                },
                {
                    "type":"TOP",
                    "filters":{
                        "hierarchies":{"$in":[["Clothing", "Woman"]]}
                    }
                }
            ]
        }
    ]
    // Callback
    function(result) {
        // Do something with data here.
        if (!result.success) {
            console.error(result.message);
            return;
        } 
        for(let i = 0; i<result.results.length; i++) {
            console.log(result.results[i]);
        }
    }
]);

The returned result also follows the structure that is documented in the documentation for the REST API.