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

Resposta ao lance Open RTB 2.4

A resposta para uma solicitação de lance terá a seguinte estrutura:

Objeto de Resposta do Lance

Atributo
Descrição

id

ID da solicitação de lance (string)

seatbid

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

seatbid

Atributo
Descrição

bid

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

seatbid.bid

Atributo
Descrição

id

ID para o 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 de anúncio ExoClick em XML/JSON (string)

nurl

URL de notificação de vitória

cid

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

crid

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

iurl

URL do criativo

ext

Extensão específica da ExoClick (objeto)

A nURL deve ser notificada para garantir a limitação da campanha e evitar receber a mesma resposta sempre.

seatbid.bid.ext

Atributo
Descrição

btype

Modelo de precificação. Valores: 1 = CPM, 2 = CPC*. Padrão = 1 (int). Nota: Quando a resposta for para uma solicitação de zona de Email Clicks, 1 = Smart CPC.

Nota: Apenas Push Notification, Native ads, Direct Link e Email Clicks podem fazer lances com o modelo de precificação CPC.

Resposta sem lance

Para responder a uma solicitação 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 do Lance > Objeto Seat Bid > Objeto de Lance > nurl estiver na resposta do lance, deve ser feita uma solicitação GET para essa URL.

Notificação de faturação

Quando o parâmetro Objeto de Resposta do Lance > Objeto Seat Bid > Objeto de Lance > burl estiver na resposta do lance, é feita uma solicitação GET para essa URL quando a impressão ou o clique se torna faturável (CPM ou CPC, de acordo com o btype campo). Isso permite que a impressão ou o clique seja contabilizado a partir do evento faturável, em vez do rastreamento baseado no lado do cliente, e fornece métricas paralelas métricas de "Servido" nas Estatísticas de RTB. que mostram a diferença entre o que foi renderizado e o que foi faturado.

Se nurl e burl estiverem presentes, ambas devem ser chamadas.

Lógica de contagem

  • Quando o BURL está desativado — A Impressão ou o Clique dependem totalmente 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 é contabilizada 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 faturação, 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. FC continua a depender dos eventos de impressão, independentemente da alternância do BURL.

  • Todas as métricas de "Servido", 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 exemplos.

Última atualização

Isto foi útil?