The Mixed Strategy algorithm creates a customized and mixed recommendation strategy using different recommendation types. It is a way of using different algorithms for each slot of the Recommendation Widget. The mixed strategy allows you to use multiple algorithms in a single recommendation widget on your website. It works best on the main and category pages.
Endpoint
GET https://recommendation.api.useinsider.com/v2/mixed
Query Parameters
| Parameter | Sample Value | Description | Data Type | Required |
|---|---|---|---|---|
| partnerName | mybrand | Partner Identifier assigned by Insider. You can use PartnerID as well. | String | Yes |
| locale | us_US | Locale of requested product catalog. | String | Yes |
| platform | web | Requested platform. Web comes by default. | Enum | No |
| currency | USD | Requested currency of the products. If no value is set, the default currency in your settings is used. | String | Yes |
| size | 50 | Required number of items in response. Valid values are 0 to 100. | Integer | No |
| categoryList | [“Clothes”, “Skirts”] | Category filter of the products | Array (of string) | No |
| filter | Smart Recommender filtering. There can be more than one filter parameter. | String | No | |
| details | true | Adds details to the products of the response. | Boolean | No |
| shuffle | false | Shuffles the products of the response. | Boolean | No |
| getGroupProducts | false | Shows variant products under the products of the response. | Boolean | No |
| groupProductsFields | Adds these fields to the variant products’ details. | String | No | |
| excludeVariants | true | Exclude variants from the response. | Boolean | No |
| strategy | [{"recommendationType":"rvp","size":1}, {"recommendationType":"ub","size":2}] | List of strategies. | String | Yes |
| userId | testUser | User ID | String | No |
| hp | false, true, or 0, 1 | Makes affinities affect products of the response. The default is false. | Boolean | No |
| excludeViewDay | 30 | After how many days viewed products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
| excludeViewItem | 10 | How many viewed products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
| excludePurchaseDay | 30 | After how many days purchased products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
| excludePurchaseItem | 10 | How many purchased products should be excluded. The default is -1. | Integer | No (Can only be used with userId) |
| country | Germany | Requested country information | String | No (Only for Location Based Top Sellers usage in Mixed Strategy) |
| city | Hamburg | Requested city information | String | No (Only for Location Based Top Sellers usage in Mixed Strategy) |
| dayLimit | 7 | Threshold last update day value for Publisher partners (The default is 2 days.) | Integer | No |
| ulv | true, false | Enables User Last Visit to affect recommendation results | Boolean | No |
Strategy
Strategy is used to specify the desired recommendation types and sizes. Strategies are given within an array. Each strategy is an object that contains the keys recommendationType and size. recommendationType indicates the type of recommendation required, while size specifies the quantity needed.
[
{
"recommendationType": "ub",
"size": 2
},
{
"recommendationType": "btb",
"size": 2
},
...
]List of Strategies
| Algorithm | Abbreviation |
|---|---|
| Chef | chef |
| Complementary Products | cp |
| Highest Discounted | hdop |
| Highest Discounted of Category | hdoc |
| Location Based Top Sellers | mpol |
| Manual Merchandising | mm |
| Most Popular | mvop |
| Most Popular of Category | mvoc |
| Most Valuable Products | mvpop |
| Most Valuable Products of Category | mvpoc |
| New Arrivals | naop |
| New Arrivals of the Category | naoc |
| Viewed Together | vtv |
| Purchased Together | btb |
| Purchased with Last Purchased | lpt |
| Substitute Products | sp |
| Top Sellers | mpop |
| Top Sellers of Category | mpoc |
| Trending Products | tpop |
| Trending Products of Category | tpoc |
| User Based | ub |
| Viewed Together | vtv |
Sample Request
The sample below displays a request to the Mixed Strategy algorithm.
GET https://recommendation.api.useinsider.com/v2/mixed?locale={Locale}¤cy={Currency}&partnerName={PartnerName}&strategy=[{"recommendationType":"hdop","size":2}]
Sample Response
{
"success": true,
"total": 2,
"types": {
"hdop": 2
},
"data": [
"XYZ-987789",
"ABC-123321"
]
}Fallback Algorithms
Fallback algorithms are determined by your strategy selections.