Zum Hauptinhalt springen
Um zielgerichtete Banner-Anzeigen auf Ihren Suchseiten basierend auf Benutzeranfragen bereitzustellen, fügen Sie einfach die Suchanfrage und die Slot-ID in Ihre Auktionsanfrage ein. Hier ist ein Beispiel mit einem einzelnen Banner-Slot auf einer Suchergebnisseite für mobile Geräte:
{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "search_banner_top",
      "device": "mobile",
      "searchQuery": "blue running shoes"
    }
  ]
}
Die untenstehende Beispielantwort liefert alle Informationen, die zum Bereitstellen der Banner-Anzeige erforderlich sind:
{
  "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
    }
  ]
}
winnerType kann “product”, “brand”, “vendor” oder “url” sein, abhängig vom Ziel der gewinnenden Banner-Anzeigenkampagne.