Zum Hauptinhalt springen

​
Übersicht

Ab dem 20. Februar 2026 können Topsort-Auktionen Drittanbieter-Nachfrage einbeziehen, sodass Händler Gebote von Drittanbietern in die Topsort-Auktion einspeisen können, wo diese direkt gegen Topsort-Nachfrage konkurrieren. Das höchste Gebot gewinnt, unabhängig von der Quelle.

​
Was ist Demand Mediation?

Bisher erhielten Topsort-Auktionen Nachfrage nur aus Topsort-Quellen (entweder von Anbietern innerhalb eines Marktplatzes oder über Toppie). Mit Demand Mediation kann Topsort nun Nachfrage von Drittanbieter-Quellen einbeziehen.
Die erste integrierte Drittanbieter-Nachfragequelle ist Criteo, eine führende Retail-Media-Werbeplattform mit Budgets von großen Marken aus aller Welt. Für jede gesponserte Listing-Platzierung ruft ein Händler Gebote von Criteo ab und übergibt diese an Topsort. Topsort vergleicht die Criteo-Gebote mit seinen eigenen Geboten und wählt die Gewinngebote unter ihnen aus.
Topsort kann problemlos weitere Nachfragequellen über Criteo hinaus unterstützen, sofern deren Gebote über den demandSources-Parameter des Auktions-Endpunkts gesendet werden können.

​
Wie die Abrechnung funktioniert

Bei der Demand Mediation mit Criteo:
  • Der Händler besitzt das Criteo-Konto/-Instanz, nicht Topsort
  • Werbetreibende zahlen direkt an Criteo
  • Criteo stellt Werbetreibenden Rechnungen, zieht seine Plattformgebühr ab und zahlt dem Händler seinen Umsatzanteil
  • Topsort stellt dem Händler separat Rechnung (Abrechnungsstruktur noch zu bestimmen)

​
Vorteile für Marktplätze

Händler können durch Demand Mediation zusätzliche Werbeeinnahmen erzielen:
  • Lücken füllen: Wenn keine Topsort-Nachfrage für Werbeanfragen vorhanden ist, kann Criteo-Nachfrage verfügbar sein
  • Wettbewerb steigern: Wenn Topsort-Nachfrage vorhanden ist, kann Criteo-Nachfrage höher bieten und so den Gesamtumsatz steigern

​
Welche Kunden sollten dies nutzen?

Obwohl jeder Kunde Criteo-Nachfrage hinzufügen kann, ist diese Integration am relevantesten für Kunden, die voraussichtlich erhebliche Criteo-Werbeausgaben anziehen werden:
  • Große US-Marktplätze: Viele große US-Marken bieten auf Retail-Media-Anzeigen über Tools wie Pacvue und Skai, die wiederum auf Criteo-Inventar bieten. Dieses Setup ermöglicht es großen Marken, eine direkte Integration mit jedem Händler, bei dem sie werben möchten, zu vermeiden.
  • Große LATAM-Marktplätze: Criteo hat eine bedeutende Präsenz in Lateinamerika, was diese Integration auch für große LATAM-Marktplätze wertvoll macht.

​
Onboarding-Prozess

So integrieren Sie einen Marktplatz mit Demand Mediation:
1

Placements in Criteo einrichten

Der Marktplatz sollte alle Placements, für die Criteo-Nachfrage eingebunden werden soll, in seinem Criteo-Konto konfigurieren.
2

Frontend-Code aktualisieren

Beim Laden der Seite muss der Marktplatz:
  1. Gebote von Criteo für das Placement abrufen
  2. Diese Gebote als zusätzlichen Parameter in der Auktionsanfrage an Topsort senden
3

Auktionsantwort verarbeiten

Topsort gibt die Gewinngebote zurück, die sowohl Topsort- als auch Criteo-Gewinner enthalten können.
4

Ereignisse melden

Bei Criteo-Gewinnern sollte der Marktplatz Ereignisse sowohl an Topsort als auch an Criteo melden.

​
API-Implementierung

