Proto e dados de referência

Ver ou fazer o download de arquivos compatíveis com o protocolo RTB.

Protos

Arquivo Descrição Versão Última atualização
cookie-bulk-upload.proto Use essa mensagem para fazer o upload em massa de dados de segmentação por usuário. v.24 27 de março de 2024
openrtb.proto O Google oferece suporte ao protocolo OpenRTB, usando a codificação JSON ou Protobuf encoding. Esse proto é necessário se você usar 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 20 de janeiro de 2026
openrtb-adx.proto O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um proto separado. v.207 13 de abril de 2026
publisher-settings.proto Um conjunto de configurações do editor específicas para uma rede de bidder em tempo real. v.14 5 de fevereiro de 2024

Protos 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.215 13 de abril de 2026

Dados de referência

Dicionários (clique para fazer o download do arquivo .txt)

Categorias de produtos de publicidade Usado no campo excluded_product_category de BidRequest. Esse campo descreve categorias de produtos e serviços que não são permitidas por um editor, por exemplo, se o editor não quiser hospedar anúncios relacionados a internet banking.
Categorias restritas de anúncios 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 declaradas explicitamente 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 editor, por exemplo, se o editor 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 na exchange e não os anunciantes representados por um comprador.
Marcas Lista de marcas, usada na API Client Access.
Atributos de criativos declaráveis pelo comprador Usado para o campo attribute em BidResponse. Esse campo descreve atributos declaráveis pelo comprador em criativos que não podem aparecer em excluded_attribute em BidRequest.
Códigos de status das chamadas Códigos de status retornados pela chamada de método performancereport.
Marcadores de conteúdo Usado no campo detected_content_labels do BidRequest.
Códigos de status do cookie matcher Usado no campo cookieMatcherStatusRate dos relatórios de performance do protocolo RTB. Os códigos disponíveis são descritos no guia de correspondência de cookies.
Códigos de status do criativo

Usado em

creative_status_code retornado no feedback em tempo real.
Códigos de status de 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 da ausência de lance a serem fornecidos no campo BidResponse.no_bid_reason no protocolo de lance do Authorized Buyers.
Atributos de criativos pré-segmentáveis Usado no campo supportedCreativeAttribute no recurso PretargetingConfig exposto na API REST do comprador. Esse campo descreve os atributos de criativos que devem estar presentes em todos os criativos correspondentes a uma única configuração de pré-segmentação.
Atributos de criativos que podem ser excluídos pelo editor Usado no campo excluded_attribute de BidRequest. Esse campo descreve os tipos de criativos que não são permitidos pelo editor. Por exemplo, eles podem especificar restrições sobre o uso de cookies ou se anúncios de mídia e/ou texto são permitidos.
Fornecedores Usado no campo allowed_vendor_type de BidRequest. Esse campo lista quais fornecedores de mídia avançada, como Campaign Monitor e VoiceFive, são permitidos para o criativo veiculado, conforme especificado pelo editor.

Inclui fornecedores do arquivo de dicionário desativado gdn-vendors.txt.

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 fazer o download de arquivos CSV)

Apps para dispositivos móveis Android Lista de apps para dispositivos móveis Android segmentáveis com IDs de apps, IDs de categorias, e nomes de apps legíveis por humanos.
Tabelas geográficas A tabela usada para decodificar o geo_criteria_id campo de BidRequest. Consulte Segmentação geográfica para mais informações.
Provedores de LGPD A lista de provedores de personalização de anúncios permitidos para veicular 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 BidRequest.adslot.regs_lgpd campo no protocolo de lance do Authorized Buyers e pelo BidRequest.regs.ext.lgpd campo no protocolo de lance 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 Mapeia IDs de provedores de personalização de anúncios para um nome legível por humanos, um URL da política de privacidade e uma lista de domínios que podem ser atribuídos ao provedor. Atualmente, os provedores são usados no BidRequest.AdSlot.consented_providers_settings campo para o protocolo AdX e BidRequest.User.UserExt.consented_providers_settings para o protocolo OpenRTB. Nesses campos, os provedores listados têm o consentimento do usuário transmitido pelos editores para usuários nos países do Espaço Econômico Europeu.

Configurações do editor

Peça o arquivo publisher-settings.pb.gz ao representante da sua conta.

Tópicos da política de avaliações de criativos

Você pode usar os tópicos da política neste arquivo para filtrar criativos durante revisão na API de lances em tempo real

Fazer o download dos tópicos da política como um arquivo CSV.

Última atualização: 18 de abril de 2022