Esta página foi traduzida pela API Cloud Translation.

Criar a resposta

Depois que seu aplicativo processar a solicitação de lance do Google, ele deverá criar e enviar uma resposta. Este guia explica como codificar seu aplicativo para criar a resposta.

Criar mensagem do BidResponse

O Authorized Buyers envia BidRequest como o corpo da mensagem de um POST HTTP. A resposta enviada por seu aplicativo precisa ter o cabeçalho Content-Type definido como application/octet-stream; e o corpo da mensagem consistindo em um buffer de protocolo serializado. O protocolo buffer é uma mensagem BidResponse, conforme definido em realtime-bidding.proto. Seu aplicativo precisa retornar um BidResponse em resposta a cada BidRequest. Tempos limite e as respostas que não podem ser analisadas são consideradas erros, e as limitações do Google proponentes com altas taxas de erro.

Se não quiser dar um lance em uma impressão, defina o processing_time_ms sozinho e deixa todos os outros campos vazio. Você pode acessar o realtime-bidding.proto no dados de referência.

ID do criativo

Seu BidResponse especifica um criativo por meio da Campo buyer_creative_id (limite de 64 bytes). Até mesmo criativos semelhantes precisam ter valores exclusivos para buyer_creative_id se forem diferentes características notáveis, incluindo, mas não se limitando a: tamanho, URL declarado, atributos de criativo e tipos de fornecedor. Em outras palavras, você deve dar diferentes IDs de criativo a dois anúncios que:

Ter uma aparência ou um comportamento diferente.
Renderizar para imagens diferentes.
Renderizar por meios diferentes (por exemplo, um anúncio consiste em uma imagem, enquanto o outro contém Flash).

Ao projetar seu aplicativo, é preciso definir uma forma sistemática de gerar identificadores que façam sentido para os tipos de criativos que você planeja para enviar.

Atributos do anúncio

