Validador de sellers.json
Valide um documento sellers.json contra a especificação do IAB Tech Lab no seu navegador. O arquivo que você cola fica no seu dispositivo.
O Validador de sellers.json roda inteiramente no seu navegador. O documento que você cola é analisado e verificado no seu dispositivo e nunca é buscado de uma URL ou enviado à ArrayKit.
Abrir o Validador de ads.txt
Sobre Validador de sellers.json
O Validador de sellers.json analisa um documento sellers.json do IAB Tech Lab no momento em que você o cola. Ele confirma a version e o array sellers[] obrigatórios no nível superior, depois percorre cada entrada de vendedor: cada uma precisa de um seller_id único em todo o arquivo e um seller_type PUBLISHER, INTERMEDIARY ou BOTH (sem diferenciar maiúsculas). name e domain são obrigatórios a menos que o vendedor esteja marcado como is_confidential, e is_passthrough deve ser um booleano limpo. Os achados voltam como um veredito de aprovado/reprovado, mensagens de erro por vendedor marcadas com o índice do array e o seller_id, e um resumo que conta vendedores por tipo mais entradas confidential e passthrough. Times de ad-ops e de supply-path auditam seu próprio arquivo ou o de um parceiro aqui sem fazer POST em um serviço de terceiros — tudo roda no seu dispositivo.
Recursos
- Verifica a version e o array sellers[] obrigatórios no nível superior conforme a especificação sellers.json
- Verifica que cada seller_id está presente e é único dentro do arquivo
- Valida seller_type contra PUBLISHER, INTERMEDIARY e BOTH (sem diferenciar maiúsculas)
- Impõe name e domain a menos que o vendedor defina is_confidential = 1
- Confirma que is_confidential e is_passthrough são flags booleanas 0/1 limpas
- Marca cada erro com o índice de sellers[] e o seller_id problemático
- Resume as contagens por seller_type mais os totais de confidential e passthrough
- Analisa e valida o documento no seu navegador — o arquivo nunca sai do seu dispositivo
Como usar Validador de sellers.json
- Cole seu documento sellers.json, ou carregue o exemplo para ver o formato esperado
- Leia o veredito de aprovado/reprovado e as contagens de resumo por tipo de vendedor
- Vá a cada entrada sellers[i] sinalizada usando o índice e o seller_id na mensagem
- Corrija o campo problemático e revalide até o documento passar
Exemplo
Entrada
{
"version": "1.0",
"sellers": [
{ "seller_id": "1001", "seller_type": "RESELLER" }
]
}
Saída
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 só aceita PUBLISHER, INTERMEDIARY ou BOTH; vendedores não confidenciais precisam de name e domain.
Erros comuns e solução de problemas
- "Missing required top-level field version" em um arquivo que claramente tem sellers. — sellers.json exige um campo string version (por exemplo "1.0") no nível superior junto de sellers[]. Adicione-o — o array sellers por si só não basta.
- Um vendedor confidencial é sinalizado por name ou domain ausente. — name e domain só são opcionais quando is_confidential = 1 naquele vendedor. Defina is_confidential como 1 para omiti-los, ou forneça ambos os campos.
- seller_type é rejeitado mesmo com o valor parecendo certo. — Apenas PUBLISHER, INTERMEDIARY e BOTH são válidos (sem diferenciar maiúsculas). Valores como RESELLER, SSP ou EXCHANGE não fazem parte da especificação e falharão.
- "Duplicate seller_id" em IDs que você acredita serem distintos. — seller_id é comparado como string, então 1001 e "1001" colidem. Cada seller_id deve ser único dentro do arquivo — renumere ou remova as entradas duplicadas.
Perguntas frequentes
- O que o Validador de sellers.json verifica?
- Ele confirma a version e o array sellers[] obrigatórios no nível superior, depois verifica que cada vendedor tem um seller_id único, um seller_type PUBLISHER, INTERMEDIARY ou BOTH, e name e domain a menos que o vendedor seja confidencial — sinalizando cada problema com seu índice e seller_id.
- Quando um vendedor pode omitir name e domain?
- Apenas quando aquele vendedor define is_confidential = 1. A especificação sellers.json permite que uma conta confidencial oculte seu name e domain, então o validador pula o requisito de name/domain para essas entradas e as conta separadamente no resumo.
- Quais valores de seller_type são válidos no sellers.json?
- PUBLISHER (possui o inventário), INTERMEDIARY (revende o inventário de outra conta) e BOTH. A verificação não diferencia maiúsculas, então publisher e PUBLISHER passam, mas qualquer outra string como RESELLER é reportada como um seller_type inválido.
- Por que um seller_id é reportado como duplicata?
- Cada seller_id deve ser único dentro de um único arquivo sellers.json. O validador normaliza os IDs para string antes de comparar, então um 1001 numérico e um "1001" string são tratados como o mesmo ID e a segunda ocorrência é sinalizada com um ponteiro para a primeira.
- O validador busca meu sellers.json a partir de sua URL?
- Não. Ele nunca busca uma URL remota ou endpoint de anúncio. Você cola o texto do documento e ele é analisado e validado no seu dispositivo, então nada sobre o arquivo é enviado à ArrayKit ou a qualquer terceiro.
Ferramentas relacionadas
Todas as ferramentas de ArrayKit