Skip to main content

Especificações do pedido de concurso RTB aberto

Esta página explica como efetuar pedidos de propostas

Cabeçalhos dos pedidos de propostas

  • Cabeçalho HTTP da versão OpenRTB: x-openrtb-version: 2.4
  • cabeçalho HTTP Keep-Alive**: Connection: Keep-Alive
  • Content JSON: Content-Type: application/json

The following objects should be sent encoded as JSON in the request body:  

Pedido de Proposta

AtributoNecessário?Descrição
emSimTipo de leilão, primeiro preço = 1 (int)
idSimID exclusivo da solicitação de cotação (string)
impSimMatriz de objectos Imp que representam as impressões oferecidas (objeto).
localSimDetalhes através de um objeto Site sobre o sítio Web do editor (objeto).
dispositivoSimDetalhes através de um objeto Dispositivo sobre o dispositivo do utilizador ao qual a impressão será entregue (objeto).
utilizadorNãoDetalhes, através de um objeto User, sobre o utilizador humano do dispositivo; o público publicitário (objeto).
extNãoEspaço reservado para extensões do OpenRTB.

imp

AtributoNecessário?Descrição
idSimID de impressão único neste pedido de cotação (string)
piso de licitaçãoNãoLance mínima para esta impressão (CPM) / clique (CPC) e moeda da conta (flutuante)
bidfloorcurNãoMoeda para o valor mínimo da proposta especificado utilizando códigos alfa ISO-4217 (string)
nativoApenas para imps nativos e pushUma oportunidade de objeto nativo (objeto).
bandeiraApenas para banners impsUma oportunidade de objeto de banner (objeto).
instlApenas para imagens pop, de ligação direta e de clique por correio eletrónicoUma oportunidade de objeto de ecrã inteiro (objeto).
vídeoApenas para vídeoUma oportunidade de objeto de vídeo (objeto)
seguroRecomendadoSinalizador para indicar se a impressão requer activos criativos e marcação de URL HTTPS seguros, em que 0 = não seguro, 1 = seguro (opção recomendada). Se omitido, o estado seguro é desconhecido, mas o suporte HTTP não seguro pode ser assumido (número inteiro)
elNãoEmail codificado em Base64 (string)
extNãoEspaço reservado para extensões específicas da bolsa

imp.banner

AtributoNecessário?Descrição
wSimLargura da faixa (número inteiro)
hSimAltura da faixa (número inteiro)
mímicasNãoLista de tipos de mime suportados (matriz de strings). Suportamos: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4
extNãoEspaço reservado para extensões específicas da bolsa (objeto)

imp.banner.ext

AtributoNecessário?Descrição
saída de imagemNãoIndica o formato de saída para banners de imagem* (string)
saída de vídeoNãoIndica o formato de saída para banners de vídeo* (string)

*Define o formato do campo adm para o formato do banner. As opções são xml ou html. O valor por defeito é xml no caso de o campo não ser fornecido.

imp.instl

AtributoNecessário?Descrição
instlSim0 = cliques em links diretos/e-mails, 1 = popunder

imp.native (para anúncios nativos e de notificações push)

AtributoNecessário?Descrição
pedidoSimCarga útil do pedido em conformidade com a especificação de anúncios nativos - uma cadeia JSON codificada do pedido de anúncios nativos, incluindo o seu objeto nativo de nível superior (objeto JSON)
verNãoVersão da API Dynamic Native Ads com a qual request está em conformidade (string)

imp.native.request

AtributoNecessário?Descrição
verSimVersão da versão do Native Markup em utilização (string)
contextoNãoO contexto em que o anúncio aparece. Neste caso, é 1 (contexto centrado no conteúdo, como feed de notícias, artigo, galeria de imagens, galeria de vídeos ou semelhante), opcional (número inteiro)
plcmttypeSimO design/formato/layout do bloco de anúncios que está a ser oferecido. Atualmente, suportamos 4 (Widget de recomendação) e 500 (Push Notification) (número inteiro)
plcmtcntNãoO número de colocações idênticas neste Layout. Máximo: 10 (número inteiro) (número inteiro)
activosSimUm conjunto de objectos de activos. Qualquer resposta da proposta tem de estar em conformidade com o conjunto de elementos expressos no pedido de proposta (conjunto de objectos JSON)
seqNão0 para o primeiro anúncio, 1 para o segundo anúncio, e assim por diante. Note-se que, em geral, esta opção NÃO deve ser utilizada em combinação com plcmtcnt - ou está a leiloar várias colocações idênticas (nesse caso, plcmtcnt>1, seq=0) ou está a realizar leilões separados para itens distintos no feed (nesse caso, plcmtcnt=1, seq=>=1)

imp.native.request.assets

AtributoNecessário?Descrição
idSimID único do ativo, atribuído pela bolsa. Normalmente, um contador para a matriz (número inteiro) 1: ID do ativo imagem, 2: ID do ativo título, 3: ID do ativo descrição
necessárioNãoDefinido como 1 se o ativo for obrigatório ou 0 se o ativo for facultativo (número inteiro)
plcmtcntNãoO número de colocações idênticas nesta Estrutura (número inteiro)
imagemSimObjeto de imagem para activos de imagem** (objeto JSON)
títuloNãoObjeto de título para activos de título** (objeto JSON)
dadosNãoObjeto de dados para nome da marca, descrição, classificações, preços, etc.* (objeto JSON)

