Pedido de licitação RTB 2.5 aberto

Esta página explica como efetuar pedidos de propostas

Sugestão de cabeçalhos de pedidos de propostas

• Cabeçalho HTTP da versão OpenRTB: x-openrtb-version: 2.5
• Cabeçalho HTTP Keep-Alive: Ligação: Keep-Alive
• Content JSON: Content-Type: application/json

Os seguintes objectos devem ser enviados codificados como JSON no corpo do pedido:

Pedido de Proposta

Atributo	Necessário?	Descrição
em	Sim	Tipo de leilão, primeiro preço = 1 (int)
id	Sim	ID exclusivo da solicitação de cotação (string)
imp	Sim	Matriz de objectos Imp que representam as impressões oferecidas (objeto).
local	Sim	Informações sobre o(s) sítio(s) Web do editor.
aplicação	Sim	Detalhes sobre a aplicação (objeto) do editor.
dispositivo	Sim	Detalhes sobre o dispositivo do utilizador ao qual a impressão será entregue (objeto).
utilizador	Não	Detalhes sobre o utilizador humano do dispositivo; o público publicitário (objeto).
ext	Não	Espaço reservado para extensões do OpenRTB.

---

Nota: Apenas um dos objectos {site, app} deve estar presente em cada pedido.

---

imp

Atributo	Necessário?	Descrição
id	Sim	ID de impressão único neste pedido de cotação (string)
piso de licitação	Não	Lance mínimo para esta impressão (CPM) / clique (CPC) e moeda da conta (float).
bandeira	Apenas para imagens de página inteira	Um objeto de faixa (objeto).
seguro	Não; Recomendado 1	Sinalizador para indicar se a impressão requer activos criativos e marcação de URL HTTPS seguros, em que 0 = não seguro, 1 = seguro. Se omitido, o estado seguro é desconhecido, mas o suporte HTTP não seguro pode ser assumido, opcional (número inteiro)

imp.banner

Atributo	Necessário?	Descrição
w	Sim	Largura da faixa (número inteiro)
h	Sim	Altura da faixa (número inteiro)
mímicas	Sim	Tipos de mímicas - imagem/jpg, imagem/png, vídeo/mp4 ou imagem/webp

imp.video

Atributo	Necessário?	Descrição
mímicas	Sim	Tipos de conteúdo MIME suportados (por exemplo, "video/mp4") (string array )
mentalização	Não	Duração mínima do anúncio em vídeo em segundos (número inteiro)
duração máxima	Não	Duração máxima do anúncio em vídeo em segundos (número inteiro)
protocolos	Não	Conjunto de protocolos de vídeo suportados (número inteiro)
linearidade	Não	Indica se a impressão tem de ser linear, não linear, etc. Se não for especificado nenhum, assume que todos são permitidos (número inteiro)
boxe permitido	Não	Indica se é permitida a utilização de letter-boxing de conteúdos 4:3 numa janela 16:9, sendo 0 = não, 1 = sim (número inteiro)
pos	Não	Posição do anúncio no ecrã (número inteiro)
h	Não	Largura do leitor de vídeo em pixéis independentes do dispositivo (DIPS) (número inteiro)
w	Não	Altura do leitor de vídeo em pixéis independentes do dispositivo (DIPS) (número inteiro)
ext	Não	Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto)

imp.video.ext

Atributo	Necessário?	Descrição
tipo_de_zona	Não	Tipo de zona dentro dos formatos de anúncio da ExoClick (por exemplo: video_slider)
cta	Não	Especifica se a zona de anúncio mostra um componente de CTA (número inteiro)

local

Atributo	Necessário?	Descrição
id	Recomendado	ID único do sítio (string)
nome	Não	Nome do sítio (string)
domínio	Recomendado	Nome de domínio do sítio (string)
gato	Não	ID da categoria IAB (cadeia de caracteres)
página	Recomendado	URL completo da página onde o anúncio será apresentado (string)
palavras-chave	Não	As palavras-chave podem ser utilizadas para garantir que as zonas de anúncios obtêm o tipo correto de publicidade. As palavras-chave devem ser uma sequência de palavras separadas por vírgulas

site.ext

Atributo	Necessário?	Descrição
gato de troca	Não	ID da categoria personalizada da ExoClick (número inteiro)
idzone	Não	ID da zona ExoClick personalizada (número inteiro)

aplicação