Você deve declarar os atributos do criativo que descrevem completamente características e sua segmentação em BidResponse.Ad.attribute. A atributos que devem ser declarados são (veja também a lista completa de em buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
O anúncio contém um pixel ou um beacon da web com a finalidade de criar Uma lista de IDs de cookies para o remarketing subsequente.
8 Remarketing: IsRemarketing
O anúncio segmenta consumidores com base no ID do cookie ou do dispositivo, em que a lista de IDs de cookies ou IDs de dispositivos representam um conjunto de consumidores que interagiram anteriormente com um site de propriedade do comprador ou representado por ele.
9 UserInterestTargeting: IsUserInterestTargeted
O anúncio segmenta consumidores com base no ID do cookie ou do dispositivo, em que a lista de IDs de cookies ou de IDs de dispositivos representam um conjunto de consumidores que o comprador definidos como um grupo de interesse comum.
30 InstreamVastVideoType: Vpaid
O anúncio exige compatibilidade com VPAID para ser renderizado.
32 MraidType: MRAID
O anúncio requer a API MRAID para ser renderizado.

Além disso, os seguintes atributos são aceitos, mas sua declaração é não é necessária, porque o Authorized Buyers as detecta automaticamente e bloqueia (ou permitem) seus criativos com base nos valores detectados, e não em sua declaração. Consulte API Creatives para saber como receber feedback sobre as propriedades detectadas do seu criativos.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
O anúncio requer suporte para Flash para ser renderizado.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
O anúncio não requer Flash para ser renderizado.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
O anúncio pode ser renderizado em uma página SSL. O Authorized Buyers trata os criativos com valores declarados diferentes desse atributo (eles serão analisados separadamente e têm status de aprovação distintos). Assim, se você definir lances com SSL e versões não SSL do mesmo criativo, você deverá declarar esse atributo de acordo, para que essa distinção seja devidamente refletida no AdX.

Campos do Open Bidding

Respostas de lance enviadas por bidders de troca e rede que participam do Open Bidding Os lances são semelhantes aos dos Authorized Buyers que participam das campanhas padrão lances em tempo real. Os clientes do Open Bidding podem especificar um pequeno número campos adicionais, e alguns campos existentes podem ter usos alternativos. Esses incluem o seguinte:

OpenRTB	Authorized Buyers	Detalhes
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	É o ID da transação do namespace da troca associado a esta lance e informados aos editores. Observação:no momento, este campo é enviado apenas na versão Beta fechada. participantes.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	O tipo de transação informado aos editores, afetando o modo como ela é tratados no leilão. Observação:no momento, este campo é enviado apenas na versão Beta fechada. participantes.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Token usado para identificar as informações do comprador de terceiros final se os de rede como um Open Bidding é um intermediário. Ele é obtido do comprador de terceiros e deve ser passado ao Google sem alterações no lance resposta.

Recomendações

Ative conexões HTTPS persistentes (também conhecidas como "reutilização de conexão") nos seus servidores. Defina o tempo limite em 10 segundos no mínimo; valores mais altos são benéficos em muitos casos. Verificação do Google durante os testes de latência iniciais do seu aplicativo, porque O Authorized Buyers envia solicitações com uma taxa alta e precisa evitar o a sobrecarga de latência de estabelecer uma conexão TCP separada para cada solicitação.
Inclua o URL de rastreamento de impressões opcional para rastrear quando o a impressão é renderizada, e não quando o proponente vence. Por causa da desistência entre vitórias e renderizações, isso gera um rastreamento estatísticas.

Observação:ao usar o OpenRTB 2.5 ou mais recente, o campo padrão para isso é BidResponse.seatbid[].bid[].burl.
Mantenha seu código do bidder sem dependências em campos descontinuados, o que pode causar a falha dos lances com erros.
Inclua BidResponse.Ad.width e BidResponse.Ad.height no seu BidResponse. Um BidResponse a uma solicitação que inclui vários tamanhos de anúncio deve incluir os valores width e height, ou eles serão caíram do leilão.
A resposta precisa ter menos de 8 mil. Respostas muito grandes podem aumentar latência de rede e causar tempos limite.
Siga as diretrizes para lances em inventário do iOS que exigem atribuição da SKAdNetwork.

Exemplo de resposta do lance

Os exemplos a seguir representam amostras legíveis do Protobuf e Solicitações JSON.

Google

Mostrar o exemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Importante:as mensagens do Protobuf mostradas na os exemplos estão representados aqui como texto legível por humanos. No entanto, não é assim que as mensagens são enviadas pela rede. Ao usar o Google ou o Protobuf do OpenRTB. , somente mensagens BidResponse serializadas serão aceitas.

É possível criar e serializar uma mensagem BidResponse usando o seguinte código C++:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Especificar o criativo

Sua resposta do lance especifica o criativo a ser veiculado se o seu lance vencer. Seu lance precisa incluir um dos formatos de anúncio compatíveis (AMP, vídeo, nativo). Neste especificamos o criativo usando o campo html_snippet.

Como alternativa, é possível especificar o criativo usando um dos métodos campos a seguir, com base no formato do anúncio:

Anúncio renderizado do SDK
- BidResponse.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Vídeo
- BidResponse.Ad.video_url ou
- BidResponse.Ad.video_vast_xml
Nativo
- BidResponse.Ad.native_ad

Especifique um anúncio hospedado em seus próprios servidores usando um snippet HTML na o campo html_snippet do BidResponse. A snippet está em um iframe inserido na página da web, resultando na inserção sendo recuperados e renderizados quando a página é carregada. Você precisa criar o HTML snippet para que o anúncio (banner ou intersticial) seja renderizado corretamente dentro de um iframe e um tamanho apropriado para o espaço de anúncio para o qual você está definindo lances.

Além disso, o tamanho do anúncio declarado na resposta do lance precisa corresponder exatamente a um das combinações de tamanho na solicitação de lance quando:

Um anúncio é um banner regular (não é um vídeo, nativo ou intersticial).
O bidder declarou o tamanho na resposta do lance. A declaração de tamanho é obrigatório sempre que mais de um tamanho estiver presente na solicitação.
Há uma exceção para anúncios intersticiais. Para intersticiais, a largura precisa ter pelo menos 50% da largura da tela e a altura de pelo menos 40% do a altura da tela.

O campo html_snippet aceita qualquer código HTML válido que é renderizado corretamente, mas lembre-se das restrições de especificação do buyer_creative_id na seção Criar mensagem do BidResponse. Um para isso é colocar informações extras em argumentos dos URLs que estão buscados em seus servidores como parte da renderização do anúncio. Isso permite que você transmita dados arbitrários sobre a impressão de volta para seus próprios servidores.

A maioria das políticas para snippets HTML retornados nas respostas de lance é a mesma das para anúncios de terceiros. Consulte Authorized Buyers Diretrizes do programa, Requisitos para terceiros veiculação de anúncios e Declarar URLs de clique nos anúncios para mais informações.

Especificar macros

O snippet HTML que define um criativo pode incluir uma ou mais construções chamadas macros. No momento da veiculação do anúncio, os valores são substituídos por . Por exemplo, seu aplicativo de lances cliente poderia usar a WINNING_PRICE para determinar quanto foi pago pelo anúncio, se ele vencer o leilão. Para analisar essa macro, é preciso implementar uma aplicativo que descriptografa confirmações de preço. Consulte a seção Preço para descriptografia Confirmações para mais informações.

Especifique uma macro como parte de um snippet HTML no formato %%MACRO%%, em que MACRO é um dos listadas na tabela abaixo.

Observação:somente para respostas de lance de anúncio AMP (amp_ad_url), As macros WINNING_PRICE e WINNING_PRICE_ESC são compatíveis.

O Google exige que você use as APIs CLICK_URL_UNESC ou CLICK_URL_ESC no criativo do terceiro veiculado anúncio. O Google usa as macros CLICK_URL para o acompanhamento de cliques.

Para usar uma macro, inclua-a no anúncio para que o URL seja recuperado quando quando alguém clicar nele. O valor de retorno da busca é um redirecionamento para outro URL anexado ao CLICK_URL.

Macro	Descrição
`ADVERTISING_IDENTIFIER`	Permite que os compradores recebam o IDFA do iOS ou o ID de publicidade do Android na renderização de impressões. Consulte Como descriptografar identificadores de anunciante para mais detalhes.
`CACHEBUSTER`	Uma representação de string de um número inteiro de quatro bytes aleatório não assinado.
`CLICK_URL_UNESC`	O URL de clique sem escape do anúncio. No snippet, uma versão com escape do de terceiros deverá seguir diretamente a macro. Por exemplo, se o URL de clique de terceiros for `http://my.adserver.com/some/path/handleclick?click=clk`, o código a seguir poderia ser usado com a versão com escape único do terceiro URL de clique da parte depois da invocação da macro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> No momento da veiculação do anúncio, ele é expandido para: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Primeiro, o URL registrará o clique no Google e depois redirecionará para o URL de clique de terceiros.
`CLICK_URL_ESC`	O URL de clique com escape do anúncio. Use esta opção em vez de `CLICK_URL_UNESC` se você precisar primeiro transmitir o valor e outro servidor, que retornará um redirecionamento. Por exemplo, o código a seguir pode ser usado em um snippet HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> No momento da veiculação do anúncio, ele é expandido para: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Isso registrará o clique com `my.adserver.com`, que será responsável pelo redirecionamento para o URL passado no parâmetro `google_click_url`. Isso pressupõe que `my.adserver.com` retorna o escape do `google_click_url` . Você pode anexar um URL com escape duplo após `%%CLICK_URL_ESC%%`: Depois que o escape for feito `my.adserver.com`, que deixa uma versão com escape único do URL. anexado a `google_click_url`. Quando o `google_click_url` é buscado, ele ficará sem escape mais uma vez e depois redirecionamento.
`CLICK_URL_ESC_ESC`	O URL com escape duplo para o anúncio. Use esta opção em vez de `CLICK_URL_UNESC` se você precisar primeiro transmitir o valor e outro servidor, que retornará um redirecionamento. Por exemplo, o código a seguir pode ser usado em um snippet HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> No momento da veiculação do anúncio, ele é expandido para: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	Expandido para `http:` se a solicitação de lance não exigir SSL ou para `https:` se a solicitação de lance exigir SSL.
`SITE`	O domínio com escape do URL de conteúdo ou o ID anônimo do inventário anônimo.
`SITE_URL`	Obsoleto. Substituída pela macro SITE, que fornece funcionalidade idêntica.
`TZ_OFFSET`	O deslocamento do fuso horário.
`VERIFICATION`	Os diferentes valores para produção e quando o criativo é verificado na verificação pipeline. O formato é `%%?VERIFICATION:true-val:false-val%%`, em que: valores, exceto macros, podem ser usados para `true-val` e `false-val`, incluindo strings vazias. Para o Open Bidding, recomendamos que as trocas usem essa macro. as plataformas de demanda não precisarão fazer mudanças. Por exemplo, se um criativo incluir `%%?VERIFICATION:-1:5000%%` a substituição do texto seria `5000` na veiculação e `-1` na pipeline de verificação. Isso ajuda a diferenciar entre esses dois conjuntos de pings.
`WINNING_PRICE`	O custo de impressão codificado (ou seja, CPI em vez de CPM) em micros da moeda da conta. Por exemplo, um CPM vencedor de US $5 corresponde a 5.000.000 micros de CPM ou 5.000 micros de CPI. O decodificado o valor de `WINNING_PRICE`, neste caso, seria 5.000. O preço vencedor é especificado em CPI.
`WINNING_PRICE_ESC`	`WINNING_PRICE` com escape do URL.

O escape de URL em macros usa o seguinte esquema:

O caractere de espaço é substituído por um sinal de adição (+).
Os caracteres alfanuméricos (0-9, a-z, A-Z) e caracteres do conjunto !()*,-./:_~ permanecem inalterados.
Todos os outros caracteres são substituídos por %XX, em que XX é o hexadecimal número que representa o caractere.

Restrições do editor

Os editores usam a BidRequest para restringir quais anúncios que permitirão. É necessário aplicar as restrições nestes campos:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Um campo especifica os recursos permitidos do anúncio e o outro especifica não permitidos. Nunca retorne um anúncio com um recurso não permitido. Para permitidos recursos como tipo de fornecedor, retornam um anúncio somente se o tipo de fornecedor estiver no Lista allowed_vendor_type no BidRequest. Consulte a comentários para esses campos no buffer de protocolo BidRequest para mais detalhes.

Se um snippet HTML for retornado em BidResponse, será necessário para definir com precisão os attribute, category, e click_through_url no BidResponse. Se um anúncio tiver vários valores aplicáveis para esses campos, você deverá inclua todos os valores. Leia os comentários sobre esses campos na Definição do buffer de protocolo BidResponse para mais detalhes. As respostas que não tiverem esses campos definidos serão descartadas.

Os valores possíveis de BidRequest.excluded_attribute são (consulte publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Não são permitidos anúncios que contenham um pixel ou um web beacon com a finalidade de criar uma lista de IDs de cookies para remarketing subsequente.
8 CookieTargeting: IsCookieTargeted
Os anúncios não serão permitidos se segmentarem consumidores com base no ID do cookie em que a lista de IDs do cookie representa um conjunto de consumidores que já interagiram com um site de propriedade ou representado pelo comprador.
9 UserInterestTargeting: IsUserInterestTargeted
Os anúncios não serão permitidos se segmentarem consumidores com base no ID do cookie em que a lista de IDs do cookie representa um conjunto de consumidores que o comprador definiu como um grupo de interesse comum.
21 CreativeType: Html
Os anúncios não têm permissão para usar html_snippet ou snippet_template em BidResponse.Ad.
22 CreativeType: VastVideo
Os anúncios não têm permissão para usar o campo video_url em BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
Os anúncios não podem exigir compatibilidade com VPAID para renderização.
32 MraidType: MRAID
Os anúncios não são permitidos a exigir a API MRAID para serem processadas.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Os anúncios não podem exigir suporte para Flash para serem renderizados.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Os anúncios não podem exigir recursos HTML5 para serem renderizados.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Os anúncios não têm permissão para fazer solicitações não SSL.

Portanto, se o campo excluded_attribute tiver o valor 7, você não deve retornar um anúncio que usa um pixel ou um web beacon para criar uma lista. Se um anúncio fizer isso, deverá definir o valor 7 no o campo de atributo da BidResponse. Da mesma forma, se o campo excluded_attribute contiver o valor 48, retorne apenas anúncios que possam ser renderizados em uma página SSL (e, consequentemente, declare o atributo 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Além disso, o campo excluded_sensitive_category na O BidRequest usa códigos da ad-sensitive-categories.txt disponível na página de dados de referência. Aqui estão estendidos descrições de alguns desses códigos:

3 Politics
Inclui política ou questões sociais polêmicas. não inclui anúncios de empresas de notícias que geralmente não têm relação com opiniões de ativistas sobre essas questões.
4 Dating
Inclui serviços de relacionamento e comunidades de namoro on-line.
5 Religion
Inclui anúncios religiosos e anúncios que fazem apologia ou crítica a pontos de vista religiosos. não inclui astrologia nem formas alternativas de espiritualidade.
7 Video Games (Casual & Online)
Inclui videogames, jogos on-line e jogos para download. não inclui consoles de videogame.
8 Ringtones & Downloadables
Complementos para dispositivos móveis, incluindo toques e outros serviços para download, como protetores de tela e planos de fundo para computadores, além de gráficos e modelos de layout de perfil para redes sociais.
10 Get Rich Quick
Esquemas que prometem ganhos rápidos
18 Weight Loss
Inclui perda de peso, dietas e produtos e programas relacionados. não inclui anúncios sobre alimentação saudável ou boa forma em geral.
19 Cosmetic Procedures & Body Modification
Inclui lifting, lipoaspiração, laser, remoção de pelos e implante capilar, tatuagens e modificação do corpo.
23 Drugs & Supplements:
Inclui produtos farmacêuticos, vitaminas, suplementos e varejistas relacionados. não inclui recursos que fornecem informações sobre drogas.
24 Sexual & Reproductive Health
inclui anúncios sobre desempenho sexual e fertilidade; não inclui produtos comuns de gravidez.
35 Social Casino Games
Inclui simulações de jogos de azar (incluindo, sem limitação, pôquer, máquinas caça-níqueis, bingo, loterias, apostas esportivas, apostas em corridas, bem como outros jogos de cartas e de cassino) em que não é possível ganhar itens de valor (como dinheiro ou prêmios).
36 Significant Skin Exposure
Imagens de anúncios em que qualquer parte do corpo humano, desde o esterno até a metade da coxa, não está coberta. ou o corpo está vestindo roupas íntimas, trajes de banho, lingerie ou outras roupas transparentes ou com itens que não são vestuário, como toalhas e lençóis.
37 Sensationalism
Anúncios que visam induzir os usuários a clicar neles através da curiosidade, muitas vezes usando uma mensagem teaser com linguagem ou imagens exageradas. Inclui anúncios que abordam assuntos sensacionalistas (como óbito, divórcio ou prisão de celebridades) ou têm como objetivo chocar o usuário.

Open Measurement

Com o Open Measurement, você pode especificar fornecedores terceirizados que oferecem medição independente e de verificação para anúncios veiculados em ambientes de apps para dispositivos móveis.

Os formatos de anúncios compatíveis atualmente incluem anúncios intersticiais, em vídeo e de banner. Para mais informações sobre como usar o Open Measurement em uma resposta de lance com esses formatos, consulte a Central de Ajuda do SDK do Open Measurement artigo.

Exemplos de respostas de lance

As seções a seguir mostram exemplos de respostas de lance para diferentes tipos de anúncio.

Google

Mostrar o exemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

Intersticial de app

Google

Mostrar o exemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

Vídeo de intersticial do app

Google

Mostrar o exemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Protobuf do OpenRTB

Mostrar o exemplo

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Nativo do app

Google

Mostrar o exemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Protobuf do OpenRTB

Mostrar o exemplo

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

Vídeo na Web

Google

Mostrar o exemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Protobuf do OpenRTB

Mostrar o exemplo

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Criar a resposta

Criar mensagem do BidResponse

ID do criativo

Atributos do anúncio

Campos do Open Bidding

Recomendações

Exemplo de resposta do lance

Google

Mostrar o exemplo

JSON do OpenRTB

Mostrar o exemplo

Protobuf do OpenRTB

Mostrar o exemplo

Especificar o criativo

Especificar macros

Restrições do editor

Open Measurement

Exemplos de respostas de lance

Banner de aplicativo

Google

Mostrar o exemplo

JSON do OpenRTB

Mostrar o exemplo

Protobuf do OpenRTB

Mostrar o exemplo

Intersticial de app

Google

Mostrar o exemplo

JSON do OpenRTB

Mostrar o exemplo

Protobuf do OpenRTB

Mostrar o exemplo

Vídeo de intersticial do app

Google

Mostrar o exemplo

Protobuf do OpenRTB

Mostrar o exemplo

Nativo do app

Google

Mostrar o exemplo

JSON do OpenRTB

Mostrar o exemplo

Protobuf do OpenRTB

Mostrar o exemplo

Vídeo na Web

Google

Mostrar o exemplo

Banner da Web para dispositivos móveis para o bidder da troca

Protobuf do OpenRTB

Mostrar o exemplo