Confira ou faça o download de arquivos compatíveis com o protocolo RTB.
Protos
| Arquivo | Descrição | Versão | Última atualização |
|---|---|---|---|
| cookie-bulk-upload.proto | Use esta mensagem para fazer upload em massa de dados de segmentação por usuário. | v.25 | 27 de março de 2024 |
| openrtb.proto | O Google é compatível com o protocolo OpenRTB, usando a codificação JSON ou Protobuf. Esse proto é necessário se você usa o OpenRTB/Protobuf. Ele também inclui a documentação dos campos compatíveis e o mapeamento deles para o protocolo nativo do Google. | 2,6 | 15 de outubro de 2026 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um proto separado. | v.210 | 4 de agosto de 2026 |
| publisher-settings.proto | Um conjunto de configurações do publisher específicas para uma rede de lances em tempo real. | v.14 | 5 de fevereiro de 2024 |
Protótipos da versão Beta aberta
| Arquivo | Descrição | Versão | Última atualização |
|---|---|---|---|
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um proto separado. | v.220 | 16 de setembro de 2026 |
Dados de referência
Dicionários (clique para baixar o arquivo .txt) |
|
|---|---|
| Categorias dos produtos de anúncio | Usado no campo excluded_product_category de
BidRequest. Esse campo descreve categorias de produtos e serviços que não são permitidos por um editor. Por exemplo, se o editor não quiser hospedar anúncios relacionados a internet banking. |
| Categorias de anúncios restritas | Usado no campo allowed_restricted_category de
BidRequest e no campo restricted_category de
BidResponse. O campo allowed_restricted_category
descreve categorias que normalmente são restritas, mas que foram explicitamente
declaradas por um editor como permitidas, por exemplo, anúncios com
conteúdo relacionado a bebidas alcoólicas. |
| Categorias sensíveis de anúncios | Usado no campo excluded_sensitive_category de
BidRequest e no campo category de
BidResponse. O campo excluded_sensitive_category
descreve categorias sensíveis que não são permitidas pelo publisher.
Por exemplo, se o publisher não quiser hospedar anúncios relacionados a
política. |
| Anunciantes | Usado no campo advertiser_id de SnippetStatusItem. Esse
campo especifica o anunciante representado pelo criativo associado ao
snippet. Essa lista reflete os anunciantes em toda a troca e não
reflete os anunciantes representados por um único comprador. |
| Marcas | Lista de marcas, usada na API Client Access. |
| Atributos de criativo declaráveis pelo comprador | Usado para o campo attribute em BidResponse.
Este campo descreve os atributos declaráveis pelo comprador em criativos que não podem
aparecer em excluded_attribute em
BidRequest. |
| Classificações de conteúdo | Usado no campo detected_content_labels do
BidRequest. |
| Códigos de status do correspondente de cookies | Usado no campo cookieMatcherStatusRate dos relatórios de performance do protocolo RTB. Os códigos disponíveis estão descritos no guia de correspondência de cookie. |
| Códigos de status do criativo | Usado em creative_status_code retornado no feedback em tempo real.
|
| Códigos de status da correspondência hospedada | Usado no campo hostedMatchStatusRate dos relatórios de performance do protocolo RTB. |
| Motivos da ausência de lance | Valores padrão de motivo para não dar lances a serem fornecidos no campo BidResponse.no_bid_reason no
protocolo de lances do Authorized Buyers. |
| Atributos de criativo pré-segmentáveis | Usado no campo supportedCreativeAttribute no recurso PretargetingConfig exposto na API Buyer REST. Esse campo
descreve os atributos de criativo que devem estar presentes em todos os criativos
correspondentes a uma única configuração de pré-segmentação. |
| Atributos de criativo que podem ser excluídos pelo publisher | Usado no campo excluded_attribute de
BidRequest. Este campo descreve os tipos de criativos que
não são permitidos pelo editor. Por exemplo, eles podem especificar
restrições sobre se o uso de cookies é permitido ou se anúncios de mídia e/ou de texto
são permitidos. |
| Fornecedores | Usado no campo allowed_vendor_type de
BidRequest. Esse campo lista quais fornecedores de rich media, como
Campaign Monitor e VoiceFive, são permitidos para o criativo que está sendo veiculado,
conforme especificado pelo editor. Inclui fornecedores do arquivo de dicionário
|
| Provedores de dados | Usado no campo SegmentData.id de
BidRequest. Esse campo contém informações sobre a entidade que forneceu os
indicadores fornecidos pelo publisher. |
Tabelas de referência (clique para baixar os CSVs) |
|
| Apps para dispositivos móveis Android | Lista de apps para dispositivos móveis Android segmentáveis com os IDs de app, IDs de categoria e nomes de apps legíveis por humanos. |
| Tabelas geográficas | A tabela usada para decodificar o campo geo_criteria_id de
BidRequest. Consulte Segmentação geográfica para mais
informações. |
| Provedores da LGPD |
A lista de provedores de personalização de anúncios que podem veicular anúncios no tráfego da LGPD,
com o ID, um nome legível por humanos, o URL de privacidade e uma lista de domínios
que podem ser atribuídos ao provedor. A aplicação da LGPD é indicada em uma
determinada solicitação de lance pelo campo BidRequest.adslot.regs_lgpd
no protocolo de lances do Authorized Buyers e pelo campo
BidRequest.regs.ext.lgpd no protocolo de lances do OpenRTB.
|
| Operadoras de celular | Lista de operadoras de celular. |
| Dispositivos móveis | Lista de dispositivos móveis. |
| Sistemas operacionais para dispositivos móveis | Lista de sistemas operacionais para dispositivos móveis. |
| Provedores | Associa os IDs de provedores de personalização de anúncios a um nome legível por humanos, um URL de Política de Privacidade e uma lista de domínios que podem ser atribuídos ao provedor.
Atualmente, os provedores são usados no campo BidRequest.AdSlot.consented_providers_settings para o protocolo do AdX e BidRequest.User.UserExt.consented_providers_settings para o protocolo do OpenRTB. Nesses campos, os provedores listados têm o consentimento do usuário, conforme transmitido pelos publishers para usuários nos países do Espaço Econômico Europeu. |
Configurações do editor
Solicite o arquivo publisher-settings.pb.gz ao representante da sua conta.
Tópicos da política de revisão de criativos
Use os tópicos de política desse arquivo para filtrar criativos durante a revisão na API de lances em tempo real.
Baixe os tópicos da política como um arquivo CSV.Última atualização: 18 de abril de 2022