> ## 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 páginas de categoría

> Trabajar con categorías de productos en el ecosistema de Topsort

## Anuncios de Banner en Páginas de Categoría

Para mostrar anuncios de banner en páginas de categoría, el proceso es similar al de las páginas de resultados de búsqueda. En lugar de usar el campo `searchQuery`, debe usar el campo `category` en su solicitud de subasta.

Hay tres opciones para especificar la categoría de marcas, productos o vendedores que participan en la subasta:

* Categoría Única
* Múltiples Categorías
* Disyunciones de Categoría

### Ejemplo de Solicitud - Banner de Categoría Única

Reciba hasta 5 resultados de subasta en 1 llamada API

```json theme={null}
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "homepage",
      "device": "mobile",
      "category": {
        "id": "c_yogurt"
      }
    }
  ]
}
```

### Ejemplo de Respuesta - Categoría

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "product",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
```

### Ejemplo: Disyunciones de Categoría

Las disyunciones de categoría le permiten dirigirse a múltiples categorías en una sola solicitud de subasta. Puede especificar múltiples categorías y la subasta considerará anuncios de cualquiera de esas categorías. Esto es útil cuando desea mostrar anuncios de banner que sean relevantes para varias categorías en una página específica.

Aquí hay una solicitud de subasta con un solo espacio de banner dirigido a las categorías de botas de senderismo y zapatos para correr usando disyunciones de categoría:

```json theme={null}
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "categories-ribbon",
      "category": {
        "disjunctions": [["hiking_boots", "running_shoes"]]
      }
    }
  ]
}
```

La respuesta de muestra a continuación incluye toda la información necesaria para servir los anuncios de banner:

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "vendor",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
```

<Note>
  Puede solicitar **hasta 5 subastas** en una sola solicitud. Si tiene múltiples
  espacios de banner en sus páginas de categoría, puede solicitar subastas para
  ellos en una sola llamada.
</Note>