Validador de sellers.json
Valida un documento sellers.json contra la especificación del IAB Tech Lab en tu navegador. El archivo que pegas permanece en tu dispositivo.
El Validador de sellers.json funciona por completo en tu navegador. El documento que pegas se analiza y comprueba en tu dispositivo y nunca se descarga desde una URL ni se sube a ArrayKit.
Abre el Validador de ads.txt
Acerca de Validador de sellers.json
El Validador de sellers.json revisa un documento sellers.json del IAB Tech Lab en el momento en que lo pegas. Confirma la version y el array sellers[] requeridos a nivel superior, luego recorre cada entrada de vendedor: cada una necesita un seller_id que sea único en todo el archivo y un seller_type de PUBLISHER, INTERMEDIARY o BOTH (sin distinguir mayúsculas). name y domain son requeridos salvo que el vendedor esté marcado como is_confidential, e is_passthrough debe ser un booleano limpio. Los hallazgos vuelven como un veredicto de aprobado/fallado, mensajes de error por vendedor etiquetados con el índice del array y el seller_id, y un resumen que cuenta los vendedores por tipo más las entradas confidenciales y passthrough. Los equipos de ad-ops y de supply-path auditan aquí su propio archivo o el de un partner sin hacer POST a un servicio de terceros: todo se ejecuta en tu dispositivo.
Características
- Comprueba la version y el array sellers[] requeridos a nivel superior según la especificación sellers.json
- Verifica que cada seller_id está presente y es único dentro del archivo
- Valida seller_type contra PUBLISHER, INTERMEDIARY y BOTH (sin distinguir mayúsculas)
- Exige name y domain salvo que el vendedor establezca is_confidential = 1
- Confirma que is_confidential e is_passthrough son flags booleanos limpios 0/1
- Etiqueta cada error con el índice de sellers[] y el seller_id infractor
- Resume los recuentos por seller_type más los totales confidencial y passthrough
- Analiza y valida el documento en tu navegador: el archivo nunca sale de tu dispositivo
Cómo usar Validador de sellers.json
- Pega tu documento sellers.json, o carga el ejemplo para ver la forma esperada
- Lee el veredicto de aprobado/fallado y los recuentos de resumen por seller_type
- Salta a cada entrada sellers[i] señalada usando el índice y el seller_id del mensaje
- Corrige el campo infractor y vuelve a validar hasta que el documento pase
Ejemplo
Entrada
{
"version": "1.0",
"sellers": [
{ "seller_id": "1001", "seller_type": "RESELLER" }
]
}
Salida
Invalid sellers.json — 3 issues
sellers[0] (seller_id 1001) — Invalid "seller_type" "RESELLER". Must be one of PUBLISHER, INTERMEDIARY, or BOTH.
sellers[0] — "name" is required unless the seller is confidential.
sellers[0] — "domain" is required unless the seller is confidential.
seller_type solo acepta PUBLISHER, INTERMEDIARY o BOTH; los vendedores no confidenciales necesitan name y domain.
Errores comunes y solución de problemas
- "Missing required top-level field version" en un archivo que claramente tiene sellers. — sellers.json requiere un campo version de tipo cadena (por ejemplo "1.0") a nivel superior junto a sellers[]. Añádelo: el array sellers por sí solo no basta.
- Un vendedor confidencial se señala por un name o domain ausente. — name y domain solo son opcionales cuando is_confidential = 1 en ese vendedor. Establece is_confidential a 1 para omitirlos, o proporciona ambos campos.
- seller_type se rechaza aunque el valor parece correcto. — Solo PUBLISHER, INTERMEDIARY y BOTH son válidos (sin distinguir mayúsculas). Valores como RESELLER, SSP o EXCHANGE no forman parte de la especificación y fallarán.
- "Duplicate seller_id" en IDs que crees distintos. — seller_id se compara como cadena, así que 1001 y "1001" colisionan. Cada seller_id debe ser único dentro del archivo: renumera o elimina las entradas duplicadas.
Preguntas frecuentes
- ¿Qué comprueba el Validador de sellers.json?
- Confirma la version y el array sellers[] requeridos a nivel superior, luego comprueba que cada vendedor tiene un seller_id único, un seller_type de PUBLISHER, INTERMEDIARY o BOTH, y name y domain salvo que el vendedor sea confidencial, señalando cada problema con su índice y seller_id.
- ¿Cuándo puede un vendedor omitir name y domain?
- Solo cuando ese vendedor establece is_confidential = 1. La especificación sellers.json permite que una cuenta confidencial oculte su name y domain, así que el validador omite el requisito de name/domain para esas entradas y las cuenta por separado en el resumen.
- ¿Qué valores de seller_type son válidos en sellers.json?
- PUBLISHER (posee el inventario), INTERMEDIARY (revende el inventario de otra cuenta) y BOTH. La comprobación no distingue mayúsculas, así que publisher y PUBLISHER pasan, pero cualquier otra cadena como RESELLER se reporta como un seller_type no válido.
- ¿Por qué se reporta un seller_id como duplicado?
- Cada seller_id debe ser único dentro de un solo archivo sellers.json. El validador normaliza los IDs a cadenas antes de comparar, así que un 1001 numérico y un "1001" en cadena se tratan como el mismo ID y la segunda aparición se señala con un puntero a la primera.
- ¿El validador descarga mi sellers.json desde su URL?
- No. Nunca descarga una URL remota ni un endpoint de anuncios. Tú pegas el texto del documento y se analiza y valida en tu dispositivo, así que nada del archivo se sube a ArrayKit ni a ningún tercero.
Herramientas relacionadas
Todas las herramientas de ArrayKit