sellers.json e SupplyChain (schain): como os compradores verificam o caminho da impressão
Equipe WizadsPublicado em Atualizado em 4 min de leitura
Resposta curtaO sellers.json é um arquivo público em que um sistema de anúncios lista os vendedores que ele paga — publishers e intermediários — com seus IDs. O objeto SupplyChain (schain) viaja dentro de cada solicitação de lance e lista todas as empresas por onde a impressão passou. Junto com o ads.txt, eles permitem ao comprador confirmar que a impressão vem mesmo do site que diz vir.
Na publicidade programática, uma impressão pode passar por várias empresas antes de chegar ao comprador. O IAB Tech Lab criou o sellers.json e o objeto SupplyChain para tornar esse caminho visível. Se você é publisher, revendedor ou uma plataforma que trabalha com parceiros via schain, é assim que as peças se encaixam.
O que é sellers.json?
O sellers.json é um arquivo JSON que um sistema de anúncios — um SSP, uma exchange ou uma rede — publica na raiz do domínio, por exemplo https://example-ssp.com/sellers.json. Ele lista as contas que o sistema paga pelo inventário. Cada entrada tem:
Campo
Significado
seller_id
O ID da conta no sistema de anúncios. O mesmo ID aparece no ads.txt e no schain
seller_type
PUBLISHER (dono do inventário), INTERMEDIARY (revende) ou BOTH
name e domain
Quem é o vendedor, a menos que a entrada seja confidencial
is_confidential
1 se a identidade do vendedor não é revelada
O arquivo também traz os contatos do sistema e um número de versão. A Wizads publica o próprio arquivo em wizads.eu/sellers.json.
O que é o objeto SupplyChain (schain)?
O objeto SupplyChain viaja em toda solicitação de lance OpenRTB. É uma lista de "nós", um para cada empresa que lidou com a impressão:
asi: o domínio do sistema de anúncios (onde fica o sellers.json dele);
sid: o ID do vendedor nesse sistema;
hp: 1 se o pagamento passa por esse nó;
complete: 1 se a cadeia inclui todos os nós até o dono do inventário.
No OpenRTB 2.5, o objeto fica em source.ext.schain; no OpenRTB 2.6, ele virou o campo padrão source.schain.
Como os compradores usam ads.txt, sellers.json e schain juntos?
O comprador, normalmente um DSP, verifica três coisas:
O ads.txt no site do publisher. O site autoriza o sistema de anúncios e o ID do vendedor do primeiro nó como DIRECT ou RESELLER? Veja nosso guia de ads.txt.
O sellers.json de cada nó. Cada asi publica um sellers.json e o sid existe ali com um tipo de vendedor coerente?
O próprio schain. Ele está completo e parece um caminho razoável, e não uma longa cadeia de revendedores?
Se as verificações falham, muitos compradores reduzem o lance ou descartam a impressão. Um caminho limpo, curto e verificável costuma trazer mais demanda e preços melhores.
O que os publishers devem verificar?
Seu ads.txt lista todos os sistemas de anúncios com que você trabalha, com os IDs de vendedor exatos que eles forneceram.
Cada um desses sistemas lista sua conta no sellers.json, de preferência com nome e domínio, e não como confidencial.
O tipo de vendedor corresponde à realidade: PUBLISHER para o seu próprio site.
Ao trocar de parceiros, remova as linhas antigas do ads.txt: entradas desatualizadas confundem os compradores.
O que revendedores e plataformas devem verificar?
Seu sellers.json está acessível por HTTPS, é um JSON válido e está atualizado.
Toda conta que envia tráfego para você tem uma entrada com o seller_type correto.
Você repassa o schain recebido e adiciona o seu nó, em vez de substituir a cadeia.
Os arquivos ads.txt e app-ads.txt dos seus parceiros listam os seus IDs de vendedor.
Problemas comuns
Problema
Efeito
Solução
ID do schain ausente no sellers.json
O comprador não consegue verificar o nó
Adicionar a conta ao sellers.json
ads.txt não lista o sistema de anúncios
A impressão parece não autorizada
Pedir ao parceiro a linha exata e adicioná-la
Cadeia marcada como incompleta
Menos confiança, menos lances
Repassar a cadeia completa
Muitas entradas confidenciais
Menos transparência
Revelar nomes e domínios sempre que possível
Por que isso importa para a qualidade do tráfego
A falsificação de domínio — vender inventário barato com o nome de um site premium — foi um dos principais motivos para esses padrões surgirem. Com ads.txt, sellers.json e schain, o comprador vê quem vende e quem é o dono do inventário. Isso também faz parte de como as plataformas combatem a fraude de anúncios. Para o panorama completo, veja nosso guia de publicidade programática.
Perguntas frequentes
O sellers.json é obrigatório?
Não é lei, mas muitos compradores esperam encontrá-lo. O inventário de sistemas sem sellers.json costuma valer menos ou ser excluído.
Qual é a diferença entre ads.txt e sellers.json?
O ads.txt é publicado pelo publisher e diz quem pode vender o inventário dele. O sellers.json é publicado pelo sistema de anúncios e diz quem ele paga. Um confirma o outro.
Onde encontro as informações de vendedores da Wizads?
No arquivo público wizads.eu/sellers.json. Se você trabalha com a Wizads como publisher ou parceiro, seu gerente vai passar as linhas exatas para o ads.txt e o seu ID de vendedor.
A Wizads é uma rede de anúncios com DSP, SSP e ad server próprios. Nossa equipe escreve sobre publicidade programática, monetização de sites e compra de tráfego.