Homepage, Custom Pages

High-visibility locations like the homepage and landing pages (specially crafted standalone pages for marketing purposes) are excellent choices for displaying relevant and engaging banner ads.

To serve banner ads on these pages, start by configuring your banner slots. When making auction requests for landing pages, ensure that the category and searchQuery fields are left empty.

Here's an example with only one banner slot on the search results page on desktop:

{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "backtoschool_banners_top",
     	"device”: “desktop"
    }
  ]
}

You can see a sample response with everything you need to serve the banner ads.

{
  "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
    }
  ]
}