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

# Listings sponsorisés dans les résultats de recherche

> Apprenez à utiliser les listings sponsorisés sur les résultats de recherche

L'exemple de cette page montre comment organiser des [enchères](/en/ad-server/auctions/auctions-api) pour des produits provenant de résultats de recherche.

Il existe deux façons d'organiser ce type d'enchères :

* En utilisant le paramètre `searchQuery`, où seules les enchères qui ciblent des produits avec des mots-clés correspondants auront une chance de gagner de telles enchères.
* En utilisant un [ensemble de produits](/en/api-reference/examples/sponsored-listings/set-of-products) et en utilisant en plus le paramètre `searchQuery` pour élargir la liste des enchères en ajoutant des produits avec des mots-clés correspondants à ceux de l'ensemble de produits.

## Cas d'utilisation

L'organisation de ce type d'enchères sur les pages de recherche permettra à vos vendeurs de promouvoir des produits dans les résultats de recherche.

## Exemple d'appel API

### Requête : utilisation de `searchQuery`

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

La requête ci-dessus créera une seule enchère de listings :

* Elle aura un maximum de deux gagnants en raison du champ `slots`.
* Le champ `searchQuery` détermine quels mots-clés les cibles d'enchères doivent avoir.

Seules les enchères qui ciblent des produits avec le mot-clé `Running shoes` peuvent participer à cette enchère.

### Réponse

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

À noter ici :

* Le type des gagnants est `product`, car nous organisons une enchère de listings.
* Il y a deux gagnants, le maximum autorisé par le champ `slots` dans la requête.

### Requête : combinaison de produits et `searchQuery`

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

La requête ci-dessus créera une seule enchère de listings :

* Elle aura un maximum de deux gagnants en raison du champ `slots`.
* Le champ `searchQuery` détermine quels mots-clés les cibles d'enchères doivent avoir.

Les produits participant à ces enchères seront `"p_ojng4"`, `"p_8VKDt"`, `"p_Mfk15"` et ceux avec un mot-clé correspondant à la `searchQuery`.

### Réponse

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

Commentaires notables :

* Le type des gagnants est `product`, car nous organisons une enchère de listings.
* Il y a deux gagnants, le maximum autorisé par le champ `slots` dans la requête.
* Le gagnant au rang 1 `"p_Mfk15"` provient de l'ensemble de produits et le rang 2 `"p_PJbnN"` provient des mots-clés correspondants
  puisque son `id` n'a pas été spécifié dans la requête d'enchère.

<Note>
  L'organisation d'enchères en utilisant le paramètre `searchQuery` améliore Topsort pour optimiser
  l'algorithme de correspondance de mots-clés.
</Note>

<Warning>
  L'utilisation de ce type d'enchères ne permet pas d'utiliser les **scores de qualité**.
</Warning>

## Étapes suivantes

Les gagnants devront être combinés avec les données de produit pour créer un résultat qui peut être affiché à l'utilisateur final.

Consultez [cette page](/en/api-reference/examples/sponsored-listings/combining-results) pour un exemple.