> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auction Types

> Understanding different auction mechanisms in Topsort

export const LastUpdated = ({date, lang = "en"}) => {
  const translations = {
    en: "Last updated:",
    es: "Última actualización:",
    pt: "Última atualização:",
    fr: "Dernière mise à jour:",
    de: "Zuletzt aktualisiert:"
  };
  const label = translations[lang] || translations.en;
  return <>
<style>{`
.last-updated-component {
display: inline-flex;
align-items: center;
gap: 8px;
padding: 10px 16px;
border-radius: 8px;
margin-top: 12px;
margin-bottom: 16px;
font-size: 14px;
background-color: rgba(0, 0, 0, 0.05);
border: 1px solid rgba(0, 0, 0, 0.12);
color: rgba(0, 0, 0, 0.75);
line-height: 1;
}

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

## Sponsored Listings

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored listings integrate promoted products into search results or category
  pages. These auctions allow vendors to promote specific products within
  relevant contexts. The `/auctions` endpoint is used to run these auctions.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  There are three main types of sponsored listings:
</div>

1. **Sponsored listings from a set of products:** This allows auctions for a predefined set of product IDs. Only bids targeting these specific products will participate. You can also include custom quality scores for each product in the request, which are numbers between 0 and 1 indicating relevance.
2. **Sponsored listings on category pages:** These auctions are for products belonging to specific categories. Only bids that target products within the given categories will be considered. Categories can be specified using a single ID, multiple IDs (all categories), or disjunctions (at least one of the categories).
3. **Sponsored listings in search results:** These auctions are for products relevant to search queries. You can use the `searchQuery` parameter, or combine it with a predefined set of products to expand the list of bids.

## Sponsored Banners

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored banners enable the creation of auctions for banner advertisements on
  various pages, like homepages or landing pages. They can be used for homepage
  sliders, featured brands, and carousels. The `/auctions` endpoint is used for
  banner auctions, with the `type` field set to `"banners"`.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Banner auctions can be targeted based on:
</div>

1. **Landing Pages:** Create slots for high-traffic homepages or custom landing pages with unique SlotIDs, names, URLs, and image dimensions.
2. **Category and Search:** Allow vendors to target specific categories or keywords using the `categoryId` or `searchQuery` fields in the auction request.
3. **Carousels and Swimlanes:** Multiple banner winners can be requested for carousels or swimlanes by specifying the desired number of slots in the auction request.

## Video Ads

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Video ads are designed to enhance brand and product experience by showing
  products in action, boosting visibility, and engaging customers. Campaign
  creation for video ads mirrors that of banner ads, allowing for video upload
  and campaign configuration. Supported video formats include MP4 and MOV, with
  a duration of 6 to 20 seconds and a maximum size of 200MB. Marketplaces send a
  slot ID and optional details in the auction request and receive a video URL in
  the response.
</div>

## Sponsored Brands

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Sponsored brands auctions allow for the promotion of brands using assets,
  text, and an associated product. The dedicated endpoint for these auctions is
  `/auctions/sponsored-brand`. Key fields in the request include `winners`
  (maximum number of winners), `placementId` (ID of the ad placement), and
  `triggers.products.ids` (array of associated product ID).
</div>

## Travel Listings

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Travel listings involve a new auction endpoint and campaign model specifically
  designed for the travel use case, such as hotels and flights. This type of
  auction considers unique parameters like `travel_window` (timeframe for
  travel), `day_of_check_in`, and `types_of_travelers` (family, couple, solo,
  group). These parameters can influence bid amounts through multiplier values.
  The auction request for travel listings includes details such as `type`
  (hotels or flights), `winners`, `products` (with IDs and optional quality
  scores/prices), and a `travelContext` object with relevant travel-specific
  information.
</div>

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Check the [Auctions API](/en/ad-server/auctions/auctions-api) section in the
  Integration Guide for more information and examples on how to create Auctions.
</div>

***

<LastUpdated date="2025-11-18" />