Blog · Publicidade programática

sellers.json e SupplyChain (schain): como os compradores verificam o caminho da impressão

Publicado 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.
Conteúdo
  1. O que é sellers.json?
  2. O que é o objeto SupplyChain (schain)?
  3. Como os compradores usam ads.txt, sellers.json e schain juntos?
  4. O que os publishers devem verificar?
  5. O que revendedores e plataformas devem verificar?
  6. Problemas comuns
  7. Por que isso importa para a qualidade do tráfego
  8. Perguntas frequentes

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:

"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: 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:

  1. 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.
  2. O sellers.json de cada nó. Cada asi publica um sellers.json e o sid existe ali com um tipo de vendedor coerente?
  3. 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.

Sobre o autor

Equipe Wizads

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.

Artigos relacionados