Acessar 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 dos 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 codificação JSON ou Protobuf. Esse proto é necessário se você usa o OpenRTB/Protobuf. Ela também inclui a documentação dos campos com suporte e o mapeamento deles para o protocolo nativo do Google. | 2,6 | 18 de novembro de 2024 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um proto separado. | v.183 | 10 de dezembro de 2024 |
| publisher-settings.proto | Um conjunto de configurações do editor específico para uma rede de proponentes em tempo real. | v.14 | 5 de fevereiro de 2024 |
| realtime-bidding.proto | Protocolo de RTB do Authorized Buyers do Google. Essa é a mensagem que o Google usa para solicitar lances. Um BidRequest inclui o espaço de anúncio de uma única impressão. |
v.331 | 1º de novembro de 2024 |
Prototipos 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.189 | 10 de dezembro de 2024 |
| realtime-bidding.proto | Protocolo de RTB do Authorized Buyers do Google. Essa é a mensagem que o Google usa para solicitar lances. Um BidRequest inclui o espaço de anúncio de uma única impressão. |
v.342 | 31 de outubro de 2024 |
Dados de referência
Dicionários (clique para fazer o download do arquivo .txt) |
|
|---|---|
| Categorias de produtos de anúncios | 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 bancos on-line. |
| Categorias de anúncios restritas | Usada 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
como permitidas por um editor, por exemplo, anúncios com
conteúdo relacionado a bebidas alcoólicas. |
| Categorias sensíveis de anúncios | Usada 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 do 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 comprador. |
| Marcas | Lista de marcas usadas na API Client Access. |
| Atributos de criativos que podem ser declarados pelo comprador | Usado para o campo attribute em BidResponse.
Esse campo descreve os atributos declaratórios do comprador em criativos que não podem
aparecer em excluded_attribute em
BidRequest. |
| Códigos de status de chamada | Códigos de status retornados pela chamada de método
performancereport. |
| Rótulos 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 desempenho 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 retornado em feedback
em tempo real.
|
| Códigos de status de correspondência hospedada | Usado no campo hostedMatchStatusRate dos relatórios de desempenho do protocolo RTB. |
| Sem motivos de lance | Valores padrão do motivo de não lance a serem informados no campo BidResponse.no_bid_reason no
protocolo de lances do Authorized Buyers.
|
| Atributos de criativos predefinidos | Usado no campo supportedCreativeAttribute no recurso PretargetingConfig exposto na API REST do comprador. Esse campo
descreve os atributos do criativo que devem estar presentes em todos os criativos
correspondentes a uma única configuração de segmentação antecipada. |
| Atributos de criativo excluíveis 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 se o uso de cookies é permitido ou se anúncios de mídia e/ou de texto
são permitidos. |
| Indústrias de editores | Usado no campo detected_vertical de
BidRequest. Esse campo especifica as verticais (semelhantes a
palavras-chave) da página em que o anúncio será mostrado. O Google gera esse campo rastreando a página e determinando quais verticais são usadas. |
| Fornecedores | Usado no campo allowed_vendor_type de
BidRequest. Esse campo lista quais fornecedores de rich media, como o Campaign Monitor e o 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 editor. |
Tabelas de referência (clique para fazer o download de CSVs) |
|
| Apps para dispositivos móveis Android | Lista de apps para dispositivos móveis Android segmentáveis com os IDs de apps, de categorias e nomes legíveis por humanos. |
| Tabelas geográficas | A tabela usada para decodificar o campo geo_criteria_id de
BidRequest. Consulte Alvos geográficos para mais
informações. |
| Provedores da LGPD |
Lista de provedores de personalização de anúncios autorizados a 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 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 os IDs do provedor 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 campo BidRequest.AdSlot.consented_providers_settings do protocolo AdX e BidRequest.User.UserExt.consented_providers_settings do protocolo OpenRTB. Nesses campos, os provedores listados têm o consentimento do usuário conforme 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 análise de criativos
É possível usar os tópicos de política neste arquivo para filtrar criativos durante a revisão na API Real-time Bidding.
Faça o download dos tópicos de política como um arquivo CSV.Última atualização: 18 de abril de 2022