> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/pt/anunciantes/open-rtb/adv-open-rtb-2.5-request.md). # 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](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) 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) | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/pt/anunciantes/open-rtb/adv-open-rtb-2.5-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.