Der Auktions-Endpunkt wurde erweitert, um externe Nachfragequellen zu unterstützen. Das Hinzufügen externer Nachfrage erfordert ein neues Eingabefeld und zwei neue Antwortfelder für Auktionsgewinner.
Die Anzahl der externen Gebote ist auf 100 pro Auktionsanfrage begrenzt.

​
Änderungen an der Anfrage

Dem Auktionsobjekt wurde ein neues demandSources-Feld hinzugefügt:
  • demandSources: Array von demandSource-Objekten
    • source: Enum zur Identifizierung der externen Nachfragequelle (z. B. "criteo")
    • bids: Array von Bid-Objekten, eines für jedes externe Gebot
Jedes Bid-Objekt enthält:
  • chargeType: Enum (in der ersten Version wird nur "CPC" unterstützt)
  • entity: Objekt mit den Feldern type und id zur Identifizierung des gesponserten Produkts
  • bidAmount: Gebotsbetrag in der Währung des Marktplatzes
  • metadata: Freies Feld für beliebige Metadaten, die in der Gewinnerantwort benötigt werden (z. B. Beacon-URLs für Gebote)

​
Änderungen an der Antwort

Das Winner-Objekt wurde aktualisiert mit:
  • demandSource: String zur Identifizierung der Quelle des Gewinngebots (z. B. "topsort" oder "criteo"). Erscheint nur, wenn externe Gebote in der Anfrage enthalten sind.
  • metadata: Bei externen Gebot-Gewinnern wird die Eingabe-Metadaten des externen Gebots durchgereicht. Wird bei internen/Topsort-Geboten weggelassen.
Bei externen Geboten wird das Feld campaignId im Winner-Objekt weggelassen.

​
Fehlerfälle

Neue Fehlerfälle spezifisch für Demand Mediation:
  • Externe Nachfrage ist für den Marktplatz nicht autorisiert
  • Ungültige externe Gebote (Nicht-Produkt-Entitäten, falscher Gebührentyp oder negativer Gebotsbetrag)
  • Zu viele externe Gebote (mehr als 100)
  • Externe Nachfrage mit einem anderen Anzeigentyp als Listings
  • Ungültige externe Nachfragequelle (derzeit wird nur Criteo unterstützt)

​
Beispielanfrage

{
  "auctions": [
    {
      "type": "listings",
      "slots": 2,
      "category": {
        "id": "paper"
      },
      "opaqueUserId": "user123",
      "demandSources": [
        {
          "source": "criteo",
          "bids": [
            {
              "chargeType": "CPC",
              "entity": {
                "type": "product",
                "id": "product123"
              },
              "bidAmount": 0.75,
              "metadata": {
                "beaconUrls": ["https://example.com/beacon"],
                "clickUrls": ["https://example.com/click"]
              }
            }
          ]
        }
      ]
    }
  ]
}

​
Beispielantwort

{
  "results": [
    {
      "resultType": "listings",
      "winners": [
        {
          "demandSource": "criteo",
          "type": "product",
          "id": "product123",
          "resolvedBidId": "UkoVYQoQBpaVc2jmdMO0BA4QS9VdHRIQAZgtj1MxeFGT5HL2fhBhKRoQBlhiMAUTfKyPJHhKpsqrQCIKCgZzdWJ3YXkQATCmFUDTBEgBUMXa8pu8Mw",
          "rank": 1,
          "metadata": {
            "beaconUrls": ["https://example.com/beacon"],
            "clickUrls": ["https://example.com/click"]
          }
        },
        {
          "demandSource": "topsort",
          "campaignId": "01982d6e-8655-70e2-94e3-3e5e764b4753",
          "type": "product",
          "id": "product456",
          "resolvedBidId": "zOzJwgoQBpaVfNrgdmeSBLgWZwYYmhIQAZgtboZVcOKU4z5edktHUxoQBlhiMAUTfKyPJHhKpsqrQCIQCgxwYW5lcmEtYnJlYWQQATCmFUDTBEgBUKH3-5u8Mw",
          "rank": 2
        }
      ],
      "error": false
    }
  ]
}
Weitere Informationen zur Auktions-API finden Sie in derAPI-Referenz für Auktionen erstellen.
Zuletzt aktualisiert: