Please note that the priority way of placing the product recommendations blocks on the site is to insert the DIV tag created in the PersonaClick account and fill it automatically with the PersonaClick library. The instruction below is intended for exceptional cases when an automatic drawing of the block doesn't give the maximum necessary functionality.
Unique code of the recommendation block. See this value in the "data-recommender-code" attribute of the block created in PersonaClick account.
params
object
required
Object with request parameters.
success
function
required
A callback function, to which the API response will be passed. Response type: object.
error
function
optionally
A callback function that will be called when an error occurs (any HTTP status code other than 200).
Request parameters
Name
Type
Requirement
Description
item
number/string
required in some cases
Product ID. This parameter is mandatory for the requests of blocks that use the algorithms "Similar" and "Also bought".
exclude
array
optionally
Product IDs array, which should be excluded from the recommended products list.
category
number/string
required in some cases
Category ID. This parameter is mandatory for all blocks set on category pages.
search_query
string
required in some cases
The text of the search query. This parameter is mandatory for the requests of blocks that use the "Search" algorithm.
limit
number
optionally
A maximum number of products in the API response.
locations
array
optionally
Array with location IDs. If used, the API response will return products available in the listed locations. Locations must be specified in the XML product feed.
brands
array
optionally
Array with brand names. If used, only the products of the listed brands will be returned in the API response. Brands must be specified in the XML product feed.
exclude_brands
array
optionally
Array with brand names. If used, the API response will exclude the products of the listed brands. Brands must be specified in the XML product feed.
categories
array
optionally
Array with category IDs. If used, the API response will only return products that are included in the listed categories.
discount
boolean
optionally
If used with "true" value, then only those products, the value of which is less than the "oldprice" value, will be returned in the API response. The old price must be specified in the XML product feed.
API response
Name
Type
Description
html
string
HTML-code of the block with products. The template is customized in the PersonaClick account.
title
string
The block title. Corresponds to the value of the "Action" element in the block rules.
products
array
Array with product IDs.
id
number
Unique block identifier. Corresponds to the block ID in the list of blocks in the PersonaClick account.
Example request for product recommendations
personaclick("recommend", "1fd1b3495137bc3c9299816026acf36f", {item: 100500, exclude: [3, 14, 159, 26535], category: 146, search_query: "To be or not to be", limit: 15, brands: ["Alas", "poor", "Yorick"], categories: [1, 146, 100500]}, function(response) {
// the functionality of rendering a block of product recommendations
}, function(error) {
// when something went wrong
});
Every tool is available as an additional option in paid subscription plans. In case of any technical questions, please contact us at support@personaclick.com.