Saltar al contenido principal
En este ejemplo usaremos la API para ejecutar una subasta para un conjunto de productos. Solo las ofertas que se dirijan a los productos en este conjunto tendrán la oportunidad de ganar esta subasta. Las ofertas que se dirijan a otros productos no participarán. Esto le permite un control completo sobre qué productos se muestran y dónde, mientras aún permite a sus vendedores promover productos.

​
Casos de uso

No prescribimos cómo crear su conjunto de productos, puede usar cualquier algoritmo que desee. Todo lo que necesitamos es una lista de IDs de productos. Por ejemplo, use su propio algoritmo para generar:
  • Ventas cruzadas.
  • Productos relacionados.
  • Ventas adicionales en el checkout.
Recopile los IDs resultantes y páselos a una subasta. Sus vendedores podrán entonces ofertar por oportunidades para aparecer en posiciones valiosas en el marketplace.

​
Ejemplo de llamada API

​
Solicitud

Supongamos que usamos algún tipo de algoritmo para crear un conjunto de IDs de productos. Luego podemos pasarlos a una solicitud de subasta: 
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": ["p_PJbnN", "p_ojng4", "p_8VKDt", "p_Mfk15"]
      }
    }
  ]
}
La solicitud anterior creará una sola subasta de listings:
  • Tendrá un máximo de dos ganadores debido al campo slots.
  • El products.ids es el conjunto de productos. Estos deben existir en su catálogo.
Como se dijo antes, solo las ofertas que se dirijan a estos productos participarán en la subasta. El endpoint de subastas admite hasta 10000 IDs de productos por subasta, pero recomendamos enviar no más de los 500 más relevantes.

​
Agregar quality scores personalizados

Es posible que a veces desee incorporar quality scores personalizados para cada producto. El quality score es un número entre 0 y 1 que codifica la relevancia de los productos participantes. El uso de quality scores ayuda a mitigar riesgos y pérdidas debido a que productos no relevantes ganen subastas. Para incluir quality scores personalizados en la solicitud, modifique el campo products como se muestra a continuación: 
{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": ["p_PJbnN", "p_ojng4", "p_8VKDt", "p_Mfk15"],
        "qualityScores": [0.5, 0.4, 0.7, 0.6]
      }
    }
  ]
}
En este ejemplo:
  • El producto p_PJbnN tiene un quality score de 0.5.
  • El producto p_ojng4 tiene un quality score de 0.4.
  • El producto p_8VKDt tiene un quality score de 0.7.
  • El producto p_Mfk15 tiene un quality score de 0.6.
Importante: El número de quality scores debe coincidir con el número de IDs de productos. Si no coinciden, la solicitud fallará. Advertencia: No puede incluir quality scores y una consulta de búsqueda. Aunque se permite ejecutar una subasta con una consulta de búsqueda y un conjunto de productos, la solicitud no puede incluir quality scores personalizados.

​
Respuesta

No almacene en caché esta respuesta ni sus resultados. Las subastas deben ser únicas por vista de página, esto es lo que hace que el sistema funcione.Si los resultados de la subasta se almacenan en caché, los mismos resultados podrían mostrarse a múltiples usuarios o al mismo usuario varias veces.
Si existen ofertas dirigidas a los productos, podrían ganar esta subasta. La respuesta resultante se vería algo así: 
{
  "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.
  • Ambos id ganadores corresponden a un ID de producto en la solicitud.
  • Hay dos ganadores, el máximo permitido por el campo slots en la solicitud.

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