> ## 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.

# Banners Patrocinados en Carruseles y Swimlanes

> Crear carruseles y swimlanes con banners de Topsort

## Carruseles y Swimlanes de Banners

Puede crear carruseles y swimlanes usando Banners solicitando una subasta para banners y especificando el número de banners que necesita para el carrusel o swimlane. Los candidatos de banner serán las campañas de banner creadas para el `slotId` relacionado con el carrusel o swimlane. Topsort devolverá el `product id` de los ganadores y los assets con enlaces a creativos que se agregarán al carrusel o swimlane.

<Note>
  También puede crear un solo espacio de banner para el carrusel o swimlane, y
  solicitar 3 resultados de la subasta.
</Note>

Por ejemplo, suponga que tiene una página de destino "Regreso a Clases" con un carrusel que presenta tres campañas de diferentes marcas. Cuando un visitante llega a esta página, hará una solicitud con el parámetro `slots` establecido en 3 para que Topsort pueda proporcionar al menos tres ganadores. Después de recibir los ganadores, puede agregar los tres anuncios de banner al carrusel. Si hay menos de tres ganadores, puede agregar una imagen de respaldo para las promociones de su marketplace o mostrar solo uno o dos banners.

## Solicitud

Aquí hay un ejemplo de solicitud de subasta para un carrusel con tres espacios de banner dirigidos a marcas:

```json theme={null}
{
  "auctions": [
    {
      "type": "banners",
      "slots": 3,
      "slotId": "backtoschool-carousel"
    }
  ]
}
```

## Respuesta

La respuesta incluirá tres productos que puede mostrar en el carrusel, clasificados por los resultados de la subasta. Si no hay ofertas calificadas (sin ganadores) o si hubo un error, la respuesta estará vacía. En este caso, solo puede mostrar los resultados orgánicos. Una nueva variable booleana, **error**, indica si la subasta se resolvió con éxito.

Aquí hay un ejemplo de la respuesta para una llamada con una solicitud de subasta usando la API V2 en formato JSON:

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "brand",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        },
        {
          "rank": 2,
          "type": "brand",
          "id": "p_8VKDt",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_Paesa2N-1x.png"
            }
          ]
        },
        {
          "rank": 3,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbasnx-2x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
```