Third Party Demand

​

Übersicht

• Demand Mediation – Für gesponserte Listings können externe Nachfragequellen (z. B. Criteo) ihre Gebote in die Topsort-Auktion einspeisen, wo sie direkt gegen Topsort-Nachfrage konkurrieren. Das höchste Gebot gewinnt, unabhängig von der Quelle.
• Demand Fallback – Für Banner-Werbeplätze kann Topsort einen Google Ad Manager (GAM)-Tag zurückgeben, wenn keine Topsort-Nachfrage verfügbar ist, sodass der Marktplatz zusätzliche Einnahmen aus programmatischer Werbung erzielt.

​

Demand Mediation

​

Was ist Demand Mediation?

​

Wie die Abrechnung funktioniert

• 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

• 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

​

Für wen ist es geeignet?

• 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

​

API-Implementierung

​

Änderungen an der Anfrage

• 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

• 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

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

​

Fehlerfälle

• 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
    }
  ]
}

​

Demand Fallback

​

Was ist die GAM-Fallback-Integration?

​

Vorteile

• Unverkauftes Inventar monetarisieren: Marktplätze können mit Banner-Werbeplätzen Einnahmen erzielen, auch wenn keine Topsort-Nachfrage vorhanden ist
• Flexible Nachfragequellen: Topsort kann GAM-Platzierungen so konfigurieren, dass Nachfrage entweder aus Open Auction (nicht-endemische Werbetreibende, die auf andere Websites verlinken) oder aus Direct Deals kommt

​

Für wen ist es geeignet?

​

Onboarding-Prozess

​

Beispielanfrage

{
  "auctions": [
    {
      "type": "banners",
      "slots": 1,
      "slotId": "fake-slot-2",
      "products": {
        "ids": ["prod-a1b2c3d4"]
      }
    }
  ]
}

​

Beispielantwort

{
  "results": [
    {
      "resultType": "banners",
      "winners": [
        {
          "asset": [
            {
              "content": "{\"type\": \"gam_snippet\", \"content\": \"<div id=\\\"gam-ad\\\"><script>googletag.cmd.push(function() { googletag.display(\\\"div-gpt-ad-12345\\\"); });</script></div>\"}"
            }
          ],
          "type": "url",
          "id": "https://www.example.com",
          "resolvedBidId": "PHRSCwoQBpvFL1sveOSZBCyVii_LCRIQAAAAAAAAAAAAAAAAAAAAABoQAAAAAAAAAAAAAAAAAAAAACIbChdodHRwczovL3d3dy5leGFtcGxlLmNvbRAFUIDQzO7O7_H__wFyEAAAAAAAAAAAAAAAAAAAAAA",
          "rank": 1
        }
      ],
      "error": false
    }
  ]
}