Resposta ao lance Open RTB 2.5

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

Objeto de resposta de licitação

Atributo	Obrigatório?	Descrição
id	Sim	ID do pedido de lance, deve corresponder ao id enviado no pedido (string)
seatbid	Sim	Coleção de lances feitos pelo licitante em nome de um seat específico.

seatbid

Atributo	Obrigatório?	Descrição
bid	Sim	ID do objeto de impressão ao qual este lance se aplica, deve corresponder ao id enviado no pedido (string)

seatbid.bid

Atributo	Obrigatório?	Descrição
id	Sim	ID para o objeto de lance escolhido pelo licitante (string)
impid	Sim	ID do objeto de impressão ao qual esta licitação se aplica (string)
price	Sim	Preço da licitação em CPM ou CPC (float)
adm	Sim	Marcação do anúncio (string)
nurl	Sim	URL de notificação de vitória, recomenda-se usar HTTP em vez de HTTPS para nurl (string)

seatbid.bid.ext

Atributo	Obrigatório?	Descrição
btype	Recomendado	Modelo de preços. Valores: 1 = CPM, 2 = CPC. Predefinição = 1 (int). Quando a resposta é para um pedido da zona Email Clicks, 1 = Smart CPC.
		Nota: Apenas Push Notification, anúncios nativos, Direct Link e Email Clicks podem licitar com o modelo de preços CPC.

Notas:

• Oferecemos suporte a vídeo em posicionamentos intersticiais.
• O impid deve corresponder ao fornecido no pedido.

Resposta sem licitação

Para responder a um pedido de licitação sem fazer uma licitação real, deve ser enviada uma resposta HTTP com o código 204 "No Content".

URLs de notificação de vitória e de faturação

Se qualquer um dos nURL ou o bURL estão na resposta de lance e são URLs válidos, a plataforma ExoClick enviará um pedido GET para eles. Estas URLs podem conter alguns tokens a serem substituídos pela ExoClick antes de fazer o GET:

${AUCTION_ID} - ID do pedido de licitação; do atributo "Bid Request Object -> id".
${AUCTION_BID_ID} - ID da licitação; do atributo "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID da impressão acabada de ganhar; do atributo "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID do assento do licitante para o qual a licitação foi feita; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID da marcação do anúncio que o licitante pretende servir; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Preço de liquidação usando a mesma moeda e unidades da conta; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - A moeda usada na licitação (explícita ou implícita); apenas para confirmação.

Exemplo:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Se estiver a usar ambos nURL e bURLo ExoClick fará uma chamada a ambos.

Exemplos

Resposta sem licitação

Para responder a um pedido de licitação sem fazer uma licitação real, deve ser enviada uma resposta HTTP com o código 204 "No Content".

URLs de notificação de vitória e de faturação

Se qualquer um dos nURL ou o bURL estão na resposta de lance e são URLs válidos, a plataforma ExoClick enviará um pedido GET para eles. Estas URLs podem conter alguns tokens a serem substituídos pela ExoClick antes de fazer o GET:

${AUCTION_ID} - ID do pedido de licitação; do atributo "Bid Request Object -> id".
${AUCTION_BID_ID} - ID da licitação; do atributo "Bid Response Object -> bidid".
${AUCTION_IMP_ID} - ID da impressão acabada de ganhar; do atributo "Bid Request Object -> Impression Object -> id".
${AUCTION_SEAT_ID} - ID do assento do licitante para o qual a licitação foi feita; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> id".
${AUCTION_AD_ID} - ID da marcação do anúncio que o licitante pretende servir; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> adid".
${AUCTION_PRICE} - Preço de liquidação usando a mesma moeda e unidades da conta; do atributo "Bid Response Object -> Seat Bid Object -> Bid Object -> price".
${AUCTION_CURRENCY} - A moeda usada na licitação (explícita ou implícita); apenas para confirmação.

Exemplo:

https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}&currency=${AUCTION_CURRENCY}

Se estiver a usar ambos nURL e bURLo ExoClick fará uma chamada a ambos.

Exemplos

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