Visualizar 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 upload em massa de dados de segmentação por usuário. | v.24 | 27 de março de 2024 |
| openrtb.proto | O Google é compatível com o protocolo OpenRTB usando codificação JSON ou Protobuf. Esse proto é necessário se você usa OpenRTB/Protobuf. Ele também inclui documentação dos campos compatíveis e do mapeamento deles para o protocolo nativo do Google. | 2,6 | 23 de junho de 2025 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um proto separado. | v.192 | 21 de julho de 2025 |
| publisher-settings.proto | Um conjunto de configurações do editor específicas para uma rede de lances 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.200 | 21 de julho de 2025 |
Dados de referência
Dicionários (clique para baixar o 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 bancos on-line. |
| 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 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 em toda a troca e não os representados por um único comprador. |
| Marcas | Lista de marcas usadas na API Client Access. |
| Atributos de criativos declaráveis pelo comprador | Usado para o campo attribute em BidResponse.
Este 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 do método performancereport. |
| Classificações de conteúdo | Usado no campo detected_content_labels do
BidRequest. |
| Códigos de status do comparador de cookies | Usado no campo cookieMatcherStatusRate dos relatórios de performance do protocolo RTB. Os códigos disponíveis são descritos no guia Correspondência de cookies. |
| Códigos de status do criativo | Usado em creative_status_code foi devolvido 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 de não lance a serem fornecidos no campo BidResponse.no_bid_reason no protocolo de lance do Authorized Buyers. |
| Atributos de criativo pré-segmentáveis | Usado no campo supportedCreativeAttribute do recurso PretargetingConfig exposto na API REST do comprador. 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 texto são permitidos. |
| Segmentos do publisher | Usado no campo detected_vertical de
BidRequest. Esse campo especifica os segmentos verticais (semelhantes a palavras-chave) da página em que o anúncio será veiculado. O Google gera esse campo rastreando a página e determinando quais segmentos verticais são usados. |
| 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 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 arquivos CSV) |
|
| Apps para dispositivos móveis Android | Lista de apps Android para dispositivos móveis segmentáveis com IDs de apps, IDs de categorias e nomes de apps legíveis. |
| 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 autorizados a veicular anúncios no tráfego da LGPD, com ID, nome legível, 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 | Mapeia IDs de provedores de personalização de anúncios do Maps para um nome legível, 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 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
Solicite o arquivo publisher-settings.pb.gz ao representante da sua conta.
Tópicos da política de revisão de criativos
É possível usar os temas de política neste arquivo para filtrar criativos durante a revisão na API Real-time Bidding.
Baixe os temas da política como um arquivo CSV.Última atualização: 18 de abril de 2022