Especificações da resposta à proposta RTB aberta
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
Depending on the ad format, the adm parameter can contain a piece of XML or JSON. You can find detailed examples of adm structures in our examples page
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.
The ADM must follow the same structure as shown in our example above.
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,
- DIREITA_MÉDIA = 5,
- BOTTOM_LEFT = 6,
- BOTTOM_CENTER = 7,
- BOTTOM_RIGHT= 8
Aqui está uma visualização dos pontos de ancoragem disponíveis:
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
Tenha em atenção que, embora também permitamos imptrackers em anúncios nativos, recomendamos vivamente a utilização de eventtrackers.
- os anúncios Push Notification** só permitem um ativo de imagem por notificação. A largura e a altura dependem do que vem do pedido, que pode ser 192x192 ou 720x480. Tenha em atenção que o adm também tem de ser uma cadeia de caracteres codificada em JSON, uma vez que o pedido virá de um objeto nativo.
- Por último, os anúncios de Notificação por impulso só permitem um URL de "imptracker "
Exemplos
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page