Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Method Objective
| Note |
|---|
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. |
Syntax and
methodparameters
| Code Block | ||
|---|---|---|
| ||
personaclick("recommend", code, params, success, error); |
| Name | Type | Requirement | Description |
|---|---|---|---|
| code | string | required | 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. |
| brands | array | optionally | Array with brand names. If used, only the products of the listed brands will be returned in the API response. |
| exclude_brands | array | optionally | Array with brand names. If used, the API response will exclude the products of the listed brands. |
| 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. |
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 recommendationsof use
| Code Block | ||||
|---|---|---|---|---|
| ||||
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
}); |
| Table of Contents |
|---|