Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.topsort.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Was ist GAM Demand Mediation?

Erzielen Sie inkrementellen Umsatz aus Banner-Impressionen, die sonst ungefüllt bleiben würden - ohne Änderungen an Ihrem bestehenden Topsort-Setup.
Wenn Topsort keine Nachfrage für einen Banner-Slot hat, geben wir automatisch eine Google Ad Manager (GAM)-Anzeige zurück. Sie müssen diese nur rendern.
GAM-Fallback-Flussdiagramm mit GAM-Tag-Rückgabe bei fehlender Topsort-Nachfrage

​
Vorteile

  • Unverkauftes Inventar monetarisieren: Umsatz auch ohne Topsort-Nachfrage
  • Flexible Nachfragequellen: Open Auction oder Direct Deals über GAM

​
Für wen ist es geeignet?

Jeder Topsort-Marktplatz weltweit mit Banner-Slots.

​
Onboarding-Prozess

Wenn Ihr Marktplatz an GAM demand mediation interessiert ist, wenden Sie sich an Ihr Topsort-Account-Team.
Eine typische Integration dauert nur wenige Stunden Entwicklungszeit eines Marketplace-Ingenieurs und kann live in einem einzigen Call umgesetzt werden.
1

Pilotumfang festlegen

Wählen Sie 2-3 Banner-Slots aus und stimmen Sie Moderationsrichtlinien ab.
2

GAM-MCM-Verbindung einrichten

Verknüpfen Sie Topsort- und Händlerkonten und aktualisieren Sie ads.txt sowie sellers.json.
3

Passback-Flow implementieren

Fügen Sie ein kleines Snippet in jeden Slot ein, um Topsort- oder GAM-Anzeige zu rendern.
4

Tests

Topsort validiert die Integration.

​
Beispielantwort

Wenn keine Topsort-Nachfrage verfügbar ist, liefert der Auktions-Endpoint ein GAM-Snippet im Feld asset.
{
  "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",
          "rank": 1
        }
      ],
      "error": false
    }
  ]
}

​
Passback flow

Die einzige notwendige Entwicklung auf Marketplace-Seite ist ein kleines Code-Snippet je aktiviertem GAM-Slot.
// response is response from Topsort auction endpoint
const { results } = await response.json();
const passback = results?.[0]?.winners?.[0]?.metadata?.passbacktag;

if (passback) {
  const iframe = document.createElement("iframe");
  document.getElementById("banner-slot-3")?.appendChild(iframe);
  iframe.contentDocument.write(passback);
  iframe.contentDocument.close();
} else {
  // render normal Topsort ad
}