bid request e response OpenRTB de exemplo
OpenRTB é o protocolo aberto do IAB Tech Lab para real-time bidding entre SSP/exchange e DSP. Estes exemplos cobrem a 2.5 (a mais difundida), 2.6 (novos campos para CTV e rewarded), 3.0 (novo envelope separando context/item), além de OpenRTB Native 1.2 e Supply Chain Object (schain). Úteis para depurar seu próprio bidder, um adaptador prebid, um wrapper de header bidding ou uma integração com exchange.
Estes não são dumps de uma exchange nem cópias dos exemplos do IAB — são amostras realistas, feitas à mão, construídas estritamente segundo as specs oficiais do IAB Tech Lab. Campos, tipos de dados e valores enumerados (placement, protocols, api, plcmttype, etc.) seguem as specs. Os objetos imp referenciam amostras da samplelib para que os exemplos fiquem interligados.
Especificações oficiais do IAB Tech Lab: OpenRTB 2.5 · OpenRTB 2.6 · OpenRTB 3.0 (GitHub) · AdCOM 1.0 · Native 1.2 · SupplyChain Object
🧠 Como o OpenRTB funciona
OpenRTB é um protocolo HTTP síncrono: o SSP envia um bid request (JSON) para vários DSPs ao mesmo tempo, e cada um tem ~100 ms para responder com um bid response contendo preço e criativo. O vencedor é notificado via nurl/burl, os demais via lurl. A versão 2.5 é o padrão de produção na maioria das exchanges. A 2.6 adicionou campos para CTV (podid, rqddurs, durfloors) e rewarded video. A 3.0 é uma grande reestruturação: um novo envelope com openrtb/item/spec, e o AdCOM 1.0 como spec de criativo separada. Todas as versões coexistem — a escolha depende do parceiro.