Blog · Publicidad programática

sellers.json y SupplyChain (schain): cómo verifican los compradores el camino de una impresión

Publicado el Actualizado el 4 min de lectura
Respuesta cortasellers.json es un archivo público en el que un sistema publicitario lista a los vendedores a los que les paga —editores e intermediarios— con sus IDs. El objeto SupplyChain (schain) viaja dentro de cada solicitud de puja y lista todas las empresas por las que pasó la impresión. Junto con ads.txt, permiten a un comprador comprobar que una impresión viene realmente del sitio que dice.
Contenido
  1. ¿Qué es sellers.json?
  2. ¿Qué es el objeto SupplyChain (schain)?
  3. ¿Cómo usan los compradores ads.txt, sellers.json y schain juntos?
  4. ¿Qué deben revisar los editores?
  5. ¿Qué deben revisar revendedores y plataformas?
  6. Problemas frecuentes
  7. Por qué importa para la calidad del tráfico
  8. Preguntas frecuentes

En la publicidad programática, una impresión puede pasar por varias empresas antes de llegar al comprador. El IAB Tech Lab creó sellers.json y el objeto SupplyChain para que ese camino sea visible. Si eres editor, revendedor o una plataforma que trabaja con socios mediante schain, así encajan las piezas.

¿Qué es sellers.json?

sellers.json es un archivo JSON que un sistema publicitario —un SSP, un exchange o una red— publica en la raíz de su dominio, por ejemplo https://example-ssp.com/sellers.json. Lista las cuentas a las que el sistema les paga por el inventario. Cada entrada tiene:

Campo Significado
seller_id El ID de la cuenta en el sistema publicitario. El mismo ID aparece en ads.txt y en schain
seller_type PUBLISHER (dueño del inventario), INTERMEDIARY (lo revende) o BOTH
name y domain Quién es el vendedor, salvo que la entrada sea confidencial
is_confidential 1 si no se revela la identidad del vendedor

El archivo también incluye los datos de contacto del sistema y un número de versión. Wizads publica su propio archivo en wizads.eu/sellers.json.

¿Qué es el objeto SupplyChain (schain)?

El objeto SupplyChain viaja en cada solicitud de puja OpenRTB. Es una lista de "nodos", uno por cada empresa que manejó la impresión:

"schain": {
  "ver": "1.0",
  "complete": 1,
  "nodes": [
    { "asi": "example-ssp.com", "sid": "12345", "hp": 1 },
    { "asi": "example-exchange.com", "sid": "abc-678", "hp": 1 }
  ]
}
  • asi: el dominio del sistema publicitario (donde está su sellers.json);
  • sid: el ID del vendedor en ese sistema;
  • hp: 1 si el pago pasa por ese nodo;
  • complete: 1 si la cadena incluye todos los nodos hasta el dueño del inventario.

En OpenRTB 2.5 el objeto está en source.ext.schain; en OpenRTB 2.6 pasó a ser el campo estándar source.schain.

¿Cómo usan los compradores ads.txt, sellers.json y schain juntos?

Un comprador, normalmente un DSP, revisa tres cosas:

  1. ads.txt en el sitio del editor. ¿El sitio autoriza al sistema publicitario y al ID de vendedor del primer nodo como DIRECT o RESELLER? Mira nuestra guía de ads.txt.
  2. sellers.json de cada nodo. ¿Cada asi publica un sellers.json y el sid existe ahí con un tipo de vendedor coherente?
  3. El schain en sí. ¿Está completo y parece un camino razonable, no una larga cadena de revendedores?

Si las verificaciones fallan, muchos compradores bajan su puja o descartan la impresión. Un camino limpio, corto y verificable suele traer más demanda y mejores precios.

¿Qué deben revisar los editores?

  • Tu ads.txt incluye todos los sistemas publicitarios con los que trabajas, con los IDs de vendedor exactos que te dieron.
  • Cada uno de esos sistemas incluye tu cuenta en su sellers.json, idealmente con tu nombre y dominio, no como confidencial.
  • El tipo de vendedor es el correcto: PUBLISHER para tu propio sitio.
  • Cuando cambies de socios, borra las líneas viejas de ads.txt: las entradas obsoletas confunden a los compradores.

¿Qué deben revisar revendedores y plataformas?

  • Tu sellers.json está disponible por HTTPS, es un JSON válido y está actualizado.
  • Cada cuenta que te envía tráfico tiene una entrada con el seller_type correcto.
  • Transmites el schain que recibes y agregas tu propio nodo, en lugar de reemplazar la cadena.
  • Los ads.txt y app-ads.txt de tus socios incluyen tus IDs de vendedor.

Problemas frecuentes

Problema Efecto Solución
El ID del schain no está en sellers.json El comprador no puede verificar el nodo Agregar la cuenta a sellers.json
ads.txt no incluye el sistema publicitario La impresión parece no autorizada Pedirle al socio la línea exacta y agregarla
Cadena marcada como incompleta Menos confianza, menos pujas Transmitir la cadena completa
Muchas entradas confidenciales Menos transparencia Revelar nombres y dominios cuando sea posible

Por qué importa para la calidad del tráfico

La suplantación de dominio —vender inventario barato con el nombre de un sitio premium— fue una de las razones principales de estos estándares. Con ads.txt, sellers.json y schain, el comprador ve quién vende y quién es el dueño del inventario. Eso también es parte de cómo las plataformas combaten el fraude publicitario. Para el panorama completo, lee nuestra guía de publicidad programática.

Preguntas frecuentes

¿sellers.json es obligatorio?

No es una ley, pero muchos compradores lo esperan. El inventario de sistemas sin sellers.json suele valer menos o quedar excluido.

¿Cuál es la diferencia entre ads.txt y sellers.json?

ads.txt lo publica el editor y dice quién puede vender su inventario. sellers.json lo publica el sistema publicitario y dice a quién le paga. Cada uno confirma al otro.

¿Dónde encuentro la información de vendedores de Wizads?

En el archivo público wizads.eu/sellers.json. Si trabajas con Wizads como editor o socio, tu gerente te dará las líneas exactas para ads.txt y tu ID de vendedor.

Sobre el autor

Equipo de Wizads

Wizads es una red publicitaria con DSP, SSP y ad server propios. Nuestro equipo escribe sobre publicidad programática, monetización web y compra de tráfico.

Artículos relacionados