Processar a solicitação

Uma interação de lances em tempo real começa quando o Google envia uma solicitação de lance para seu aplicativo. Este guia explica como programar seu aplicativo para processar a solicitação de lance.

Analisar solicitação

O Google envia uma solicitação de lance serializada nos formatos JSON ou Protobuf do OpenRTB, anexada como o payload de uma solicitação POST HTTP. O formato recebido depende da configuração do seu endpoint. Consulte Exemplo de solicitação de lance para ver um exemplo.

É preciso analisar essa solicitação para receber o BidRequest serializado. Se você estiver usando o formato Protobuf, faça o download de openrtb.proto e openrtb-adx.proto na página de dados de referência e use-os para gerar uma biblioteca que possa ser usada para analisar a mensagem BidRequest. Por exemplo, o código C++ a seguir analisa uma solicitação que recebe um payload POST em uma string:

string post_payload = /* the payload from the POST request */;
BidRequest bid_request;
if (bid_request.ParseFromString(post_payload)) {
  // Process the request.
}

Depois de ter o BidRequest, você pode trabalhar com ele como um objeto, extraindo e interpretando os campos necessários. Por exemplo, em C++, a iteração de transações em um "BidRequest" do OpenRTB pode ser semelhante ao seguinte:

for (const BidRequest::Imp::Pmp::Deal& deal : pmp.deals()) {
  DoSomething(deal.id(), deal.wseat());
}

IDs do faturamento

Você recebe uma solicitação de lance quando o inventário de anúncios de um editor é segmentado por uma ou mais das suas configurações de pré-segmentação. BidRequest.imp.ext.billing_id será preenchido com os IDs de faturamento de todos os compradores qualificados e as configurações de pré-segmentação relevantes. Além disso, para o inventário de transações, é possível encontrar IDs de faturamento associados aos compradores relevantes usando BidRequest.imp.pmp.deal.ext.billing_id. Somente os IDs de faturamento dos compradores incluídos na solicitação de lance podem ser especificados ao dar um lance.

Se vários IDs de faturamento forem incluídos na solicitação de lance, especifique o ID de faturamento do comprador a quem você pretende atribuir seu lance com o campo BidResponse.seatbid.bid.ext.billing_id.

imp {
  ext {
    // The billing IDs of all of your matching pretargeting configs and eligible child seats are
    // stored in a flat list here.
    billing_id: 123
    billing_id: 456
    billing_id: 789
  }
  pmp {
    // All eligible deals are stored in a single flat list.
    deal {
      id: 1000
      ext {
        // The specific billing IDs eligible to bid on this deal are indicated here.
        billing_id: 789
      }
      ...
    }
    deal {
      id: 2000
      ext {
        billing_id: 123
        billing_id: 456
      }
      ...
    }
  }
  ...
}
...

Determinar categorias bloqueadas

Ao dar um lance, o criativo incluído não pode ter categorias detectadas que o publisher bloqueou. Caso contrário, o lance será filtrado do leilão.

Para encontrar as categorias bloqueadas de uma impressão, consulte o campo BidRequest.bcat, que é preenchido com categorias na taxonomia configurada para sua conta.

O exemplo a seguir mostra as categorias bloqueadas com base em uma taxonomia de categorias de anúncios configurada:

Taxonomia de conteúdo 1.0 do IAB

// Bid request
{
  // Indicates the blocked categories using IAB Content 1.0 Taxonomy.
  "bcat": [
    "IAB9-9",  // Cigars
    "IAB8-18"  // Wine
  ]
  "imp": {
    ...
  }
}
      
// Bid request
{
  // Indicates the blocked categories using Google Ad Category Taxonomy.
  "bcat": [
    "10138",  // Cigar and tobacco collecting
    "10080",  // Tobacco
    "11649",  // Wine
    "10674",  // Wine collecting
    "13008"   // Wine clubs
  ]
  "imp": {
    ...
  }
}
      

Determinar categorias contextuais

As solicitações de lance podem incluir campos de categoria contextual que descrevem o site ou app em que uma impressão ocorre. Esses campos também usam taxonomias de categoria de anúncio, mas representam o contexto da impressão, em vez de restrições no criativo. Esses campos podem não usar a mesma taxonomia do campo BidRequest.bcat. O Google ou o editor pode fornecer essas categorias contextuais. O uso de categorias contextuais pode melhorar a avaliação de impressões, a segmentação contextual e a brand safety.

Categorias contextuais detectadas pelo Google

O Google preenche os seguintes campos com as categorias de conteúdo do IAB detectadas para o site, app ou página:

Campo Descrição
BidRequest.site.cat Uma matriz de IDs de categoria de conteúdo que descreve o site.
BidRequest.site.pagecat Uma matriz de IDs de categoria de conteúdo que descreve a página ou visualização atual do site.
BidRequest.app.cat Uma matriz de IDs de categoria de conteúdo que descrevem o app.
BidRequest.app.pagecat Uma matriz de IDs de categoria de conteúdo que descreve a página ou visualização atual do app.

A taxonomia exata usada para esses campos em uma determinada solicitação de lance está nos campos BidRequest.site.cattax ou BidRequest.app.cattax. Os campos de categoria contextual nem sempre são preenchidos devido a preferências do editor ou questões regulatórias. Para mais informações, consulte Categorias contextuais do OpenRTB no Google Ad Manager.

Indicadores fornecidos pelo publisher

Além das categorias contextuais detectadas pelo Google, as solicitações de lance também podem conter indicadores fornecidos pelo publisher, que também descrevem o contexto de uma impressão. Ao contrário das categorias contextuais detectadas pelo Google, esses indicadores só são preenchidos quando fornecidos pelo editor. Esses indicadores são enviados nos objetos BidRequest.site.content e BidRequest.app.content, como content.data.segment e content.genre. A taxonomia usada para entradas content.data.segment é informada em content.data.ext.segtax. Para mais informações, consulte Indicadores fornecidos pelo publisher (PPS) para lances em tempo real (RTB).

Arquivos de dicionário

A solicitação de lance usa identificadores definidos em arquivos de dicionário, que estão disponíveis na página de dados de referência.

Macros de URL do bidder

Opcionalmente, algumas informações do BidRequest podem ser inseridas em URLs de endpoint de lances usando macros. Se você configurar um URL de endpoint com uma ou mais macros, elas serão expandidas se essas informações estiverem presentes na solicitação de lance. Isso pode ser útil, por exemplo, se você quiser fazer o balanceamento de carga com base nas informações em BidRequest. Entre em contato com o gerente da sua conta para solicitar suporte para novas macros.

MacroDescrição
%%GOOGLE_USER_ID%%

Substituído pelo ID do usuário do Google encontrado em BidRequest.user.id. Por exemplo, o URL do bidder http://google.bidder.com/path?gid=%%GOOGLE_USER_ID%% será substituído por algo como http://google.bidder.com/path?gid=dGhpyBhbiBleGFtGxl no momento da solicitação.

Se o ID do usuário do Google for desconhecido, a string vazia será substituída, com um resultado semelhante a

http://google.bidder.com/path?gid=
%%HAS_MOBILE%%

Substituído por 1 para indicar que a solicitação de lance é de um dispositivo móvel ou por 0, caso contrário. Isso se baseia no valor de BidRequest.device.devicetype, em que os dispositivos móveis são indicados por HIGHEND_PHONE (4) ou Tablet (5).

%%HAS_VIDEO%%

Substituído por 1 para indicar que a solicitação de lance contém inventário de vídeo ou 0, caso contrário. Isso se baseia no preenchimento de BidRequest.imp.video na solicitação de lance.

%%IS_CTV%%

