> ## 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 Listings auf Kategorieseiten

Die Beispiele auf dieser Seite zeigen, wie Sie [Auktionen](/en/ad-server/auctions/auctions-api) für Produkte durchführen, die zu bestimmten [Kategorien](/en/ad-server/catalog/product-feed) gehören.

Nur Gebote, die auf Produkte abzielen, die zu den angegebenen Kategorien gehören, haben eine Chance, diese Auktionen zu gewinnen. Gebote, die auf Produkte aus anderen Kategorien abzielen, werden nicht teilnehmen.

## Anwendungsfall

Die Durchführung dieser Art von Auktionen auf Suchseiten ermöglicht es Ihren Verkäufern, Produkte auf Kategorieseiten zu bewerben.

<Note>
  **Nicht-traditionelle Kategorien:**

  Unser Katalogsystem macht keine Annahmen darüber, was eine Kategorie ist.

  Wenn Ihr Marketplace beispielsweise Ferienhäuser betrifft, könnten Kategorien geografische Standorte anstelle von Produktgruppen sein.
</Note>

## Kategorien angeben

Der `/auctions` Endpoint unterstützt mehrere Möglichkeiten, Kategorien anzugeben.

Beim Erstellen einer Auktion müssen Sie **eine** der folgenden Methoden wählen:

| Methode            | Relevantes Feld         | Beschreibung                                                                                                                                                                    |
| :----------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Einzelne Kategorie | `category.id`           | Gebotsziele müssen zur Kategorie gehören. Die `id` der Kategorie ist der gleiche Wert, der beim [Product Upsert](/en/api-reference/catalog-api/upsert-products) verwendet wird. |
| Alle Kategorien    | `category.ids`          | Gebotsziele müssen zu **allen** Kategorien gehören.                                                                                                                             |
| Disjunktionen      | `category.disjunctions` | Gebotsziele müssen zu mindestens **einer** der Kategorien in der Disjunktion gehören.                                                                                           |

Schauen wir uns einige Beispiele an.

## API-Aufruf-Beispiele

### Anfrage: Einzelne Kategorie

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "laptop_bags"
      }
    }
  ]
}
```

Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:

* Aufgrund des `slots`-Feldes maximal zwei Gewinner hat.
* Nur Gebote zulässt, die auf Produkte in einer einzelnen Kategorie abzielen. Die Kategorie-ID wird im `category.id`-Feld angegeben.

In diesem Fall können nur Gebote, die auf Produkte in der Kategorie `laptop_bags` abzielen, an der Auktion teilnehmen.

### Anfrage: Alle Kategorien

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "ids": ["summer_hats", "sale"]
      }
    }
  ]
}
```

Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:

* Aufgrund des `slots`-Feldes maximal zwei Gewinner hat.
* Nur Gebote zulässt, die auf Produkte abzielen, die zu **allen Kategorien** gehören. Die Kategorie-IDs werden im `category.ids`-Feld angegeben.

<Note>Dieses Feld ist im Plural. Es heißt `ids`, nicht `id`.</Note>

Nur Gebote, die auf Produkte abzielen, die sowohl zu den Kategorien `summer_hats` als auch `sale` gehören, können an dieser Auktion teilnehmen.

### Anfrage: Disjunktionen ("mindestens eine Kategorie")

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "disjunctions": [["large", "medium"]]
      }
    }
  ]
}
```

Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:

* Aufgrund des `slots`-Feldes maximal zwei Gewinner hat.
* Nur Gebote zulässt, die auf Produkte abzielen, die zu **einer der Kategorien in der Disjunktion** gehören. Disjunktionen werden als Arrays von Strings im `category.disjunctions`-Feld angegeben.

Nur Gebote, die auf Produkte in den Kategorien `large` oder `medium` abzielen, können an dieser Auktion teilnehmen.

### Antwort

<Warning>
  **Diese Antwort nicht cachen** oder ihre Ergebnisse. Auktionen müssen pro Seitenaufruf eindeutig sein, das ist es, was das System zum Funktionieren bringt.

  Wenn Auktionsergebnisse gecacht werden, könnten dieselben Ergebnisse mehreren Benutzern oder demselben Benutzer mehrmals angezeigt werden.
</Warning>

Wenn Gebote existieren, die auf Produkte in den entsprechenden Kategorien abzielen, könnte eine Antwort auf eine der obigen Anfragen so aussehen:

```json theme={null}
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
```

Beachten Sie hier:

* Der Typ der Gewinner ist `product`, da wir eine Listings-Auktion durchführen.
* Es gibt zwei Gewinner, das Maximum, das durch das `slots`-Feld in der Anfrage erlaubt ist.

## Nächste Schritte

Die Gewinner müssen mit Produktdaten kombiniert werden, um ein Ergebnis zu erstellen, das dem Endbenutzer angezeigt werden kann.

Siehe [diese Seite](/en/api-reference/examples/sponsored-listings/combining-results) für ein Beispiel.