Executar leilões

​

Antes de começar

1. Obter uma API key para autenticação.
2. Criar várias campanhas, para ter lances disponíveis para os leilões.

​

Solicitação

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

• Os leilões são fornecidos como um array no campo auctions. Você pode fornecer de 1 a 5 leilões em uma única solicitação.
• Cada leilão tem um type que determinará se listings ou banners estão sendo leiloados.
• Cada leilão tem um campo slots, isso determina o número máximo de vencedores do leilão.

​

Resposta

​

Resposta com vencedores

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

• Os resultados do leilão estão sob uma propriedade de nível superior results.
• A ordem dos resultados corresponde à ordem dos leilões.
• Cada resultado tem um array de vencedores. Este array pode estar vazio e nunca será maior que os slots do leilão.
• É possível que os leilões falhem/tenham sucesso independentemente. A flag error indica se um leilão teve sucesso.

• rank um número baseado em 1 que corresponde à sua posição em winners.
• resolvedBidId identificando o lance que fez este vencedor ganhar. Este ID é usado para relacionar o lance aos eventos.

​

Resposta sem vencedores

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

​

Leitura adicional