Saltar al contenido principal

​
Carruseles y Swimlanes de Banners

Puede crear carruseles y swimlanes usando Banners solicitando una subasta para banners y especificando el número de banners que necesita para el carrusel o swimlane. Los candidatos de banner serán las campañas de banner creadas para el slotId relacionado con el carrusel o swimlane. Topsort devolverá el product id de los ganadores y los assets con enlaces a creativos que se agregarán al carrusel o swimlane.
También puede crear un solo espacio de banner para el carrusel o swimlane, y solicitar 3 resultados de la subasta.
Por ejemplo, suponga que tiene una página de destino “Regreso a Clases” con un carrusel que presenta tres campañas de diferentes marcas. Cuando un visitante llega a esta página, hará una solicitud con el parámetro slots establecido en 3 para que Topsort pueda proporcionar al menos tres ganadores. Después de recibir los ganadores, puede agregar los tres anuncios de banner al carrusel. Si hay menos de tres ganadores, puede agregar una imagen de respaldo para las promociones de su marketplace o mostrar solo uno o dos banners.

​
Solicitud

Aquí hay un ejemplo de solicitud de subasta para un carrusel con tres espacios de banner dirigidos a marcas: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 3,
      "slotId": "backtoschool-carousel"
    }
  ]
}

​
Respuesta

La respuesta incluirá tres productos que puede mostrar en el carrusel, clasificados por los resultados de la subasta. Si no hay ofertas calificadas (sin ganadores) o si hubo un error, la respuesta estará vacía. En este caso, solo puede mostrar los resultados orgánicos. Una nueva variable booleana, error, indica si la subasta se resolvió con éxito. Aquí hay un ejemplo de la respuesta para una llamada con una solicitud de subasta usando la API V2 en 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
    }
  ]
}