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

# Gesponserte Banner auf Kategorieseiten

> Arbeiten mit Produktkategorien im Topsort-Ökosystem

## Banner-Anzeigen auf Kategorieseiten

Um Banner-Anzeigen auf Kategorieseiten anzuzeigen, ist der Prozess ähnlich wie bei Suchergebnisseiten. Anstatt das `searchQuery`-Feld zu verwenden, müssen Sie das `category`-Feld in Ihrer Auktionsanfrage verwenden.

Es gibt drei Optionen zur Angabe der Kategorie der an der Auktion teilnehmenden Marken, Produkte oder Verkäufer:

* Einzelne Kategorie
* Multiple Kategorien
* Kategorie-Disjunktionen

### Beispielanfrage - Einzelne Kategorie-Banner

Erhalten Sie bis zu 5 Auktionsergebnisse in 1 API-Aufruf

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

### Beispielantwort - Kategorie

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

### Beispiel: Kategorie-Disjunktionen

Kategorie-Disjunktionen ermöglichen es Ihnen, mehrere Kategorien in einer einzigen Auktionsanfrage anzusprechen. Sie können mehrere Kategorien angeben, und die Auktion berücksichtigt Anzeigen aus einer dieser Kategorien. Dies ist nützlich, wenn Sie relevante Banner-Anzeigen für verschiedene Kategorien auf einer bestimmten Seite anzeigen möchten.

Hier ist eine Auktionsanfrage mit einem einzelnen Banner-Slot, der sowohl Wanderschuh- als auch Laufschuh-Kategorien mit Kategorie-Disjunktionen anspricht:

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

Die untenstehende Beispielantwort enthält alle Informationen, die zum Bereitstellen der Banner-Anzeigen erforderlich sind:

```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>
  Sie können **bis zu 5 Auktionen** in einer einzigen Anfrage anfordern. Wenn Sie mehrere
  Banner-Slots auf Ihren Kategorieseiten haben, können Sie Auktionen für sie in einem einzigen
  Aufruf anfordern.
</Note>