Saltar al contenido principal
El ejemplo en esta página muestra cómo ejecutar subastas para productos que se originan en resultados de búsqueda. Hay dos formas de ejecutar este tipo de subastas:
  • Usando el parámetro searchQuery, donde solo las ofertas que se dirijan a productos con palabras clave coincidentes tendrán la oportunidad de ganar tales subastas.
  • Usando un conjunto de productos y adicionalmente usar el parámetro searchQuery para expandir la lista de ofertas agregando productos con palabras clave coincidentes a los del conjunto de productos.

​
Casos de uso

Ejecutar este tipo de subastas en páginas de búsqueda permitirá a sus vendedores promover productos dentro de los resultados de búsqueda.

​
Ejemplo de llamada API

​
Solicitud: usando searchQuery

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "searchQuery": "Running shoes"
    }
  ]
}
La solicitud anterior creará una sola subasta de listings:
  • Tendrá un máximo de dos ganadores debido al campo slots.
  • El campo searchQuery determina qué palabras clave deben tener los objetivos de oferta.
Solo las ofertas que se dirijan a productos con la palabra clave Running shoes pueden participar en esta subasta.

​
Respuesta

{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
Notable aquí:
  • El tipo de los ganadores es product, porque estamos ejecutando una subasta de listings.
  • Hay dos ganadores, el máximo permitido por el campo slots en la solicitud.

​
Solicitud: combinando productos y searchQuery

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": [
          "p_ojng4",
          "p_8VKDt",
          "p_Mfk15"
        ]
      }
      "searchQuery": "Running shoes"
    }
  ]
}
La solicitud anterior creará una sola subasta de listings:
  • Tendrá un máximo de dos ganadores debido al campo slots.
  • El campo searchQuery determina qué palabras clave deben tener los objetivos de oferta.
Los productos que entran en esta subasta serán "p_ojng4", "p_8VKDt", "p_Mfk15" y aquellos con una palabra clave que coincida con searchQuery.

​
Respuesta

{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
Comentarios notables:
  • El tipo de los ganadores es product, porque estamos ejecutando una subasta de listings.
  • Hay dos ganadores, el máximo permitido por el campo slots en la solicitud.
  • El ganador en el rango 1 "p_Mfk15" proviene del conjunto de productos y el rango 2 "p_PJbnN" proviene de palabras clave coincidentes ya que su id no se especificó en la solicitud de subasta.
Ejecutar subastas usando el parámetro searchQuery mejora a Topsort para mejorar el algoritmo de coincidencia de palabras clave.
Usar este tipo de subastas no permite usar quality scores.

​
Próximos pasos

Los ganadores deberán combinarse con datos de productos para crear un resultado que pueda mostrarse al usuario final. Consulte esta página para ver un ejemplo.