Passer au contenu principal
L’exemple de cette page montre comment organiser des enchères 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 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

{
  "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

{
  "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

{
  "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

{
  "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.
L’organisation d’enchères en utilisant le paramètre searchQuery améliore Topsort pour optimiser l’algorithme de correspondance de mots-clés.
L’utilisation de ce type d’enchères ne permet pas d’utiliser les scores de qualité.

​
É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 pour un exemple.