Open RTB 2.4 Especificações do pedido de licitação
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
| 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 | Detalhes através de um objeto Site sobre o sítio Web do editor (objeto). |
| aplicação | Sim | Detalhes através de um objeto App sobre a aplicação* do editor (objeto). |
| dispositivo | Sim | Detalhes através de um objeto Dispositivo sobre o dispositivo do utilizador ao qual a impressão será entregue (objeto). |
| utilizador | Não | Detalhes, através de um objeto User, 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ínima para esta impressão (CPM) / clique (CPC) e moeda da conta (flutuante) |
| bidfloorcur | Não | Moeda para o valor mínimo da proposta especificado utilizando códigos alfa ISO-4217 (string) |
| nativo | Apenas para imps nativos e push | Uma oportunidade de objeto nativo (objeto). |
| bandeira | Apenas para banners e imagens intersticiais de página inteira | Uma oportunidade de objeto de banner (objeto). |
| instl | Apenas para pop, ligação direta, e-mail e imagens de clique intersticiais de página inteira | Uma oportunidade de objeto de ecrã inteiro (objeto). |
| vídeo | Apenas para vídeo | Uma oportunidade de objeto de vídeo (objeto) |
| seguro | Recomendado | 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 (opção recomendada). Se omitido, o estado seguro é desconhecido, mas o suporte HTTP não seguro pode ser assumido (número inteiro) |
| el | Não | Email codificado em Base64 (string) |
| ext | Não | Espaço reservado para extensões específicas da bolsa |
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 | Não | Lista de tipos de mime suportados (matriz de strings). Suportamos: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4 |
| ext | Não | Espaço reservado para extensões específicas da bolsa (objeto) |
imp.banner.ext
| Atributo | Necessário? | Descrição |
|---|
| saída de imagem | Não | Indica o formato de saída para banners de imagem* (string) |
| saída de vídeo | Não | Indica 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
| Atributo | Necessário? | Descrição |
|---|
| instl | Sim | 0 = cliques em links diretos/e-mails, 1 = popunder/ intersticial de página inteira |
imp.native (para anúncios nativos e de notificações push)
| Atributo | Necessário? | Descrição |
|---|
| pedido | Sim | Carga ú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) |
| ver | Não | Versão da API Dynamic Native Ads com a qual request está em conformidade (string) |
imp.native.request
| Atributo | Necessário? | Descrição |
|---|
| ver | Sim | Versão da versão do Native Markup em utilização (string) |
| contexto | Não | O 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) |
| plcmttype | Sim | O 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) |
| plcmtcnt | Não | O número de colocações idênticas neste Layout. Máximo: 10 (número inteiro) (número inteiro) |
| activos | Sim | Um 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) |
| seq | Não | 0 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
| Atributo | Necessário? | Descrição |
|---|
| id | Sim | ID ú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ário | Não | Definido como 1 se o ativo for obrigatório ou 0 se o ativo for facultativo (número inteiro) |
| plcmtcnt | Não | O número de colocações idênticas nesta Estrutura (número inteiro) |
| imagem | Sim | Objeto de imagem para activos de imagem** (objeto JSON) |
| título | Não | Objeto de título para activos de título** (objeto JSON) |
| dados | Não | Objeto de dados para nome da marca, descrição, classificações, preços, etc.* (objeto JSON) |
*A quantidade de lances recebidos para sua solicitação Native será baseada no valor que você definir em "plcmtcnt". Por exemplo, uma requisição de lance com "plcmtcnt":3 receberá 3 objetos de lance diferentes. Você pode encontrar exemplos em Página de exemplo de resposta.
** Apenas um dos objectos {img, title, data} deve estar presente em cada objeto de ativo
imp.native.request.assets.img
| Atributo | Necessário? | Descrição |
|---|
| tipo | Não | ID 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) |
| w | Não | Largura da imagem em píxeis, opcional (número inteiro) |
| h | Não | Altura da imagem em píxeis, opcional (número inteiro) |
| wmin | Sim | A largura mínima requerida da imagem em píxeis (número inteiro) |
| hmin | Sim | A 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
| Atributo | Necessário? | Descrição |
|---|
| len | Sim | Comprimento máximo do texto no elemento título. (número inteiro) |
imp.native.request.assets.data
| Atributo | Necessário? | Descrição |
|---|
| tipo | Sim | ID 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) |
| len | Não | Comprimento máximo do texto na resposta do elemento (número inteiro) |
imp.video
| Atributo | Necessário? | Descrição |
|---|
| mímicas | Não | Lista de tipos de mime suportados (matriz de strings) |
| protocolos | Não | Lista de protocolos de resposta a ofertas de vídeo suportados (matriz int) |
| saltar | Não | Indica se o leitor permite que o vídeo seja saltado, sendo 0 = não, 1 = sim |
| saltar depois | Não | Nú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 |
| saltar | Não | Os 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
| Atributo | Necessário? | Descrição |
|---|
| vídeo_cta | Não | Indica 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
| Atributo | Necessário? | Descrição |
|---|
| id | Necessário | ID único do sítio (string) |
| domínio | Necessário | Nome de domínio do sítio (string) |
| nome | Necessário | Nome 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. |
| ext | Não | Espaço reservado para extensões específicas da bolsa para o OpenRTB. |
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 de anúncios personalizada da ExoClick (número inteiro) |
aplicação
| Atributo | Necessário? | Descrição |
|---|
| id | Necessário | ID único 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) |
app.publisher
| Atributo | Necessário? | Descrição |
|---|
| domínio | Recomendado | Domínio de nível mais elevado do editor (por exemplo, "editor.com") (string) |
dispositivo
| Atributo | Necessário? | Descrição |
|---|
| ua | Sim | Agente do utilizador do navegador (string) |
| 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 IP do utilizador (string)* |
| ipv6 | Recomendado | Endereço IPv6 do utilizador (cadeia)* |
| língua | Recomendado | Idioma do navegador que utiliza a norma ISO-639-1-alpha-2 (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) |
utilizador
| Atributo | Necessário? | Descrição |
|---|
| id | Sim | ID ú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
| 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. |
| exportação | Não | A resposta pode ser "json" ou "xml" (string). Por defeito, é "json". |
Exemplos
Você pode encontrar uma lista detalhada de exemplos de solicitação em nossa página de exemplos