Zum Hauptinhalt springen
Um Banner-Anzeigen auf Kategorieseiten anzuzeigen, ist der Prozess ähnlich wie bei Suchergebnisseiten. Anstatt das searchQuery-Feld zu verwenden, müssen Sie das category-Feld in Ihrer Auktionsanfrage verwenden. Es gibt drei Optionen zur Angabe der Kategorie der an der Auktion teilnehmenden Marken, Produkte oder Verkäufer:
  • Einzelne Kategorie
  • Multiple Kategorien
  • Kategorie-Disjunktionen

​
Beispielanfrage - Einzelne Kategorie-Banner

Erhalten Sie bis zu 5 Auktionsergebnisse in 1 API-Aufruf 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "homepage",
      "device": "mobile",
      "category": {
        "id": "c_yogurt"
      }
    }
  ]
}

​
Beispielantwort - Kategorie

{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "product",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}

​
Beispiel: Kategorie-Disjunktionen

Kategorie-Disjunktionen ermöglichen es Ihnen, mehrere Kategorien in einer einzigen Auktionsanfrage anzusprechen. Sie können mehrere Kategorien angeben, und die Auktion berücksichtigt Anzeigen aus einer dieser Kategorien. Dies ist nützlich, wenn Sie relevante Banner-Anzeigen für verschiedene Kategorien auf einer bestimmten Seite anzeigen möchten. Hier ist eine Auktionsanfrage mit einem einzelnen Banner-Slot, der sowohl Wanderschuh- als auch Laufschuh-Kategorien mit Kategorie-Disjunktionen anspricht: 
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "categories-ribbon",
      "category": {
        "disjunctions": [["hiking_boots", "running_shoes"]]
      }
    }
  ]
}
Die untenstehende Beispielantwort enthält alle Informationen, die zum Bereitstellen der Banner-Anzeigen erforderlich sind: 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "winnerType": "vendor",
          "winnerId": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://topsort.cdnprovider.com/lhs-banner-image-for-p_PJbnN-1x.png"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
Sie können bis zu 5 Auktionen in einer einzigen Anfrage anfordern. Wenn Sie mehrere Banner-Slots auf Ihren Kategorieseiten haben, können Sie Auktionen für sie in einem einzigen Aufruf anfordern.