Pedido de lance Open RTB 2.5

Esta página descreve os diferentes componentes das solicitações RTB que você receberá para dar lances.

Cabeçalhos da solicitação de lance

• Cabeçalho HTTP da versão OpenRTB: x-openrtb-version: 2.5
• Cabeçalho HTTP Keep-Alive: Connection: Keep-Alive
• JSON de conteúdo: Content-Type: application/json
• Cabeçalho de codificação de dados: Accept-Encoding

Pedido de Lance 2.5

Ao solicitar lances para um contexto específico, a plataforma fará uma solicitação HTTP com um tempo limite de 300ms e enviará o seguinte objeto codificado como JSON no corpo da solicitação. HTTP é recomendado devido à latência extra ao usar HTTPS.

Atributo	Descrição
id	ID exclusivo da solicitação de lance (string)
site	Detalhes, através de um objeto Site, sobre o website do editor (objeto)
device	Detalhes do dispositivo do utilizador ao qual a impressão será entregue (objeto)
user	Detalhes do utilizador humano do dispositivo; o público-alvo da publicidade (objeto)
imp	Detalhes do espaço publicitário ou da impressão que está a ser leiloada (objeto)
regs	Detalhes de quaisquer regulamentações do setor, legais ou governamentais em vigor para este pedido (objeto)
ext	Espaço reservado para extensões ao OpenRTB (objeto)

site

Atributo	Descrição
id	ID exclusivo do site (string)
domain	Nome de domínio do site (string)
cat	ID de categoria IAB (matriz de strings)
page	URL completa da página onde o anúncio será exibido (string)
keywords	As palavras-chave podem ser usadas para garantir que as zonas de anúncio recebam o tipo certo de publicidade. As palavras-chave devem ser uma string de palavras separadas por vírgulas
ext	Espaço reservado para extensões específicas da exchange (objeto)

site.ext

Atributo	Descrição
exchangecat	ID de categoria personalizada do ExoClick (inteiro)
idzone	ID de zona de anúncio personalizado do ExoClick (inteiro)
keyword	Palavra-chave correspondente, se houver (string)

device

Atributo	Descrição
ua	User agent do navegador (string)
sua	Informações estruturadas do user agent, que podem ser usadas quando um cliente suporta User-Agent Client Hints (objeto)
geo	Localização do dispositivo assumida como sendo a localização atual do utilizador, definida por um objeto Geo
ip	Endereço IPv4 do utilizador (string)*
ipv6	Endereço IPv6 do usuário (string)*
language	Idioma do navegador (string)
os	Sistema operacional (string)
js	Suporte a JavaScript, onde 0 = não, 1 = sim (inteiro)
ext	Espaço reservado para extensões específicas da exchange ao OpenRTB (objeto)

*Apenas um de ip ou ipv6 estará presente na solicitação de lance.

device.geo

Atributo	Descrição
country	País ISO3
ipservice	Serviço ou fornecedor utilizado para determinar a geolocalização a partir do endereço IP, se aplicável (inteiro)

device.ext

Atributo	Descrição
remote_addr	Endereço IP principal do usuário (string)
x_forwarded_for	Endereço IP X-FORWARDED-FOR do usuário ou vazio se não estiver definido (string)

device.sua

Informações estruturadas do User Agent. device.sua é considerada a representação mais precisa dos atributos do dispositivo.

Atributo	Descrição
browsers	Envie marcas e versões derivadas do cabeçalho Sec-CH-UA-Full-Version-List. (Matriz de BrandVersion objetos)
platform	Envie uma marca derivada do cabeçalho Sec-CH-UA-Platform e a versão derivada do cabeçalho Sec-CH-UA-Platform-Version. (BrandVersion Objeto)
mobile	Derive este valor do cabeçalho Sec-CH-UA-Mobile. (inteiro)
architecture	Recupere este valor do cabeçalho Sec-CH-UA-Arch. (string)
bitness	Recupere este valor do cabeçalho Sec-CH-UA-Bitness. (string)
model	Recupere este valor do cabeçalho Sec-CH-UA-Model. (string)
source	A origem dos dados usada para criar este objeto, Lista: Origem do User-Agent no AdCOM 1.0 (inteiro; padrão 0)

device.sua.browsers | device.sua.platform

Atributo	Descrição
brand	O valor pode ser obtido dos cabeçalhos User-Agent Client Hints, representando ou a marca do user agent (do Sec-CH-UA-Full-Version) ou a marca da plataforma (do Sec-CH-UA-Platform). (string)
version	Uma sequência de componentes da versão, em ordem hierárquica decrescente [maior, menor, micro, …] (matriz de strings)

user

Atributo	Descrição
id	ID exclusivo do usuário (string)

user.ext

Atributo	Descrição
consentimento	Esta é a string de consentimento exigida pelas normas da IAB. Apenas consentimento negativo, por agora (string)

regs

Atributo	Descrição
ext	Espaço reservado para extensões específicas da exchange para OpenRTB.

regs.ext

Atributo	Descrição
gdpr	É 0 se o chamador acreditar que o utilizador não está sujeito ao RGPD, e 1 se o utilizador estiver sujeito ao RGPD. Se nenhum dos dois, este parâmetro ficará indefinido.

imp

Atributo	Descrição
id	Um identificador exclusivo para esta impressão no contexto do pedido de lance (string)
instl	1 = o anúncio é intersticial ou em ecrã inteiro, 0 = não intersticial (inteiro)
video	Detalhes através de um objeto Video que representa uma impressão de vídeo in-stream
secure	Sinalizador para indicar se a impressão requer URL HTTPS seguro (inteiro)
ext	Espaço reservado para extensões específicas da exchange ao OpenRTB (objeto)

imp.video

Atributo	Descrição
mimes	Tipos MIME de conteúdo suportados (por exemplo, "video/mp4") (array de strings)
minduration	Duração mínima do anúncio em vídeo em segundos (inteiro)
maxduration	Duração máxima do anúncio em vídeo em segundos (inteiro)
protocols	Matriz de protocolos de vídeo suportados (inteiro)
linearity	Indica se a impressão deve ser linear, não linear, etc. Se não for especificado nenhum, assuma que todos são permitidos (inteiro)
boxingallowed	Indica se é permitida a letterboxing de conteúdo 4:3 numa janela 16:9, onde 0 = não, 1 = sim (inteiro)
pos	Posição do anúncio no ecrã (inteiro)
h	Largura do reprodutor de vídeo em píxeis independentes do dispositivo (DIPS) (inteiro)
w	Altura do reprodutor de vídeo em píxeis independentes do dispositivo (DIPS) (inteiro)
ext	Espaço reservado para extensões específicas da exchange ao OpenRTB (objeto)

imp.video.ext

Atributo	Descrição
zone_type	Tipo de zona dentro dos formatos de anúncios do ExoClick (por exemplo: video_slider)