Processar a solicitação
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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:
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":{...}}
Taxonomia de categorias de anúncios do Google
// 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.
Macro
Descriçã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:
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:
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.
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.
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:
messageBidFeedback{//TheuniqueidfromBidRequest.id.optionalstringrequest_id=1;//Thestatuscodeforthead.Seecreative-status-codes.txtinthe//technicaldocumentationforalistofids.optionalint32creative_status_code=2;//Deprecated.ThisfieldisnotpopulatedandwillberemovedafterMarch,//2025.Ifthebidwontheauction,thisisthepricepaidinyouraccount//currency.Ifthebidparticipatedintheauctionbutwasout-bid,this//istheCPMthatshouldhavebeenexceededinordertowin.Thisisnot//setifthebidwasfilteredpriortotheauction,ifthepublisheror//winningbidderhasoptedoutofpricefeedbackorifyouraccounthas//optedoutofsharingwinningpriceswithotherbidders.Forfirst-price//auctions,minimum_bid_to_winispopulatedinsteadofthisfield.optionaldoubleprice=3[deprecated=true];//Theminimumbidvaluenecessarytohavewontheauction,inyouraccount//currency.Ifyourbidwontheauction,thisisthesecondhighestbid//thatwasnotfiltered(includingthefloorprice).Ifyourbiddidn't win//theauction,thisisthewinningcandidate's bid. This field will only be//populatedifyourbidparticipatedinafirst-priceauction,andwillnot//bepopulatedifyourbidwasfilteredpriortotheauction.optionaldoubleminimum_bid_to_win=6;//Billableeventratemultiplierthatwasappliedtothisbidduring//ranking.Theadjustmentreflectsthelikelihoodthatyourbidwould//generateabillableevent(namely,theadrenderssuccessfully)ifitwon//theauction,relativetotheprobabilitythatotherbidsgeneratea//billableeventiftheywontheauction.Thisadjustmentcanbelargeror//smallerthan1.Thisaffectsthefinalrankingintheauctiononly;in//particular,thismultiplierdoesnotaffectthepaymentorwhetherthe//bidclearsanyfloorprice.optionalfloatbillable_event_rate_bid_adjustment=13[default=1];//WhenapublisherusesanRTBauctionandwaterfall-basedSDKmediationon//thesamequery,thewinnerofthereal-timeauctionmustalsocompetein//amediationwaterfall(whichisorderedbyprice)towintheimpression.//Ifthebidparticipatedintheauctionandtherewasnowaterfall,the//valueofthisfieldis0.Ifthebidparticipatedintheauctionand//therewasawaterfall,thevalueofthisfieldisapricerepresentinga//samplebidfromtheeligiblemediationnetworksthatwerehigherthanthe//auctionwinner,weightedbyexpectedfillrate.Thisfieldcanbeused//inconjunctionwithminimum_bid_to_wintotrainbiddingmodels.TheCPM//isinyouraccountcurrency.optionaldoublesampled_mediation_cpm_ahead_of_auction_winner=8;messageEventNotificationToken{//Thecontentsofthetoken.optionalstringpayload=1;}//Thetokenincludedinthecorrespondingbid.optionalEventNotificationTokenevent_notification_token=4;//ThecreativeIDincludedinthecorrespondingbid.optionalstringbuyer_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 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:
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.
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:
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-11-17 UTC."],[],["Bid requests are HTTP POSTs using OpenRTB Protobuf, replacing the deprecated Google RTB protocol. Parsing involves `ParseFromString()` to access fields in the `BidRequest` object. Billing IDs, found in `BidRequest.imp.ext.billing_id` and `BidRequest.imp.pmp.deal.ext.billing_id`, must be specified in `BidResponse.seatbid.bid.ext.billing_id`. Key information comes from dictionary files. Bid URL macros dynamically insert `BidRequest` data. Complex bid requests can be broken into simpler, flattened requests per format or deal, such as skippable/non-skippable video ads, or video pods. Bidders get real-time feedback. The provided sample requests are used to help the process.\n"]]