> ## 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 em páginas de categoria

> Trabalhar com categorias de produtos no ecossistema da Topsort

## Anúncios de Banner em Páginas de Categoria

Para exibir anúncios de banner em páginas de categoria, o processo é similar ao das páginas de resultados de busca. Em vez de usar o campo `searchQuery`, você deve usar o campo `category` na sua solicitação de leilão.

Existem três opções para especificar a categoria de marcas, produtos ou vendedores que participam do leilão:

* Categoria Única
* Múltiplas Categorias
* Disjunções de Categoria

### Exemplo de Solicitação - Banner de Categoria Única

Receba até 5 resultados de leilão em 1 chamada de API

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

### Exemplo de Resposta - Categoria

```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
    }
  ]
}
```

### Exemplo: Disjunções de Categoria

As disjunções de categoria permitem direcionar múltiplas categorias em uma única solicitação de leilão. Você pode especificar várias categorias e o leilão considerará anúncios de qualquer uma dessas categorias. Isso é útil quando você deseja exibir anúncios de banner que sejam relevantes para várias categorias em uma página específica.

Aqui está uma solicitação de leilão com um único espaço de banner direcionado às categorias de botas de caminhada e tênis de corrida usando disjunções de categoria:

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

A resposta de amostra abaixo inclui todas as informações necessárias para servir os anúncios 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>
  Você pode solicitar **até 5 leilões** em uma única solicitação. Se você tiver múltiplos
  espaços de banner nas suas páginas de categoria, pode solicitar leilões para
  eles em uma única chamada.
</Note>