Zum Hauptinhalt springen
Die Beispiele auf dieser Seite zeigen, wie Sie Auktionen für Produkte durchführen, die zu bestimmten Kategorien gehören. Nur Gebote, die auf Produkte abzielen, die zu den angegebenen Kategorien gehören, haben eine Chance, diese Auktionen zu gewinnen. Gebote, die auf Produkte aus anderen Kategorien abzielen, werden nicht teilnehmen.

​
Anwendungsfall

Die Durchführung dieser Art von Auktionen auf Suchseiten ermöglicht es Ihren Verkäufern, Produkte auf Kategorieseiten zu bewerben.
Nicht-traditionelle Kategorien:Unser Katalogsystem macht keine Annahmen darüber, was eine Kategorie ist.Wenn Ihr Marketplace beispielsweise Ferienhäuser betrifft, könnten Kategorien geografische Standorte anstelle von Produktgruppen sein.

​
Kategorien angeben

Der /auctions Endpoint unterstützt mehrere Möglichkeiten, Kategorien anzugeben. Beim Erstellen einer Auktion müssen Sie eine der folgenden Methoden wählen:
MethodeRelevantes FeldBeschreibung
Einzelne Kategoriecategory.idGebotsziele müssen zur Kategorie gehören. Die id der Kategorie ist der gleiche Wert, der beim Product Upsert verwendet wird.
Alle Kategoriencategory.idsGebotsziele müssen zu allen Kategorien gehören.
Disjunktionencategory.disjunctionsGebotsziele müssen zu mindestens einer der Kategorien in der Disjunktion gehören.
Schauen wir uns einige Beispiele an.

​
API-Aufruf-Beispiele

​
Anfrage: Einzelne Kategorie

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "laptop_bags"
      }
    }
  ]
}
Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:
  • Aufgrund des slots-Feldes maximal zwei Gewinner hat.
  • Nur Gebote zulässt, die auf Produkte in einer einzelnen Kategorie abzielen. Die Kategorie-ID wird im category.id-Feld angegeben.
In diesem Fall können nur Gebote, die auf Produkte in der Kategorie laptop_bags abzielen, an der Auktion teilnehmen.

​
Anfrage: Alle Kategorien

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "ids": ["summer_hats", "sale"]
      }
    }
  ]
}
Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:
  • Aufgrund des slots-Feldes maximal zwei Gewinner hat.
  • Nur Gebote zulässt, die auf Produkte abzielen, die zu allen Kategorien gehören. Die Kategorie-IDs werden im category.ids-Feld angegeben.
Dieses Feld ist im Plural. Es heißt ids, nicht id.
Nur Gebote, die auf Produkte abzielen, die sowohl zu den Kategorien summer_hats als auch sale gehören, können an dieser Auktion teilnehmen.

​
Anfrage: Disjunktionen (“mindestens eine Kategorie”)

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "disjunctions": [["large", "medium"]]
      }
    }
  ]
}
Die obige Anfrage erstellt eine einzelne Listings-Auktion, die:
  • Aufgrund des slots-Feldes maximal zwei Gewinner hat.
  • Nur Gebote zulässt, die auf Produkte abzielen, die zu einer der Kategorien in der Disjunktion gehören. Disjunktionen werden als Arrays von Strings im category.disjunctions-Feld angegeben.
Nur Gebote, die auf Produkte in den Kategorien large oder medium abzielen, können an dieser Auktion teilnehmen.

​
Antwort

Diese Antwort nicht cachen oder ihre Ergebnisse. Auktionen müssen pro Seitenaufruf eindeutig sein, das ist es, was das System zum Funktionieren bringt.Wenn Auktionsergebnisse gecacht werden, könnten dieselben Ergebnisse mehreren Benutzern oder demselben Benutzer mehrmals angezeigt werden.
Wenn Gebote existieren, die auf Produkte in den entsprechenden Kategorien abzielen, könnte eine Antwort auf eine der obigen Anfragen so aussehen: 
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
Beachten Sie hier:
  • Der Typ der Gewinner ist product, da wir eine Listings-Auktion durchführen.
  • Es gibt zwei Gewinner, das Maximum, das durch das slots-Feld in der Anfrage erlaubt ist.

​
Nächste Schritte

Die Gewinner müssen mit Produktdaten kombiniert werden, um ein Ergebnis zu erstellen, das dem Endbenutzer angezeigt werden kann. Siehe diese Seite für ein Beispiel.