> 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/exoclick-rtb/bid-response.md).

# Resposta ao lance do ExoClick RTB

A Resposta de Licitação RTB da ExoClick pode ser feita usando JSON e XML. A resposta a um pedido de licitação deve ter a seguinte estrutura:

## Objeto de Resposta à Licitação

| Atributo    | Descrição                                                                                                                                         |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| id          | ID do objeto de impressão ao qual esta licitação se aplica (string)                                                                               |
| imgUrl      | URL da imagem (apenas para o tipo banner)                                                                                                         |
| iconUrl     | URL do ícone (apenas para o tipo push\_notification e deve ter as dimensões solicitadas)                                                          |
| clickUrl    | URL de redirecionamento quando a campanha é clicada (para o tipo banner ou push\_notification)                                                    |
| url         | URL de redirecionamento quando a campanha é clicada (apenas para o tipo popunder)                                                                 |
| title       | Título do anúncio (apenas para o tipo push\_notification)                                                                                         |
| description | Descrição do anúncio (apenas para o tipo push\_notification)                                                                                      |
| value       | Preço da licitação em CPM ou CPC (float)                                                                                                          |
| imptrackers | Rastreadores de impressão, opcional (apenas para o tipo push\_notification)                                                                       |
| btype       | Modelo de preços. Valores: 1 = CPM, 2 = CPC. Predefinição = 1 (int). Quando a resposta for para um pedido de zona de Email Clicks, 1 = Smart CPC. |
| bUrl        | URL de notificação de faturação; recomenda-se usar HTTP em vez de HTTPS para bUrl                                                                 |

**Notas:**

* **"id"** o atributo deve corresponder ao **"id" recebido no pedido**.
* **Push Notification** o formato de anúncio pode receber licitações com o modelo de preços CPC. **Link Direto** o formato também pode, quando usado para **Cliques de Email** pedidos de zona.
* Além disso, ao executar anúncios Push Notification, apenas um **imptracker** URL é permitida.
* **bURL** é chamada quando a impressão ou o clique é entregue, dependendo de CPM ou CPC no campo btype (predefinição CPM)

## Resposta Sem Licitação

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

## Adicione tokens dinâmicos ao seu endpoint

Além das informações que recebe através do pedido, também pode adicionar **tokens dinâmicos** ao seu endpoint. Isto permitirá que identifique rapidamente a origem do pedido ao analisar os pedidos recebidos.

Aqui encontrará os tokens mais comuns usados pela ExoClick:

* **{site\_id}**: O número de ID do site onde o anúncio é exibido.
* **{zone\_id}**: O ID da zona de anúncios onde o anúncio é exibido.
* **{src\_hostname}**: O nome do site que o Publisher submeteu para exibição de anúncios, sem incluir o protocolo HTTP no início (por exemplo, examplesite.com).
* **{url}**: O URL completo do site que o Publisher submeteu ao Painel de Administração para exibição de anúncios, incluindo o protocolo HTTP (por exemplo, <https://examplesite.com>). Nota: Este token não mostrará o URL onde o anúncio foi exibido ao utilizador; apenas o URL que está registado na nossa plataforma.
* **{tags}**: A lista de palavras-chave que foram identificadas para essa impressão do anúncio.
* **{keyword}**: A palavra-chave que foi correspondida no caso de campanhas direcionadas a palavras-chave específicas. Ficará vazio se não houver correspondência.
* **{language}**: O idioma do visitante.
* **{\&empty=204}**: Adicione-o ao endpoint sempre que devolver uma resposta de No Bid.
* **{imp\_id}**: Adicione-o para receber o ID da impressão no endpoint.

Se precisar de outros tokens ou de acompanhar detalhes adicionais, contacte o seu gestor de conta.

## Exemplos

Pode encontrar exemplos detalhados da resposta de licitação na nossa [página de exemplo de Resposta do Anunciante](/rtb/pt/anunciantes/exoclick-rtb/exoclick-rtb-advertiser-code-examples.md)


---

# 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/exoclick-rtb/bid-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.
