Demanda de Terceros

​

Descripción General

• Mediación de Demanda – Para listings patrocinados, las fuentes de demanda externas (p. ej., Criteo) pueden enviar pujas a la subasta de Topsort, donde compiten directamente contra la demanda de Topsort. La puja más alta gana, independientemente de la fuente.
• Demand Fallback – Para espacios de banners, Topsort puede devolver una etiqueta de Google Ad Manager (GAM) cuando no hay demanda de Topsort disponible, generando ingresos incrementales para el marketplace a través de anuncios programáticos.

​

Mediación de Demanda

​

¿Qué es la Mediación de Demanda?

​

Cómo Funciona la Facturación

• El retailer es propietario de la cuenta/instancia de Criteo, no Topsort
• Los anunciantes pagan directamente a Criteo
• Criteo factura a los anunciantes, cobra su tarifa de plataforma y paga al retailer su participación en los ingresos
• Topsort factura al retailer por separado (estructura de facturación por definir)

​

Beneficios

• Cubrir espacios vacíos: Cuando no hay demanda de Topsort para solicitudes de anuncios, la demanda de Criteo puede estar disponible
• Aumentar la competencia: Cuando existe demanda de Topsort, la demanda de Criteo puede pujar más alto, aumentando los ingresos totales

​

¿Para quién es?

• Grandes marketplaces en EE. UU.: Muchas marcas importantes de EE. UU. pujan en anuncios de retail media a través de herramientas como Pacvue y Skai, que a su vez pujan en el inventario de Criteo. Esta configuración permite a las grandes marcas evitar la integración directa con cada retailer en el que desean anunciarse.
• Grandes marketplaces en LATAM: Criteo tiene una presencia significativa en América Latina, lo que hace que esta integración sea valiosa para los grandes marketplaces de la región también.

​

Proceso de Incorporación

​

Implementación en la API

​

Cambios en la Solicitud

• demandSources: Array de objetos demandSource
  • source: Enum que identifica la fuente de demanda externa (p. ej., "criteo")
  • bids: Array de objetos Bid, uno por cada puja externa

• chargeType: Enum (solo se admite "CPC" en la primera versión)
• entity: Objeto con los campos type e id que identifican el producto patrocinado
• bidAmount: Monto de la puja en la moneda del marketplace
• metadata: Campo de formato libre para cualquier metadato necesario en la respuesta del ganador (p. ej., URLs de beacon de puja)

​

Cambios en la Respuesta

• demandSource: Cadena que identifica la fuente de la puja ganadora (p. ej., "topsort" o "criteo"). Solo aparece cuando se incluyen pujas externas en la solicitud.
• metadata: Para los ganadores de pujas externas, transmite los metadatos de entrada de la puja externa. Se omite para las pujas internas de Topsort.

​

Casos de Error

• La demanda externa no está autorizada para el marketplace
• Pujas externas inválidas (entidades que no son productos, tipo de cargo incorrecto o monto de puja negativo)
• Demasiadas pujas externas (más de 100)
• Demanda externa con un tipo de anuncio distinto a listados
• Fuente de demanda externa inválida (actualmente solo se admite Criteo)

​

Ejemplo de Solicitud

{
  "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"]
              }
            }
          ]
        }
      ]
    }
  ]
}

​

Ejemplo de Respuesta

{
  "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": "zOzJwgoQBpaVfNrgdmeSBLgWZwYYmhIQAZgtboZVcOKU4z5edktHUxoQBlhiMAUTfKyPJHhKpsqrQCIQCgxwYW5lbGEtYnJlYWQQATCmFUDTBEgBUKH3-5u8Mw",
          "rank": 2
        }
      ],
      "error": false
    }
  ]
}

​

Demand Fallback

​

¿Qué es la integración de GAM Fallback?

​

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 (anunciantes no endémicos que enlazan a otros sitios web) como de acuerdos directos

​

¿Para quién es?

​

Proceso de Incorporación

​

Ejemplo de Solicitud

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

​

Ejemplo de Respuesta

{
  "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
    }
  ]
}