Pedido de licitação RTB 2.5 aberto
Esta página descreve os diferentes componentes dos pedidos RTB que receberá para licitar.
Cabeçalhos dos 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
- Cabeçalho de codificação de dados: Accept-Encoding
Pedido de Proposta 2.5
Ao solicitar ofertas para um contexto específico, a plataforma efectua um pedido HTTP com um tempo limite de 300ms e envia o seguinte objeto codificado como JSON no corpo do pedido. **Recomenda-se a utilização de HTTP devido à latência adicional da utilização de HTTPS.
| Atributo | Descrição |
|---|
| id | ID exclusivo da solicitação de cotação (string) |
| local | Detalhes através de um objeto Site sobre o sítio Web do editor (objeto) |
| dispositivo | Detalhes do dispositivo do utilizador ao qual a impressão será entregue (objeto) |
| utilizador | Detalhes do utilizador humano do dispositivo; a audiência publicitária (objeto) |
| imp | Detalhes da colocação ou impressão do anúncio que está a ser leiloado (objeto) |
| regulamentos | Informações pormenorizadas sobre quaisquer regulamentos industriais, legais ou governamentais em vigor para este pedido (objeto) |
| ext | Espaço reservado para extensões do OpenRTB (objeto) |
local
| Atributo | Descrição |
|---|
| id | ID único do sítio (string) |
| domínio | Nome de domínio do sítio (string) |
| gato | ID da categoria IAB (cadeia de caracteres) |
| página | URL completo da página onde o anúncio será apresentado (string) |
| palavras-chave | 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 |
| ext | Espaço reservado para extensões específicas da bolsa (objeto) |
site.ext
| Atributo | Descrição |
|---|
| gato de troca | ID da categoria personalizada da ExoClick (número inteiro) |
| idzone | ID da zona de anúncios personalizada da ExoClick (número inteiro) |
| palavra-chave | Palavra-chave correspondente, se existir (string) |
dispositivo
| Atributo | Descrição |
|---|
| ua | Agente do utilizador do navegador (string) |
| seu | Informação estruturada sobre o agente do utilizador, que pode ser utilizada 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 utilizador (cadeia)* |
| língua | Idioma do navegador (string) |
| os | Sistema operativo (string) |
| js | Suporte para JavaScript, em que 0 = não, 1 = sim (número inteiro) |
| ext | Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto) |
*Exatamente um dos ip ou ipv6 estará presente no pedido de cotação.
dispositivo.geo
| Atributo | Descrição |
|---|
| país | País ISO3 |
| ipservice | Serviço ou fornecedor utilizado para determinar a geolocalização a partir do endereço IP, se aplicável (número inteiro) |
dispositivo.ext
| Atributo | Descrição |
|---|
| endereço_remoto | Endereço IP principal do utilizador (string) |
| x_forwarded_for | 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 | Descrição |
|---|
| navegadores | Enviar marcas e versões derivadas do cabeçalho Sec-CH-UA-Full-Version-List. (Conjunto de objectos BrandVersion) |
| plataforma | Envia 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 | Derivar este valor do cabeçalho Sec-CH-UA-Mobile. (número inteiro) |
| arquitetura | Recuperar este valor do cabeçalho Sec-CH-UA-Arch. (string) |
| mordacidade | Recupera este valor do cabeçalho Sec-CH-UA-Bitness. (string) |
| modelo | Recuperar este valor do cabeçalho Sec-CH-UA-Model. (string) |
| fonte | A fonte de dados usada para criar este objeto, Lista: Fonte do Agente do Usuário no AdCOM 1.0 (inteiro; padrão 0) |
| Atributo | Descrição |
|---|
| marca | 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 | Uma sequência de componentes de versão, por ordem hierárquica descendente [maior, menor, micro, ...](array of string) |
utilizador
| Atributo | Descrição |
|---|
| id | ID único do utilizador (string) |
utilizador.ext
| Atributo | Descrição |
|---|
| consentimento | Esta é a cadeia de consentimento exigida pelas normas IAB. Consentimento negativo apenas por enquanto (string) |
regulamentos
| Atributo | Descrição |
|---|
| ext | Espaço reservado para extensões específicas da bolsa para o OpenRTB. |
regs.ext
| Atributo | Descrição |
|---|
| gdpr | É 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. |
imp
| Atributo | Descrição |
|---|
| id | Um identificador único para esta impressão no contexto do pedido de cotação (string) |
| instl | 1 = o anúncio é intersticial ou de ecrã inteiro, 0 = não é intersticial (número inteiro) |
| vídeo | Detalhes através do objeto Vídeo que representa uma impressão de vídeo em fluxo |
| seguro | Sinalizador para indicar se a impressão requer um URL HTTPS seguro (número inteiro) |
| ext | Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto) |
imp.video
| Atributo | Descrição |
|---|
| mímicas | Tipos de conteúdo MIME suportados (por exemplo, "video/mp4") (string array ) |
| mentalização | Duração mínima do anúncio em vídeo em segundos (número inteiro) |
| duração máxima | Duração máxima do anúncio em vídeo em segundos (número inteiro) |
| protocolos | Conjunto de protocolos de vídeo suportados (número inteiro) |
| linearidade | 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 | 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 | Posição do anúncio no ecrã (número inteiro) |
| h | Largura do leitor de vídeo em pixéis independentes do dispositivo (DIPS) (número inteiro) |
| w | Altura do leitor de vídeo em pixéis independentes do dispositivo (DIPS) (número inteiro) |
| ext | Espaço reservado para extensões específicas da bolsa para o OpenRTB (objeto) |
imp.video.ext
| Atributo | Descrição |
|---|
| tipo_de_zona | Tipo de zona dentro dos formatos de anúncio da ExoClick (por exemplo: video_slider) |