Saltar para o conteúdo principal

​
Carrosséis e Swimlanes de Banners

Você pode criar carrosséis e swimlanes usando Banners solicitando um leilão para banners e especificando o número de banners necessários para o carrossel ou swimlane. Os candidatos de banner serão as campanhas de banner criadas para o slotId relacionado ao carrossel ou swimlane. A Topsort retornará o product id dos vencedores e os assets com links para criativos que serão adicionados ao carrossel ou swimlane.
Você também pode criar um único espaço de banner para o carrossel ou swimlane, e solicitar 3 resultados do leilão.
Por exemplo, suponha que você tenha uma página de destino “Volta às Aulas” com um carrossel que apresenta três campanhas de marcas diferentes. Quando um visitante chega a esta página, você fará uma solicitação com o parâmetro slots definido como 3 para que a Topsort possa fornecer pelo menos três vencedores. Após receber os vencedores, você pode adicionar os três anúncios de banner ao carrossel. Se houver menos de três vencedores, você pode adicionar uma imagem de fallback para as promoções do seu marketplace ou exibir apenas um ou dois banners.

​
Solicitação

Aqui está um exemplo de solicitação de leilão para um carrossel com três espaços de banner direcionados a marcas: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 3,
      "slotId": "backtoschool-carousel"
    }
  ]
}

​
Resposta

A resposta incluirá três produtos que você pode exibir no carrossel, classificados pelos resultados do leilão. Se não houver ofertas qualificadas (sem vencedores) ou se houve um erro, a resposta estará vazia. Neste caso, você pode apenas exibir os resultados orgânicos. Uma nova variável booleana, error, indica se o leilão foi resolvido com sucesso. Aqui está um exemplo da resposta para uma chamada com uma solicitação de leilão usando a API V2 em formato JSON: 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "brand",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        },
        {
          "rank": 2,
          "type": "brand",
          "id": "p_8VKDt",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_Paesa2N-1x.png"
            }
          ]
        },
        {
          "rank": 3,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbasnx-2x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}