Open RTB Bid Response Specifications
A resposta a um pedido de concurso deve ter a seguinte estrutura:
resposta
| Atributo | Necessário? | Descrição |
|---|---|---|
| id | Sim | ID da solicitação de cotação para a qual esta é uma resposta (string) |
| oferta de lugares | Sim | Coleção de propostas feitas pelo proponente em nome de um banco específico (matriz) |
Nota: O ID deve corresponder ao fornecido no pedido
oferta de lugares
| Atributo | Necessário? | Descrição |
|---|---|---|
| oferta | Sim | Matriz do objeto de oferta relacionado com a impressão visada |
seatbid.bid
| Atributo | Necessário? | Descrição |
|---|---|---|
| id | Sim | ID para o objeto de cotação, utilizado para rastreio (string) |
| impiedoso | Sim | ID do objeto de impressão na solicitação de cotação relacionada. |
| preço | Sim | Preço da proposta em CPM ou CPC (flutuante) |
| adm | Sim | Marcação de anúncios XML/JSON (string) |
| nurl | Sim | URL da notificação do ganho, recomenda-se a utilização de HTTP sobre HTTPS para nurl (string) |
| rebarba | Não | URL da notificação de faturação, recomenda-se a utilização de HTTP sobre HTTPS para nurl (string) |
| crosta | Recomendado | ID criativa para ajudar no controlo da qualidade do anúncio (string) |
| iurl | Recomendado | URL do criativo |
| ext | Não | Extensão específica ExoClick (objeto) |
Observações:
- O impid deve corresponder ao fornecido no pedido.
- A admissão deve ser fornecida em JSON ou XML com base no formato de anúncio visado: JSON para Native, In-Stream e Push Notifications; XML para todos os outros formatos.
- O nURL deve ser notificado para garantir o limite da campanha e evitar obter sempre a mesma resposta.
- O bURL é chamado quando as impressões ou os cliques são entregues, dependendo do CPM ou CPC do campo btype (CPM predefinido).
seatbid.bid.ext
| Atributo | Necessário? | Descrição |
|---|---|---|
| tipo b | Recomendado | Modelo de preços. Valores: 1 = CPM, 2 = CPC. Predefinição = 1 (int). |
Nota: Quando a resposta é para um pedido de zona de cliques de correio eletrónico, 1 = CPC inteligente.
seatbid.bid.ext.dsa
| Atributo | Necessário? | Descrição |
|---|---|---|
| nome | Sim | Transparência do anunciante: Cadeia de texto UNICODE livre com um nome em nome do qual o anúncio é apresentado. Máximo de 100 caracteres. (string) |
| pago | Sim | Transparência do anunciante: Cadeia de texto UNICODE livre de quem pagou o anúncio. Deve ser sempre incluída, mesmo que seja a mesma que a indicada no atributo de nome. Máximo de 100 caracteres (string) |
| adrender | Sim | Sinalizador para indicar que o comprador/anunciante apresentará as suas próprias informações de transparência DSA no interior da criação. 0 = o comprador/anunciante não irá processar, 1 = o comprador/anunciante irá processar (int) |
seatbid.bid.dsa.transparency
| Atributo | Necessário? | Descrição |
|---|---|---|
| domínio | Sim | Domínio da entidade que aplicou os parâmetros do utilizador (string) |
| parâmetros | Sim | Conjunto de parâmetros de orientação do utilizador aplicados pelo comprador (utilizando a lista fornecida pelo Grupo de Trabalho para a Transparência da DSA). Incluir suporte para vários fornecedores que podem adicionar os seus próprios parâmetros de seleção de utilizadores. (int array) |
Nenhuma resposta de proposta
Para responder a um pedido de licitação sem efetuar uma licitação efectiva, deve ser enviado um código de resposta HTTP 204 "Sem conteúdo".
URLs de notificação de ganho e faturação
Se o nURL ou o bURL estiverem na resposta da oferta e forem URLs válidos, a plataforma ExoClick enviará um pedido GET para eles. Estes URLs podem ter alguns tokens que devem ser substituídos pela ExoClick antes de efetuar o GET:
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
Exemplo:
https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY}
Se estiver a utilizar tanto nURL como bURL, a ExoClick fará uma chamada para ambos.
Estrutura ADM
Dependendo do formato do anúncio, o parâmetro adm pode conter uma parte de XML ou JSON. Pode encontrar exemplos pormenorizados de estruturas de adm na nossa página de exemplos
Ao criar a MDA, tenha em conta o seguinte:
- as marcações iFrame** (Banner, Fullpage Interstitial) devem estar activadas na sua conta ExoClick para poderem ser utilizadas.
- os anúncios In-Stream, Native e Push Notification** devem conter uma cadeia de caracteres codificada em JSON no adm.
- O parâmetro adm de In-Stream pode seguir uma de duas estruturas: Remote VAST ou Local VAST. No VAST remoto, basta declarar o URL onde se encontra o VAST Wrapper, enquanto no VAST local é necessário declarar quaisquer "trackingEvents " que pretenda seguir, para além do "videoURL" e do "clickURL".
Atualmente, suportamos os eventos impression, progress e complete. Os eventos de impressão e progresso são obrigatórios, enquanto o evento completo só pode ser adicionado se estiver a utilizar o VAST local.
O ADM deve seguir a mesma estrutura que a apresentada no nosso exemplo acima.
Como parâmetro opcional, pode incluir crop_anchor_point na cadeia de caracteres JSON da admissão Native Ads para determinar a localização do ponto de ancoragem da sua imagem nativa. Os valores disponíveis são:
- MIDDLE_CENTER = 0,
- TOP_LEFT = 1,
- TOP_CENTER = 2,
- TOP_RIGHT = 3,
- MIDDLE_LEFT = 4,
- MIDDLE_RIGHT = 5,
- BOTTOM_LEFT = 6,
- BOTTOM_CENTER = 7,
- BOTTOM_RIGHT= 8
Here is a visualization of the available anchor points:
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
Note that, while we also allow imptrackers in Native Ads, we strongly recommend using eventtrackers instead.
- Push Notification ads only allow one image asset per notification. The width and height depend on what's coming from the request, which can be 192x192 or 720x480. Note that the adm must also be a JSON encoded string as the request will be coming from a Native object.
- Lastly, Push Notification ads allow only one "imptracker" URL
Exemplos
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page