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

# Bannières sponsorisées sur les pages de catégories

> Travailler avec les catégories de produits dans l'écosystème Topsort

## Bannières publicitaires sur les pages de catégories

Pour afficher des bannières publicitaires sur les pages de catégories, le processus est similaire à celui des pages de résultats de recherche. Au lieu d'utiliser le champ `searchQuery`, vous devez utiliser le champ `category` dans votre requête d'enchère.

Il existe trois options pour spécifier la catégorie des marques, produits ou vendeurs participant à l'enchère :

* Catégorie unique
* Catégories multiples
* Disjonctions de catégories

### Exemple de requête - Bannière de catégorie unique

Recevez jusqu'à 5 résultats d'enchères en 1 appel API

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

### Exemple de réponse - Catégorie

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

### Exemple : Disjonctions de catégories

Les disjonctions de catégories vous permettent de cibler plusieurs catégories dans une seule requête d'enchère. Vous pouvez spécifier plusieurs catégories et l'enchère prendra en compte les annonces de l'une de ces catégories. Cela est utile lorsque vous souhaitez afficher des bannières publicitaires pertinentes pour diverses catégories sur une page spécifique.

Voici une requête d'enchère avec un seul emplacement de bannière ciblant à la fois les catégories de chaussures de randonnée et de chaussures de course en utilisant des disjonctions de catégories :

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

L'exemple de réponse ci-dessous comprend toutes les informations nécessaires pour diffuser les bannières publicitaires :

```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>
  Vous pouvez demander **jusqu'à 5 enchères** dans une seule requête. Si vous avez plusieurs
  emplacements de bannières sur vos pages de catégories, vous pouvez demander des enchères pour eux en un seul
  appel.
</Note>