For the complete documentation index, see llms.txt. This page is also available as Markdown.

Resposta ao lance Open RTB 2.5

A resposta a um pedido de lance terá a seguinte estrutura:

Objeto de Resposta de Lance

Atributo
Descrição

id

ID do pedido de lance (string)

seatbid

Coleção de lances feitos pelo licitante em nome de um assento específico.

seatbid

Atributo
Descrição

lance

ID do objeto de impressão ao qual este lance se aplica (string)

seatbid.bid

Atributo
Descrição

id

ID do objeto de lance escolhido pelo licitante (string)

impid

ID do objeto de impressão ao qual este lance se aplica (string)

price

Preço do lance em CPM ou CPC (float)

adm

Marcação XML de anúncio ExoClick (string)

nurl

URL de notificação de vitória (string)

burl

URL de notificação de faturamento (string)

cid

ID da campanha para ajudar na verificação da qualidade do anúncio (string)

crid

ID do criativo para ajudar na verificação da qualidade do anúncio (string)

adid

ID do anúncio para ajudar na verificação da qualidade do anúncio (igual a crid) (string)

adomain

Domínio do anunciante ou domínio do intercâmbio (array de strings)

cat

Categorias de conteúdo IAB do criativo (array de strings)

w

Largura do criativo (inteiro)

h

Altura do criativo (inteiro)

ext

Extensão específica do ExoClick (objeto)

seatbid.bid.ext

Atributo
Descrição

btype

Modelo de preços. Valores: 1 = CPM, 2 = CPC. Padrão = 1 (int).

Nota: Apenas Push Notification, anúncios nativos, Direct Link e Email Clicks podem fazer lances com o modelo de preços CPC.

Resposta sem lance

Para responder a um pedido de lance sem fazer um lance real, será enviado um código de resposta HTTP 204 "No Content".

Notificação de vitória

Quando o parâmetro Objeto de Resposta de Lance -> Objeto de Lance de Assento -> Objeto de Lance -> nurl está na resposta de lance, deve ser efetuado um pedido GET para esse URL.

Notificação de faturamento

Quando o parâmetro Objeto de Resposta de Lance > Objeto de Lance de Assento > Objeto de Lance > burl está na resposta de lance, é efetuado um pedido GET para esse URL quando a impressão ou o clique se torna faturável (CPM ou CPC, de acordo com o btype campo). Isto permite que a impressão ou o clique sejam contados a partir do evento faturável em vez do rastreamento baseado no lado do cliente, e fornece métricas "Served" paralelas "Served" nas Estatísticas RTB. que mostram a diferença entre o que foi renderizado e o que foi faturado.

Se nurl e burl estiverem presentes, ambos devem ser chamados.

Lógica de contagem

  • Quando o BURL está desativado — A Impressão ou o Clique dependem inteiramente do rastreador do lado do cliente acionado pelo anúncio renderizado. É o padrão atual para contar impressões e cliques.

  • Quando o BURL está ativado — A Impressão ou o Clique é contado a partir da chamada burl em vez do rastreamento do lado do cliente.

  • Quando o BURL está ativado, mas o parceiro não o aciona — A contagem de Impressões ou Cliques cai para zero para fins de faturamento, enquanto as impressões servidas (o que o navegador registou) permanecem. Esta discrepância sinaliza um problema técnico de integração.

O que permanece no rastreamento do lado do cliente

  • Limitação de frequência. A FC continua a depender de eventos de impressão independentemente do alternar do BURL.

  • Todas as métricas "Served", por definição.

  • Zonas diretas (não RTB), que não têm o conceito de BURL.

Exemplos

Pode encontrar exemplos detalhados das Respostas que pode receber na página de exemplo.

Última atualização

Isto foi útil?