Mixed Strategy

Prev Next

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.

The duplicated items are removed automatically in the Mixed Strategy algorithm.

Endpoint

GET https://recommendation.api.useinsider.com/v2/mixed

Query Parameters

ParameterSample ValueDescriptionData TypeRequired
partnerNamemybrandPartner Identifier assigned by Insider. You can use PartnerID as well.StringYes
localeus_USLocale of requested product catalog.StringYes
platformwebRequested platform. Web comes by default.EnumNo
currencyUSDRequested currency of the products. If no value is set, the default currency in your settings is used.StringYes
size50Required number of items in response. Valid values are 0 to 100.IntegerNo
categoryList[“Clothes”, “Skirts”]Category filter of the productsArray (of string)No
filter
Smart Recommender filtering. There can be more than one filter parameter.StringNo
detailstrueAdds details to the products of the response.BooleanNo
shufflefalseShuffles the products of the response.BooleanNo
getGroupProductsfalseShows variant products under the products of the response.BooleanNo
groupProductsFields
Adds these fields to the variant products’ details.StringNo
excludeVariantstrueExclude variants from the response.BooleanNo
strategy[{"recommendationType":"rvp","size":1}, {"recommendationType":"ub","size":2}]
List of strategies.StringYes
userIdtestUserUser IDStringNo
hpfalse, true, or 0, 1Makes affinities affect products of the response. The default is false.
BooleanNo
excludeViewDay
30After how many days viewed products should be excluded. The default is -1.
IntegerNo (Can only be used with userId)
excludeViewItem
10How many viewed products should be excluded. The default is -1.
IntegerNo (Can only be used with userId)
excludePurchaseDay
30After how many days purchased products should be excluded. The default is -1.
IntegerNo (Can only be used with userId)
excludePurchaseItem
10How many purchased products should be excluded. The default is -1.
IntegerNo (Can only be used with userId)
countryGermanyRequested country information
StringNo (Only for Location Based Top Sellers usage in Mixed Strategy)
cityHamburgRequested city information
StringNo (Only for Location Based Top Sellers usage in Mixed Strategy)
dayLimit
7Threshold last update day value for Publisher partners (The default is 2 days.)
IntegerNo
ulvtrue, falseEnables User Last Visit to affect recommendation results
BooleanNo
You need to add the necessary query parameters for the strategy or strategies you are using.

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

AlgorithmAbbreviation
Chefchef
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 Basedub
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}&currency={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.