Substituído por 1 para indicar que a solicitação de lance é de um dispositivo de smart TV ou por 0, caso contrário. Isso se baseia no valor de BidRequest.device.devicetype. Para Protobuf, os dispositivos de smart TV são CONNECTED_TV, CONNECTED_DEVICE ou SET_TOP_BOX, que correspondem aos valores inteiros 3, 6 ou 7 para JSON.

%%HOSTED_MATCH_DATA%%

Substituído por um valor com base em BidRequest.user.buyeruid.

%%MOBILE_IS_APP%%

Substituído por 1 para indicar que a solicitação de lance é para inventário do app para dispositivos móveis ou 0, caso contrário. Isso se baseia no preenchimento de BidRequest.app.

Encontrar o ID do app para dispositivos móveis no URL da transação

As transações de aplicativos para dispositivos móveis vão informar URLs como este:

mbappgewtimrzgyytanjyg4888888.com

Use um decodificador base-32 para decodificar a parte da string em negrito (gewtimrzgyytanjyg4888888).

É possível usar um decodificador on-line, mas você precisará colocar as letras em maiúsculas e substituir os 8s finais por valores =.

Portanto, decodificando esse valor:

GEWTIMRZGYYTANJYG4======
resulta em:
1-429610587
A string 429610587 é o ID do app iOS iFunny.

Veja outro exemplo. O URL denunciado é:

mbappgewtgmjug4ytmmrtgm888888.com
Decodificação desse valor:
GEWTGMJUG4YTMMRTGM======
resulta em:
1-314716233
O resultado 314716233 é o ID do app iOS TextNow.

Encontrar o nome do app para dispositivos móveis no URL da transação

Veja um exemplo de como acessar o nome do app. O URL denunciado é o seguinte:

mbappMFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q888.com
Decodificação desse valor:
MFUXELTDN5WS42DZOBQWQLTJN4XHG3DJORUGK4Q===
resulta em:
air.com.hypah.io.slither
O resultado equivale ao app Android slither.io.

Campos do Open Bidding

As solicitações de lance enviadas para bidders de troca e de rede que participam do Open Bidding são semelhantes às do Authorized Buyers que participam de lances em tempo real padrão. Os clientes do Open Bidding vão receber um pequeno número de campos adicionais, e alguns campos atuais podem ter usos alternativos. Isso inclui o seguinte:

OpenRTB Detalhes
BidRequest.imp.ext.dfp_ad_unit_code

Contém o código de rede do Ad Manager do publisher seguido pela hierarquia do bloco de anúncios, separados por barras.

Por exemplo, isso apareceria com uma formatação semelhante a: /1234/cruises/mars.

BidRequest.user.data.segment

Pares de chave-valor repetidos enviados do publisher para o bidder de troca.

É possível determinar que os valores são pares de chave-valor enviados pelo editor quando BidRequest.user.data.name está definido como “Publisher Passed”.

Declarar fornecedores permitidos

Os fornecedores de tecnologia que oferecem serviços como pesquisa, remarketing e veiculação de anúncios podem desempenhar um papel na interação entre compradores e vendedores. Somente os fornecedores que o Google aprovou para participar das interações do Authorized Buyers são permitidos.

Para entender o BidRequest e criar seu BidResponse, você precisa conhecer as duas possibilidades diferentes para declarar fornecedores de tecnologia:

  1. Alguns fornecedores não precisam ser declarados. Eles estão listados em Fornecedores externos certificados do Ad Manager.
  2. Outros fornecedores só podem participar se forem declarados no BidRequest:
    • No BidRequest, o campo BidRequest.imp.ext.allowed_vendor_type especifica quais fornecedores o vendedor permite. Os fornecedores que serão enviados no allowed_vendor_type estão listados no arquivo de dicionário vendors.txt.

Exemplo de solicitação de lance

Os exemplos a seguir representam amostras legíveis por humanos das solicitações Protobuf e JSON.

Protobuf do OpenRTB

JSON do OpenRTB

