Check-out and Cross-sell
Boost cross-sell features and checkout pages with sponsored listings. Send auction requests to Topsort with potential product_ids
, and receive winning products.
Example Implementation
Display three suggested products during the app checkout process. Select 20 organic candidates related to cart items and send an auction request with a slots
parameter of 3 to get at least 3 winners. If fewer winners are found, use organic results. Use the location
parameter for vendors to create targeted campaigns, ensuring separate conversion rates and unaffected quality scores.
Request
Example auction request with 3 sponsored listings slots on the checkout page
{
"auctions": [
{
"type": "listings",
"slots": 3,
"products": {
"ids": [
"p_PJbnN",
"p_ojng4",
"p_8VKDt",
"p_Mfk15"
]
}
}
]
}
Response
The response includes 3 suggested products for the checkout process. If no winners or errors occur, display only organic results. A boolean variable, error, indicates auction success.
Example API V2 response in JSON format:
{
"results": [
{
"winners": [
// winner details
],
"error": false
},
]
}