Sponsored Banners on landing 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
    }
  ]
}

General

Auction examples

Webhook examples

Auctions

Events

Toptimize

Toppie API

Campaign API

Catalog API

Billing API

Reporting API

Invitation API

User API

Webhooks API

Assets API

Segments Service

Offsite Ads API

Forecasting Service

Media API

Placement API

API Reference