Passer au contenu principal

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.

​
Qu’est-ce que GAM Demand Mediation ?

Générez des revenus incrémentaux sur des impressions bannière qui resteraient sinon non remplies, sans changer votre configuration Topsort existante.
Quand Topsort n’a pas de demande pour un slot bannière, nous retournons automatiquement une annonce Google Ad Manager (GAM). Vous n’avez qu’à l’afficher.
Diagramme du flux GAM fallback montrant le retour d'un tag GAM lorsqu'il n'y a pas de demande Topsort

​
Avantages

  • Monétiser l’inventaire invendu: Revenus même quand il n’y a pas de demande Topsort
  • Sources flexibles: Open auction ou direct deals via GAM

​
À qui est-ce destiné ?

Toute marketplace Topsort dans le monde avec des emplacements bannière.

​
Processus d’intégration

Si votre marketplace est intéressée par GAM demand mediation, contactez votre équipe de compte Topsort.
Une intégration typique prend seulement quelques heures du temps d’un ingénieur marketplace et peut être réalisée en direct pendant un seul appel.
1

Aligner le scope pilote

Sélectionnez 2-3 slots bannière et alignez les politiques de modération.
2

Configurer la connexion GAM MCM

Reliez les comptes Topsort et retailer, puis mettez à jour ads.txt et sellers.json.
3

Implémenter le passback flow

Ajoutez un petit snippet dans chaque slot pour afficher soit une annonce Topsort, soit une annonce GAM.
4

Tests

Topsort valide l’intégration.

​
Exemple de réponse

Quand il n’y a pas de demande Topsort pour un slot bannière activé, l’endpoint d’enchères retourne un snippet GAM dans 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

Le seul développement requis côté marketplace est d’ajouter un petit snippet de code à chaque slot activé pour la demande GAM.
// 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
}