Para converter a solicitação de lance em um formato binário, como você receberia do payload POST em uma solicitação real, faça o seguinte (em C++). No entanto, isso não se aplica ao JSON do OpenRTB.

string text_format_example = /* example from above */;
BidRequest bid_request;
if (TextFormat::ParseFromString(text_format_example, &bid_request)) {
  string post_payload;
  if (bid_request.SerializeToString(&post_payload)) {
    // post_payload is a binary serialization of the protocol buffer
  }
}

Feedback em tempo real

O feedback em tempo real está disponível para o Authorized Buyers, além de trocas e redes que usam o Open Bidding.

O feedback em tempo real preenche BidRequest.ext.bid_feedback com base no resultado de um ou mais lances que você fez anteriormente e pode ser usado para encontrar detalhes como se o lance ganhou o leilão ou o lance mínimo necessário para ganhar o leilão. Entre em contato com seu gerente de contas para ativar o feedback em tempo real.

Além dos campos padrão enviados no feedback da resposta à solicitação de lance, também é possível enviar dados personalizados na resposta usando o campo BidResponse.seatbid.bid.ext.event_notification_token. O event_notification_token são dados arbitrários conhecidos apenas pelo proponente que podem ajudar na depuração, por exemplo: um novo ID de segmentação ou de lance que representa uma nova tática ou metadados associados ao criativo conhecidos apenas pelo proponente. Para mais detalhes, consulte o arquivo de buffer de protocolo das extensões do OpenRTB.

Quando o Authorized Buyers envia uma solicitação de lance a um bidder, ele responde com um BidResponse. Se o bidder tiver o feedback em tempo real ativado, em uma solicitação de lance subsequente, o Authorized Buyers vai enviar feedback sobre a resposta em uma mensagem BidFeedback:

message BidFeedback {
  // The unique id from BidRequest.id.
  optional string request_id = 1;

  // The status code for the ad. See creative-status-codes.txt in the
  // technical documentation for a list of ids.
  optional int32 creative_status_code = 2;

  // Deprecated. This field is not populated and will be removed after March,
  // 2025. If the bid won the auction, this is the price paid in your account
  // currency. If the bid participated in the auction but was out-bid, this
  // is the CPM that should have been exceeded in order to win. This is not
  // set if the bid was filtered prior to the auction, if the publisher or
  // winning bidder has opted out of price feedback or if your account has
  // opted out of sharing winning prices with other bidders. For first-price
  // auctions, minimum_bid_to_win is populated instead of this field.
  optional double price = 3 [deprecated = true];

  // The minimum bid value necessary to have won the auction, in your account
  // currency. If your bid won the auction, this is the second highest bid
  // that was not filtered (including the floor price). If your bid didn't win
  // the auction, this is the winning candidate's bid. This field will only be
  // populated if your bid participated in a first-price auction, and will not
  // be populated if your bid was filtered prior to the auction.
  optional double minimum_bid_to_win = 6;

  // Billable event rate multiplier that was applied to this bid during
  // ranking. The adjustment reflects the likelihood that your bid would
  // generate a billable event (namely, the ad renders successfully) if it won
  // the auction, relative to the probability that other bids generate a
  // billable event if they won the auction. This adjustment can be larger or
  // smaller than 1. This affects the final ranking in the auction only; in
  // particular, this multiplier does not affect the payment or whether the
  // bid clears any floor price.
  optional float billable_event_rate_bid_adjustment = 13 [default = 1];

  // When a publisher uses an RTB auction and waterfall-based SDK mediation on
  // the same query, the winner of the real-time auction must also compete in
  // a mediation waterfall (which is ordered by price) to win the impression.
  // If the bid participated in the auction and there was no waterfall, the
  // value of this field is 0. If the bid participated in the auction and
  // there was a waterfall, the value of this field is a price representing a
  // sample bid from the eligible mediation networks that were higher than the
  // auction winner, weighted by expected fill rate. This field can be used
  // in conjunction with minimum_bid_to_win to train bidding models. The CPM
  // is in your account currency.
  optional double sampled_mediation_cpm_ahead_of_auction_winner = 8;

  message EventNotificationToken {
    // The contents of the token.
    optional string payload = 1;
  }

  // The token included in the corresponding bid.
  optional EventNotificationToken event_notification_token = 4;

  // The creative ID included in the corresponding bid.
  optional string buyer_creative_id = 5;
}

