> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/pt/anunciantes/open-rtb/adv-open-rtb-2.5-response.md).

# 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 <a href="#no-bid-response" id="no-bid-response"></a>

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 <a href="#win-and-billing-notification-urls" id="win-and-billing-notification-urls"></a>

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 **bURL**o ExoClick fará uma chamada a ambos.

### Exemplos <a href="#examples" id="examples"></a>

## Resposta sem licitação <a href="#no-bid-response" id="no-bid-response"></a>

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 <a href="#win-and-billing-notification-urls" id="win-and-billing-notification-urls"></a>

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 **bURL**o ExoClick fará uma chamada a ambos.

## Exemplos <a href="#examples" id="examples"></a>

Pode encontrar exemplos detalhados das Respostas que pode receber na [página de exemplo](/rtb/pt/anunciantes/open-rtb/open-rtb-adv-code-examples-2.5.md).

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/rtb/pt/anunciantes/open-rtb/adv-open-rtb-2.5-response.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.