as Banners

Topsort allows you to target brands, products, vendors, and URLs in brand campaigns. Easily create Sponsored Brands ads by selecting vendor and brand pages as the destination. Sponsored Brands promote brands, restaurants, hotels, agencies, etc., rather than individual products. Use banner ads or sponsored listings as building blocks, depending on your marketplace infrastructure.

Display Sponsored Brand ads on search results, category pages, or the homepage. Make auction requests the same way as for sponsored listings.

Request

To show one sponsored brand on the "popular brands" page, use this auction request:

jsonCopy code
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "popular_brands_top",
      "device": "desktop"
    }
  ]
}

Response

The response includes auction results, providing the product_id of the winning brand. An empty response occurs if there are no winners or an error. In such cases, append organic results. A boolean variable, error, indicates successful auction resolution.

Example API V2 JSON-format response:

jsonCopy code
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "brand",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false}
  ]
}