*The amount of bids received for your Native request will be based on the value you set in "plcmtcnt". For example, a bid request with "plcmtcnt":3 will receive 3 different bid objects. You can find an example of this in the Response example page.

** Apenas um dos objectos {img, title, data} deve estar presente em cada objeto de ativo

imp.native.request.assets.img

AtributoNecessário?Descrição
tipoNãoID de tipo do elemento de imagem suportado pelo editor. Suportamos: 1 (Imagem de ícone) (número inteiro), 3 (Pré-visualização de imagem grande para o anúncio) (número inteiro)
wNãoLargura da imagem em píxeis, opcional (número inteiro)
hNãoAltura da imagem em píxeis, opcional (número inteiro)
wminSimA largura mínima requerida da imagem em píxeis (número inteiro)
hminSimA altura mínima requerida da imagem em píxeis (número inteiro)

*Dimensões do ícone de notificação rápida: 192px x 192px

imp.native.request.assets.title

AtributoNecessário?Descrição
lenSimComprimento máximo do texto no elemento título. (número inteiro)

imp.native.request.assets.data

AtributoNecessário?Descrição
tipoSimID do tipo do elemento suportado pelo editor (número inteiro). Suportamos: 1 (sponsored - Mensagem patrocinada por onde a resposta deve conter o nome da marca do patrocinador), 2 (desc - Texto descritivo associado ao produto ou serviço que está a ser anunciado)
lenNãoComprimento máximo do texto na resposta do elemento (número inteiro)

imp.video

AtributoNecessário?Descrição
mímicasNãoLista de tipos de mime suportados (matriz de strings)
protocolosNãoLista de protocolos de resposta a ofertas de vídeo suportados (matriz int)
saltarNãoIndica se o leitor permite que o vídeo seja saltado, sendo 0 = não, 1 = sim
saltar depoisNãoNúmero de segundos que um vídeo tem de ser reproduzido antes de ser possível saltar; apenas aplicável se o anúncio puder ser saltado
saltarNãoOs vídeos com uma duração total superior a este número de segundos podem ser saltados; apenas aplicável se o anúncio for saltável

Nota: Se fornecer apenas "skip" no pedido, mas não "skipafter", o vídeo pode ser saltado após 5 segundos. A resposta definirá "skipoffset" para 5. Se fornecer "skip" mas não "skipmin", o vídeo poderá ser saltado independentemente da sua duração.


imp.ext

AtributoNecessário?Descrição
vídeo_ctaNãoIndica se as AIC devem ser fornecidas, sendo 0 = não, 1 = sim (predefinição 1)

To see an example of CTA, please check our Response example page.  

local

AtributoNecessário?Descrição
idNecessárioID único do sítio (string)
domínioNecessárioNome de domínio do sítio (string)
nomeNecessárioNome do sítio (string)
gatoNãoID da categoria IAB (cadeia de caracteres)
páginaRecomendadoURL completo da página onde o anúncio será apresentado (string)
palavras-chaveNãoAs 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.
extNãoEspaço reservado para extensões específicas da bolsa para o OpenRTB.

site.ext

AtributoNecessário?Descrição
gato de trocaNãoID da categoria personalizada da ExoClick (número inteiro)
idzoneNãoID da zona de anúncios personalizada da ExoClick (número inteiro)

aplicação

AtributoNecessário?Descrição
idNecessárioID único da aplicação (string)
gatoNãoID da categoria IAB (cadeia de caracteres)
palavras-chaveNãoAs 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)
editorNãoDetalhes sobre o Editor (objeto)

Nota: Não é possível enviar o objeto "app" juntamente com "site" ou vice-versa.


app.publisher

AtributoNecessário?Descrição
domínioRecomendadoDomínio de nível mais elevado do editor (por exemplo, "editor.com") (string)

dispositivo

AtributoNecessário?Descrição
uaSimAgente do utilizador do navegador (string)
geoNãoA localização do dispositivo é assumida como a localização atual do utilizador definida por um objeto Geo.
ipSimEndereço IP do utilizador (string)*
ipv6RecomendadoEndereço IPv6 do utilizador (cadeia)*
línguaRecomendadoIdioma do navegador que utiliza a norma ISO-639-1-alpha-2 (string)
osNãoSistema operativo (string)
jsNãoSuporte para JavaScript, em que 0 = não, 1 = sim (número inteiro)
extNãoEspaç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

AtributoNecessário?Descrição
paísNãoPaís ISO3

dispositivo.ext

AtributoNecessário?Descrição
endereço_remotoNãoEndereço IP principal do utilizador (string)
x_forwarded_forNãoEndereço IP X-FORWARDED-FOR do utilizador ou vazio se não estiver definido (string)

utilizador

AtributoNecessário?Descrição
idSimID único do utilizador (string)

Nota: Se não for possível gerar uma cadeia de ID de utilizador, pode deixá-la vazia (""). O pedido obterá uma resposta desde que o objeto "user" esteja incluído no pedido.


ext

AtributoNecessário?Descrição
submarinoNãoO Sub ID. Este deve ser um número entre seis e dez dígitos: Não utilizar zeros no início dos Sub IDs.
exportaçãoNãoA resposta pode ser "json" ou "xml" (string). Por defeito, é "json".

Note: Sub IDs should be a number between 1 and Int32: Do not use zeroes at the beginning of Sub IDs.


Exemplos

You can find a detailed list of Request examples in our example page