Atributo	Necessário?	Descrição
id	Recomendado	ID único da aplicação (string)
nome	Não	Nome da aplicação (string)
domínio	Recomendado	Nome de domínio da aplicação (string)
gato	Não	ID da categoria IAB (cadeia de caracteres)
palavras-chave	Não	As palavras-chave podem ser utilizadas para garantir que as zonas de anúncios obtêm o tipo correto de publicidade. As palavras-chave devem ser uma cadeia de palavras separadas por vírgulas (cadeia)
editor	Não	Detalhes sobre o Editor (objeto)

dispositivo

Atributo	Necessário?	Descrição
ua	Sim	Agente do utilizador do navegador (string)
seu	Não	Informação estruturada sobre o agente do utilizador, que pode ser utilizada quando um cliente suporta User-Agent Client Hints (objeto)
geo	Não	A localização do dispositivo é assumida como a localização atual do utilizador definida por um objeto Geo.
ip	Sim	Endereço IPv4 do utilizador (string)*
ipv6	Sim	Endereço IPv6 do utilizador (string)*
língua	Recomendado	Idioma do navegador (string)
os	Não	Sistema operativo (string)
js	Não	Suporte para JavaScript, em que 0 = não, 1 = sim (número inteiro)
ext	Não	Espaço reservado para extensões específicas da bolsa para o OpenRTB

Nota: Só precisa de incluir ip ou ipv6 no seu pedido, não ambos. Se utilizar ipv6, remova o atributo ip, e vice-versa. A inclusão de ambos pode causar erros.

dispositivo.geo

Atributo	Necessário?	Descrição
país	Não	País ISO3

dispositivo.ext

Atributo	Necessário?	Descrição
endereço_remoto	Não	Endereço IP principal do utilizador (string)
x_forwarded_for	Não	Endereço IP X-FORWARDED-FOR do utilizador ou vazio se não estiver definido (string)

dispositivo.sua

Informação estruturada do agente do utilizador. o device.sua é considerado a representação mais exacta dos atributos do dispositivo.

Atributo	Necessário?	Descrição
navegadores	Recomendado	Os implementadores devem enviar marcas e versões derivadas do cabeçalho Sec-CH-UA-Full-Version-List. (Conjunto de objectos BrandVersion)
plataforma	Recomendado	Os implementadores devem enviar uma marca derivada do cabeçalho Sec-CH-UA-Platform e uma versão derivada do cabeçalho Sec-CH-UA-Platform-Version. (Objeto BrandVersion)
móvel	Recomendado	Os responsáveis pela implementação devem derivar este valor do cabeçalho Sec-CH-UA-Mobile. (número inteiro)
arquitetura	Recomendado	Os responsáveis pela implementação devem obter este valor a partir do cabeçalho Sec-CH-UA-Arch. (string)
mordacidade	Recomendado	Os responsáveis pela implementação devem obter este valor a partir do cabeçalho Sec-CH-UA-Bitness. (string)
modelo	Recomendado	Os responsáveis pela implementação devem obter este valor a partir do cabeçalho Sec-CH-UA-Model. (string)
fonte	Recomendado	A fonte de dados usada para criar este objeto, Lista: Fonte do Agente do Usuário no AdCOM 1.0 (inteiro; padrão 0)

device.sua.browsers | device.sua.platform

Atributo	Necessário?	Descrição
marca	Necessário	O valor pode ser obtido a partir dos cabeçalhos User-Agent Client Hints, representando a marca do agente do utilizador (a partir do cabeçalho Sec-CH-UA-Full-Version) ou a marca da plataforma (a partir do cabeçalho Sec-CH-UA-Platform). (string)
versão	Recomendado	Uma sequência de componentes de versão, por ordem hierárquica descendente [maior, menor, micro, ...](array of string)

utilizador

Atributo	Necessário?	Descrição
id	Não	ID único do utilizador (string)
ext	Não	Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto)

utilizador.ext

Atributo	Necessário?	Descrição
consentimento	Não	Esta é a cadeia de consentimento exigida pelas normas IAB. Consentimento negativo apenas por enquanto (string)

regulamentos

Atributo	Necessário?	Descrição
ext	Não	Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto)

regs.ext

Atributo	Necessário?	Descrição
gdpr	Não	É 0 se o chamador considerar que o utilizador não está abrangido pelo RGPD, e 1 se o utilizador estiver abrangido pelo RGPD. Se nenhum dos dois, este parâmetro será indefinido.

ext

Atributo	Necessário?	Descrição
submarino	Não	O Sub ID. Este deve ser um número entre um e dez dígitos: Não utilizar zeros no início dos Sub IDs.