Zum Hauptinhalt springen
Sie können Karussells und Swimlanes mit Bannern erstellen, indem Sie eine Banner-Auktion anfordern und die Anzahl der benötigten Banner für das Karussell oder die Swimlane angeben. Die Banner-Kandidaten sind die Banner-Kampagnen, die für die mit dem Karussell oder der Swimlane verbundene slotId erstellt wurden. Topsort gibt die Produkt-ID der Gewinner und die Assets mit Links zu den Creatives zurück, die dem Karussell oder der Swimlane hinzugefügt werden sollen.
Sie können auch einen einzelnen Banner-Slot für das Karussell oder die Swimlane erstellen und 3 Ergebnisse aus der Auktion anfordern.
Angenommen, Sie haben eine “Schulanfang”-Landing Page mit einem Karussell, das drei Kampagnen verschiedener Marken präsentiert. Wenn ein Besucher auf dieser Seite landet, stellen Sie eine Anfrage mit dem auf 3 gesetzten slots-Parameter, damit Topsort mindestens drei Gewinner liefern kann. Nach Erhalt der Gewinner können Sie die drei Banner-Anzeigen zum Karussell hinzufügen. Wenn es weniger als drei Gewinner gibt, können Sie entweder ein Fallback-Bild für Ihre Marketplace-Promotions hinzufügen oder nur ein oder zwei Banner anzeigen.

​
Anfrage

Hier ist eine Beispiel-Auktionsanfrage für ein Karussell mit drei Banner-Slots, die Marken ansprechen: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 3,
      "slotId": "backtoschool-carousel"
    }
  ]
}

​
Antwort

Die Antwort umfasst drei Produkte, die Sie im Karussell anzeigen können, geordnet nach den Auktionsergebnissen. Wenn es keine qualifizierenden Gebote (keine Gewinner) gibt oder ein Fehler aufgetreten ist, ist die Antwort leer. In diesem Fall können Sie nur organische Ergebnisse anzeigen. Eine neue boolesche Variable, error, zeigt an, ob die Auktion erfolgreich aufgelöst wurde. Hier ist eine Beispielantwort für einen Aufruf mit einer Auktionsanfrage über die V2 API im JSON-Format: 
{
  "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
    }
  ]
}