Construtor e Validador de schain
Monte e valide o objeto SupplyChain (schain) da IAB para OpenRTB, e exporte tanto o JSON source.ext.schain quanto a string serializada — tudo no seu navegador.
O Construtor e Validador de schain roda inteiramente no seu navegador. Os ids de vendedor, domínios e nós de supply chain que você monta ou cola ficam no seu dispositivo e nunca são enviados à ArrayKit.
Abrir a Referência de Enums OpenRTB
Sobre Construtor de schain
O Construtor e Validador de schain monta o objeto SupplyChain do IAB Tech Lab que trafega em bid requests OpenRTB em source.ext.schain. Adicione cada intermediário como um nó ordenado com seu asi, sid e flag hp (pagamento), defina os valores complete e ver, depois copie tanto o objeto JSON quanto a string serializada com URL-encoding que os exchanges esperam. Mude para o modo Validate para colar um schain existente — como JSON ou como string serializada — e veja na hora campos obrigatórios ausentes, uma flag complete inválida ou uma versão inesperada, com a cadeia de hops desenhada nó por nó. Engenheiros de ad-ops, SSP e header-bidding podem auditar e reparar supply paths aqui mesmo; os nós e ids de vendedor que você cola são analisados no seu dispositivo e nunca enviados.
Recursos
- Adicione, reordene e remova nós de supply chain ordenados (asi, sid, hp, rid, name, domain)
- Alterne a flag complete e fixe ver na especificação 1.0 atual
- Exporta o objeto JSON source.ext.schain do OpenRTB pronto para colocar em um bid request
- Gera a string serializada com URL-encoding que os exchanges aceitam (ver,complete!node!node)
- O modo Validate aceita tanto um schain JSON quanto uma string serializada
- Sinaliza asi, sid ou hp ausentes, uma flag complete inválida e um ver inesperado
- Visualiza a cadeia de hops para você confirmar a ordem dos nós de relance
- Roda inteiramente no seu navegador — ids de vendedor e domínios ficam no seu dispositivo
Como usar Construtor de schain
- Mantenha a aba Build selecionada e preencha asi, sid e a flag hp para cada nó
- Adicione mais nós e use as setas para colocá-los na ordem de publisher para exchange
- Defina a flag complete (1 quando todo o caminho está declarado) e copie o JSON ou a string serializada
- Mude para Validate e cole um schain existente para verificar os campos obrigatórios e a ordem dos nós
Exemplo
Entrada
asi: exchange1.com
sid: 1234
hp: 1
complete: 1
Saída
1.0,1!exchange1.com,1234,1
Um nó serializa para ver,complete!asi,sid,hp; o JSON vai em source.ext.schain.
Erros comuns e solução de problemas
- O Validate reporta que um nó está sem asi, sid ou hp. — Todo nó precisa dos três campos obrigatórios: asi é o domínio canônico do advertising system, sid é o id de vendedor/revendedor daquele sistema, e hp deve ser 0 ou 1.
- O exchange rejeita a string serializada. — Os campos devem ter URL-encoding e estar ordenados asi,sid,hp,rid,name,domain, com vírgulas entre campos e ! entre nós; o segmento de header é ver,complete.
- complete está definido como 1 mas você omitiu um revendedor upstream. — complete=1 afirma que todo intermediário está declarado. Se algum hop for desconhecido, defina complete=0 para que bidders subsequentes saibam que o caminho é parcial.
- sid não corresponde ao id de vendedor no sellers.json. — O sid em cada nó deve ser igual ao seller_id que o sistema correspondente publica em seu sellers.json, ou os compradores tratarão o caminho como não verificado.
Perguntas frequentes
- O que é o objeto schain (SupplyChain)?
- É um objeto do IAB Tech Lab carregado no OpenRTB em source.ext.schain que lista, em ordem, cada advertising system que tocou o bid request entre o publisher e o exchange, para que os compradores possam verificar o supply path.
- O que asi, sid e hp significam em cada nó?
- asi é o domínio canônico do advertising system, sid é o id de conta de vendedor ou revendedor dentro daquele sistema (correspondendo ao seu sellers.json), e hp é 1 quando aquele nó está envolvido no fluxo de pagamento. Os três são obrigatórios por nó.
- Qual a diferença entre o objeto JSON e a string serializada?
- O objeto JSON é a estrutura completa source.ext.schain usada no corpo de um bid request. A string serializada é uma forma compacta com URL-encoding — ver,complete!node!node — onde cada nó é asi,sid,hp,rid,name,domain, usada onde um header ou parâmetro de query é necessário.
- Quando complete deve ser 0 versus 1?
- Defina complete=1 apenas quando todo intermediário do publisher em diante estiver declarado no array de nós. Se algum hop upstream for desconhecido ou omitido, defina complete=0 para que os bidders saibam que a cadeia está incompleta.
- Esta ferramenta busca minha tag de anúncio ou bid request de um servidor?
- Não. Você cola ou monta o schain e tudo — serialização, análise e validação — acontece localmente no seu navegador. Os ids de vendedor, domínios e dados de nó que você insere nunca são enviados à ArrayKit.
- Ele pode validar um schain que copiei de um bid request ao vivo?
- Sim. Cole-o no modo Validate como o objeto JSON (incluindo um source.ext.schain envolvente) ou a string serializada, e a ferramenta verifica os campos obrigatórios dos nós, a flag complete, o ver e desenha a cadeia de hops.
Ferramentas relacionadas
Todas as ferramentas de ArrayKit