Nessa mensagem, o primeiro campo que você deve verificar é bid_feedback.creative_status_code. O significado do código pode ser encontrado em creative-status-codes.txt. Se você ganhar o lance, poderá desativar o feedback de preço. Para mais informações, consulte Como desativar.

O feedback em tempo real inclui o ID da solicitação de lance e uma das seguintes opções:

Resultado do leilão Feedback em tempo real
O comprador não enviou um lance. Nada
O comprador enviou um lance que foi filtrado antes de chegar ao leilão. O código de status do criativo (creative-status-codes.txt).
O comprador enviou um lance, mas perdeu o leilão. O código de status do criativo 79 (superado no leilão).
O comprador enviou um lance que venceu o leilão. O preço de compensação e o código de status do criativo 1.

Para uma impressão de app e um código de status do criativo de 83, o editor do app pode ter usado uma hierarquia de mediação. Portanto, o lance vencedor teria competido com outra demanda na cadeia de hierarquia de passback do editor. Saiba como usar sampled_mediation_cpm_ahead_of_auction_winner ao dar lances.

Exemplo

Veja a seguir um exemplo de feedback em tempo real, conforme visto nos protocolos compatíveis:

Protobuf do OpenRTB

JSON do OpenRTB

Criar um modelo de lances para leilões de primeiro preço

Depois de dar um lance em um leilão de primeiro preço, você vai receber feedback em tempo real, incluindo os campos minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner, se o lance não tiver sido filtrado do leilão. Esses indicadores podem ser usados para informar à lógica de lances o quanto seu lance poderia ter sido maior ou menor para vencer a impressão.

  • minimum_bid_to_win: o lance mínimo que poderia ter sido feito para vencer o leilão de lances em tempo real. Se você venceu o leilão, esse será o menor lance que você poderia ter dado para vencer. Se você perdeu o leilão, esse será o lance vencedor.
  • sampled_mediation_cpm_ahead_of_auction_winner: se houver outras redes na cadeia de mediação, o valor desse campo será um preço que representa um lance de amostra de uma das redes de mediação qualificadas que foram maiores que o vencedor do leilão, ponderado pela taxa de preenchimento esperada. Ele será definido como 0 se nenhuma das redes na cadeia de mediação estiver prevista para preenchimento ou se o editor não usar a mediação do SDK.

Como funciona

Para descrever os cálculos usados para determinar os valores possíveis para minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner, primeiro precisamos definir o seguinte:

  • Veja a seguir os CPMs na cadeia de mediação em ordem decrescente:
    \[C_1, C_2, …, C_n\]
  • Confira as taxas de preenchimento correspondentes para os CPMs na cadeia de mediação:
    \[f_1, f_2, …, f_n\]
  • Veja a seguir uma função usada para determinar o CPM esperado e a probabilidade dele com base no elemento da cadeia de mediação \(i\), de acordo com a taxa de preenchimento fornecida:
    \(X_i = \{C_i\) com probabilidade \(f_i\); \(0\) com probabilidade \(1 - f_i\}\)
  • A cadeia de mediação vencedora final será:
    \[\{C_1, C_2, …, C_K, W\}\]
    em que \(W\) é o lance vencedor e \(C_K > W >= C_{K+1}\)
  • O preço de reserva, ou mínimo, é indicado como \(F\).
  • O lance do segundo colocado é indicado como \(R\).
