Saltar al contenido 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é es GAM Demand Mediation?

Genera ingresos incrementales con impresiones de banner que de otro modo quedarían sin completar, sin cambiar tu configuración actual de Topsort.
Cuando Topsort no tiene demanda para un banner slot, devolvemos automáticamente un anuncio de Google Ad Manager (GAM). Solo tienes que renderizarlo.
Diagrama del flujo de GAM fallback mostrando la subasta devolviendo una etiqueta GAM cuando no existe demanda de Topsort

​
Beneficios

  • Monetizar inventario no vendido: Los marketplaces pueden generar ingresos con los espacios de banners incluso cuando no hay demanda de Topsort
  • Fuentes de demanda flexibles: Topsort puede configurar las ubicaciones de GAM para obtener demanda tanto de open auction como de acuerdos directos

​
¿Para quién es?

Cualquier marketplace de Topsort en todo el mundo con slots de banners.

​
Proceso de incorporación

Si tu marketplace está interesado en GAM demand mediation, comunícate con tu equipo de cuenta de Topsort.
Una integración típica toma solo unas pocas horas del tiempo de un ingeniero del marketplace y puede realizarse en vivo en una sola llamada con un ingeniero de integración de Topsort. El proceso sigue estos pasos:
1

Alinear el alcance del piloto

Selecciona 2-3 espacios de banners y acuerda las políticas de moderación de contenido.
2

Configurar la conexión GAM MCM

Vincula las cuentas de Topsort y del retailer, y actualiza ads.txt y sellers.json.
3

Implementar el flujo de passback

Simplemente agrega un snippet de código muy pequeño en cada ad slot para renderizar un anuncio de Topsort o un anuncio de GAM.
4

Pruebas

Topsort validará la integración.

​
Ejemplo de respuesta

Cuando no hay demanda de Topsort disponible para un espacio de banner habilitado para GAM demand mediation, el endpoint de subastas devuelve un snippet de GAM en el campo asset del ganador.
{
  "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

El único desarrollo requerido por el marketplace es agregar un snippet de código pequeño a cada ad slot que quieran habilitar para demanda de 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
}