sellers.json, el DNI de cada vendedor programático

Si ads.txt es la declaración del publisher, sellers.json es la contraparte del SSP: un JSON público con miles de vendedores que los compradores cruzan en segundos. Estos 6 puntos explican su estructura con referencias del IAB Tech Lab.

1. Qué es sellers.json y su rol de contraparte

Publicado por el IAB Tech Lab en 2019, sellers.json obliga a cada SSP y exchange a exponer en /sellers.json la lista de cuentas que venden a través suyo. Cada entrada identifica 1 cuenta con su ID, dominio y tipo, de modo que cualquier comprador puede verificar en 2 peticiones si el par dominio+ID del ads.txt existe del otro lado.

Los SSP grandes publican entre 10,000 y 100,000 entradas; el archivo se cachea típicamente por 24 horas en los validadores.

2. Estructura: 6 campos por vendedor

Cada objeto seller contiene hasta 6 campos definidos por el estándar. Un ejemplo con 2 entradas:

{
  "sellers": [
    { "seller_id": "12345", "seller_type": "PUBLISHER",
      "name": "Ejemplo Media", "domain": "ejemplo.com",
      "is_confidential": 0 },
    { "seller_id": "67890", "seller_type": "INTERMEDIARY",
      "is_confidential": 1 }
  ]
}

Los campos son seller_id, seller_type, name, domain, is_confidential e is_passthrough. Solo los 2 primeros son estrictamente obligatorios en la práctica.

3. seller_type: PUBLISHER, INTERMEDIARY o BOTH

El campo admite 3 valores: PUBLISHER (vende inventario propio), INTERMEDIARY (revende inventario de terceros) y BOTH (combina ambos roles). La regla de cruce es de 1 a 1: un ads.txt DIRECT debería mapear a PUBLISHER, y un RESELLER a INTERMEDIARY o BOTH.

Cuando el mapeo falla, los DSP aplican filtros que pueden excluir la impresión en el 100% de las subastas con verificación estricta.

4. Sellers confidenciales: el caso is_confidential=1

Con is_confidential: 1, el SSP oculta nombre y dominio por acuerdos de privacidad; solo expone ID y tipo. Pixalate reporta que los sellers no autorizados explican el 77% de los fallos de verificación SupplyChain en web (Q1 2024), así que la buena práctica es minimizar la confidencialidad en cuentas DIRECT, porque los compradores priorizan rutas con las 3 señales completas.

5. Cómo cruzar ads.txt contra sellers.json en 4 comparaciones

La auditoría cruza 4 datos por línea: dominio del SSP resuelto, existencia del publisher ID, coincidencia de relación contra seller_type y coincidencia de dominio declarado. Los 4 resultados posibles son: válido, publisher no encontrado, relación incorrecta o sellers.json inalcanzable (el SSP no lo publica o cae por más de 24 horas).

Los validadores públicos automatizan el cruce contra 5 a 15 sellers.json y generan reportes con severidad en minutos, con re-auditoría sugerida cada 30 días.

Referencias

• IAB Tech Lab — Estándar sellers.json
• IAB Tech Lab — Estándar ads.txt
• IAB Tech Lab — SupplyChain Object
• Pixalate — Seller Misrepresentation Q4 2024 (+107% IVT)