Ejecutar subastas

​

Antes de comenzar

1. Obtener una API key para autenticarse.
2. Crear varias campañas, para tener ofertas disponibles para las subastas.

​

Solicitud

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2
    },
    {
      "type": "banners",
      "slots": 1
    }
  ]
}

• Las subastas se proporcionan como un array en el campo auctions. Puede proporcionar de 1 a 5 subastas en una sola solicitud.
• Cada subasta tiene un type que determinará si se están subastando listings o banners.
• Cada subasta tiene un campo slots, esto determina el número máximo de ganadores de la subasta.

​

Respuesta

​

Respuesta con ganadores

{
  "results": [
    {
      "winners": [
        {
          "rank": "1",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": "2",
          "resolvedBidId": "WyJlX1hKYm5OIiwiMTNiNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0=="
        }
      ],
      "error": false
    },
    {
      "winners": [
        {
          "rank": "1",
          "resolvedBidId": "WyJzb21lLXNsb3QiLCIxM2I1NTgyOC04ZWFkLTQyOTktODMyNy1jZWJiMDAyYTBmYTgiLCJiYW5uZXJzIiwiZGVmYXVsdCIsIiJd=="
        }
      ],
      "error": false
    }
  ]
}

• Los resultados de la subasta están bajo una propiedad de nivel superior results.
• El orden de los resultados corresponde al orden de las subastas.
• Cada resultado tiene un array de ganadores. Este array puede estar vacío y nunca será más que los slots de la subasta.
• Es posible que las subastas fallen/tengan éxito de forma independiente. La bandera error indica si una subasta tuvo éxito.

• rank un número basado en 1 que corresponde a su posición en winners.
• resolvedBidId identificando la oferta que hizo que este ganador ganara. Este ID se usa para relacionar la oferta con los eventos.

​

Respuesta sin ganadores

{
  "results": [
    {
      "winners": [],
      "error": false
    },
    {
      "winners": [],
      "error": false
    }
  ]
}

​

Lectura adicional