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 esta mensagem para fazer o upload em massa dos dados de segmentação do 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 | 31 de outubro de 2024 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, que são fornecidas em outro proto. | v.180 | 1º de novembro de 2024 |
| publisher-settings.proto | Um conjunto de configurações do editor específico para uma rede de proponentes em tempo real. | v.13 | 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 do anúncio de uma única impressão. |
v.331 | 1º de novembro de 2024 |
Protocolos Beta abertos
| 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.186 | 1º de novembro 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 do 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 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 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 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 declaráveis 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 da 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 de motivo de não lance a serem fornecidos no campo BidResponse.no_bid_reason no
protocolo de lances do Authorized Buyers.
|
| Atributos do criativo pré-segmentáveis | 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. |
| Setores de editores | Usado no campo detected_vertical de
BidRequest. Esse campo especifica as indústrias (semelhante às palavras-chave) da página em que o anúncio será exibido. 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 Campaign Monitor e VoiceFive, têm permissão para a peça criativa veiculada, 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 respectivos IDs, IDs de categoria e nomes legíveis. |
| 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 | Os IDs do provedor de personalização de anúncios são mapeados para um nome legível, 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 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
Solicite o arquivo publisher-settings.pb.gz do seu representante de conta.
Tópicos da política de revisão 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.
Fazer o download de tópicos de política como um arquivo CSV.Última atualização: 18 de abril de 2022