Cálculos para o vencedor do leilão
Campo Cálculo
minimum_bid_to_win
\(max\{F, R, X_{K+1}, …, X_n\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(\{C_i\) com probabilidade \(\prod_{j=1}^{i-1}(1-f_j) \cdot f_i \div \prod_{j=1}^{K}(1-f_j)\}\)
Para \(1 <= i <= K\).

Cálculos para o perdedor do leilão
Campo Cálculo
minimum_bid_to_win
\(max\{F, W\}\)
sampled_mediation_cpm_ahead_
of_auction_winner
\(max\{X_1, …, X_K\}\)

Exemplo com uma cadeia de mediação simples

Suponha que um publisher use lances em tempo real e uma cadeia de mediação de SDK da seguinte forma:

Cadeia de mediação do SDK CPM esperado Taxa de preenchimento
Rede 1 \(C_1 = $3.00\) \(f_1 = 5\%\)
Rede 2 \(C_2 = $2.00\) \(f_2 = 45\%\)
Rede 3 \(C_3 = $0.50\) \(f_3 = 80\%\)
Rede 4 \(C_4 = $0.10\) \(f_4 = 85\%\)

Suponha que o resultado do leilão de RTB seja o seguinte:

Leilão de RTB CPM
Vencedor do leilão (W) US$ 1,00
Segundo colocado no leilão (R) US$ 0,05
Preço de reserva / mínimo (F) US$ 0
Lance que venceu o leilão

Veja um exemplo de como os valores e as probabilidades de minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner são calculados para um lance vencedor.

minimum_bid_to_win Probabilidade
\(max(F, R, C_3) = $0.50\) \(f_3 = 80\%\)
\(max(F, R, C_4) = $0.10\) \((1-f_3) \cdot f_4 = 17\%\)
\(max(F, R, 0) = $0.05\) \((1-f_3) \cdot (1-f_4) = 3\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Probabilidade
\(C_1 = $3.00\) \(f_1 \div (1-(1-f_1) \cdot (1-f_2)) =~ 10.5\%\)
\(C_2 = $2.00\) \(((1-f_1) \cdot f_2) \div (1-(1-f_1) \cdot (1-f_2)) =~ 89.5\%\)
Lances que perderam o leilão

Veja um exemplo de como os valores e as probabilidades de minimum_bid_to_win e sampled_mediation_cpm_ahead_of_auction_winner são calculados para um lance que perdeu.

minimum_bid_to_win Probabilidade
\(max(F, W) = $1.00\) \(100\%\)
sampled_mediation_cpm_
ahead_of_auction_winner
Probabilidade
\(C_1 = $3.00\) \(f_1 = 5\%\)
\(C_2 = $2.00\) \((1-f_1) \cdot f_2 =~ 42.8\%\)
\(0\) \((1-f_1) \cdot (1-f_2) =~ 52.2\%\)

Separação de lances

A separação de lances descreve o processamento de um único BidRequest complexo em várias solicitações de lance que são enviadas ao seu aplicativo. Quando uma solicitação de lance é simplificada, é possível saber quais solicitações faziam parte da original porque elas têm um valor idêntico no campo BidRequest.ext.google_query_id.

A separação de lances é ativada por padrão, mas você pode entrar em contato com seu gerente de contas se preferir desativá-la.

Formatos de anúncio

Algumas oportunidades de anúncio aceitam vários formatos. Com a separação de lances, cada formato é enviado em uma solicitação de lance distinta, em que atributos como IDs de faturamento qualificados são relevantes para o formato especificado na solicitação.

As solicitações de lance que contêm os seguintes formatos serão separadas em solicitações distintas:

  • Banner
  • Vídeo
  • Áudio
  • Nativo

Exemplo de nivelamento de formato de anúncio

Confira abaixo um exemplo que mostra uma solicitação de lance JSON do OpenRTB simplificada sem separação de formato de anúncio em comparação com um conjunto equivalente de solicitações separadas:

Pré-nivelamento

Pós-nivelamento

Ofertas

Uma oportunidade de anúncio para um determinado bidder pode ser aplicável a vários tipos de transação, além do leilão aberto. Com a separação de lances para transações, uma solicitação de lance será enviada para o leilão aberto e uma para cada tipo de transação de preço fixo. Na prática, as restrições de anúncios podem ser diferentes entre os tipos de leilão e de oferta de preço fixo. Por exemplo, para uma determinada oportunidade de anúncio em vídeo disponível para o leilão aberto e uma oferta de preço fixo, um bidder vai receber solicitações de lances distintas para cada um, em que restrições como a duração máxima do anúncio e a permissão de anúncios puláveis podem ser diferentes. Como resultado, a simplificação aplicada à oportunidade de anúncio permite que você identifique com mais facilidade as restrições de anúncio para o leilão aberto e a oferta de preço fixo.

Recurso de pular e duração do vídeo

A especificação do OpenRTB não tem campos separados para especificar as durações máximas de vídeo de anúncios puláveis e não puláveis. A implementação do Google usa a separação de lances para distinguir entre eles usando os campos BidRequest.video.maxduration e BidRequest.video.skip.

Veja um exemplo de como o inventário de vídeo é nivelado quando a duração máxima de um anúncio não pulável é de 15 e a duração máxima de um anúncio pulável é de 60.

Exemplo max_ad_duration skip (verdadeiro OU falso)
Solicitação original sem nivelamento 15 true
Solicitação simplificada nº 1: não pulável 15 false
Solicitação simplificada nº 2: pulável 60 true

A separação de solicitações de lance de duração do vídeo pulável só vai ocorrer quando estas condições forem atendidas:

  • A solicitação permite vídeo.
  • Vídeos puláveis e não puláveis são permitidos, e as duas durações máximas respectivas têm valores diferentes.
  • Essa solicitação é qualificada para leilão privado ou leilão aberto.

Para desativar esse tipo de nivelamento, entre em contato com seu gerente técnico de contas. Quando desativado, e o publisher permite anúncios em vídeo puláveis e não puláveis com durações máximas diferentes com base na possibilidade de pular, skip é definido como true e maxduration é definido como a duração mais curta entre as restrições de anúncios puláveis e não puláveis.

Conjuntos de anúncios em vídeo

As solicitações de lance para um conjunto de vídeos com várias oportunidades de anúncio são simplificadas, de modo que cada solicitação de lance seja para uma oportunidade de anúncio individual desse conjunto. Assim, você pode dar lances em várias oportunidades de anúncio para um determinado conjunto.

Open Measurement

Com o Open Measurement, é possível especificar fornecedores terceirizados que oferecem serviços independentes de medição e verificação para anúncios veiculados em ambientes de apps para dispositivos móveis.

Para determinar se um publisher é compatível com o Open Measurement na solicitação de lance, verifique se a oportunidade de anúncio exclui o atributo OmsdkType: OMSDK 1.0 encontrado em Atributos de criativo excluíveis pelo publisher. Isso é encontrado no atributo battr para Banner ou Vídeo, dependendo do formato.

Para mais informações sobre como interpretar solicitações de lances que contêm indicadores do Open Measurement, consulte o artigo da Central de Ajuda sobre o SDK do Open Measurement.

Exemplos de solicitações de lance

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

Banner de aplicativo

Protobuf do OpenRTB

JSON do OpenRTB

Intersticial de app

Protobuf do OpenRTB

JSON do OpenRTB

Vídeo intersticial de app

Protobuf do OpenRTB

JSON do OpenRTB

Nativo do app

Protobuf do OpenRTB

JSON do OpenRTB

Vídeo na Web

Protobuf do OpenRTB

JSON do OpenRTB

Banner da Web para dispositivos móveis para lances em ad exchange

Protobuf do OpenRTB

JSON do OpenRTB

Vídeo e nativo multiformato

Protobuf do OpenRTB

JSON do OpenRTB