> ## 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 in Suchergebnissen

> Erfahren Sie, wie Sie gesponserte Listings in Suchergebnissen verwenden

Das Beispiel auf dieser Seite zeigt, wie Sie [Auktionen](/en/ad-server/auctions/auctions-api) für Produkte aus Suchergebnissen durchführen.

Es gibt zwei Möglichkeiten, diese Art von Auktionen durchzuführen:

* Verwendung des `searchQuery`-Parameters, bei dem nur Gebote, die auf Produkte mit übereinstimmenden Keywords abzielen, eine Chance haben, solche Auktionen zu gewinnen.
* Verwendung eines [Produktsets](/en/api-reference/examples/sponsored-listings/set-of-products) und zusätzliche Verwendung des `searchQuery`-Parameters, um die Liste der Gebote zu erweitern, indem Produkte mit Keywords hinzugefügt werden, die denen im Produktset entsprechen.

## Anwendungsfall

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

## API-Aufruf-Beispiel

### Anfrage: Verwendung von `searchQuery`

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "searchQuery": "Running shoes"
    }
  ]
}
```

Die obige Anfrage erstellt eine einzelne Listings-Auktion:

* Sie hat aufgrund des `slots`-Feldes maximal zwei Gewinner.
* Das `searchQuery`-Feld bestimmt, welche Keywords die Gebotsziele haben müssen.

Nur Gebote, die auf Produkte mit dem Keyword `Running shoes` abzielen, können an dieser Auktion teilnehmen.

### Antwort

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

### Anfrage: Kombination von Produkten und `searchQuery`

```json theme={null}
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": [
          "p_ojng4",
          "p_8VKDt",
          "p_Mfk15"
        ]
      }
      "searchQuery": "Running shoes"
    }
  ]
}
```

Die obige Anfrage erstellt eine einzelne Listings-Auktion:

* Sie hat aufgrund des `slots`-Feldes maximal zwei Gewinner.
* Das `searchQuery`-Feld bestimmt, welche Keywords die Gebotsziele haben müssen.

Die an diesen Auktionen teilnehmenden Produkte sind `"p_ojng4"`, `"p_8VKDt"`, `"p_Mfk15"` und solche mit einem Keyword, das zur `searchQuery` passt.

### Antwort

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

Bemerkenswerte Kommentare:

* 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.
* Der Gewinner auf Rang 1 `"p_Mfk15"` stammt aus dem Produktset und Rang 2 `"p_PJbnN"` stammt aus den übereinstimmenden Keywords,
  da seine `id` nicht in der Auktionsanfrage angegeben wurde.

<Note>
  Die Durchführung von Auktionen mit dem `searchQuery`-Parameter verbessert Topsort, um
  den Keyword-Matching-Algorithmus zu optimieren.
</Note>

<Warning>
  Die Verwendung dieser Art von Auktionen erlaubt nicht die Verwendung von **Quality Scores**.
</Warning>

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