Zum Hauptinhalt springen
Das Beispiel auf dieser Seite zeigt, wie Sie Auktionen für Produkte aus Suchergebnissen durchführen. Es gibt zwei Möglichkeiten, diese Art von Auktionen durchzuführen:
  • Verwendung des searchQuery-Parameters, bei dem nur Gebote, die auf Produkte mit übereinstimmenden Keywords abzielen, eine Chance haben, solche Auktionen zu gewinnen.
  • Verwendung eines Produktsets und zusätzliche Verwendung des searchQuery-Parameters, um die Liste der Gebote zu erweitern, indem Produkte mit Keywords hinzugefügt werden, die denen im Produktset entsprechen.

​
Anwendungsfall

Die Durchführung dieser Art von Auktionen auf Suchseiten ermöglicht es Ihren Verkäufern, Produkte in den Suchergebnissen zu bewerben.

​
API-Aufruf-Beispiel

​
Anfrage: Verwendung von searchQuery

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "searchQuery": "Running shoes"
    }
  ]
}
Die obige Anfrage erstellt eine einzelne Listings-Auktion:
  • Sie hat aufgrund des slots-Feldes maximal zwei Gewinner.
  • Das searchQuery-Feld bestimmt, welche Keywords die Gebotsziele haben müssen.
Nur Gebote, die auf Produkte mit dem Keyword Running shoes abzielen, können an dieser Auktion teilnehmen.

​
Antwort

{
  "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.

​
Anfrage: Kombination von Produkten und searchQuery

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "products": {
        "ids": [
          "p_ojng4",
          "p_8VKDt",
          "p_Mfk15"
        ]
      }
      "searchQuery": "Running shoes"
    }
  ]
}
Die obige Anfrage erstellt eine einzelne Listings-Auktion:
  • Sie hat aufgrund des slots-Feldes maximal zwei Gewinner.
  • Das searchQuery-Feld bestimmt, welche Keywords die Gebotsziele haben müssen.
Die an diesen Auktionen teilnehmenden Produkte sind "p_ojng4", "p_8VKDt", "p_Mfk15" und solche mit einem Keyword, das zur searchQuery passt.

​
Antwort

{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_Mfk15",
          "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        },
        {
          "rank": 2,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwibGlzdGluZ3MiLCJkZWZhdWx0IiwiIl0="
        }
      ],
      "error": false
    }
  ]
}
Bemerkenswerte Kommentare:
  • 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.
  • Der Gewinner auf Rang 1 "p_Mfk15" stammt aus dem Produktset und Rang 2 "p_PJbnN" stammt aus den übereinstimmenden Keywords, da seine id nicht in der Auktionsanfrage angegeben wurde.
Die Durchführung von Auktionen mit dem searchQuery-Parameter verbessert Topsort, um den Keyword-Matching-Algorithmus zu optimieren.
Die Verwendung dieser Art von Auktionen erlaubt nicht die Verwendung von Quality Scores.

​
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.