Visualizar ou fazer o download de arquivos compatíveis com o protocolo RTB
Protocolos
| Arquivo | Descrição | Versão | Última atualização |
|---|---|---|---|
| cookie-Bulk-upload.proto (link em inglês) | Use esta mensagem para fazer o upload em massa dos dados de segmentação de usuários. | v.24 | 27 de março de 2024 |
| openrtb.proto | O Google aceita 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 | 22 de maio de 2024 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, que são fornecidas em outro proto. | v.174 | 21 de maio de 2024 |
| publisher-settings.proto (link em inglês) | Um conjunto de configurações do editor específicas para uma rede de proponentes em tempo real. | v.13 | 5 de fevereiro de 2024 |
| realtime-bidding.proto | protocolo 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.328 | 21 de maio 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, que são fornecidas em outro proto. | v.179 | 24 de maio de 2024 |
| realtime-bidding.proto | protocolo 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.338 | 24 de maio de 2024 |
Dados de referência
Dicionários (clique para fazer 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 nã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 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 nã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 declaráveis pelo comprador em criativos que não podem
aparecer em excluded_attribute em
BidRequest. |
| Códigos de status da frase de destaque | Códigos de status retornados pela chamada do método performancereport. |
| Classificações de conteúdo | Usado no campo detected_content_labels da BidRequest. |
| Códigos de status da correspondência de cookie | 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 cookie. |
| 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. |
| 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 do criativo pré-segmentáveis | Usado no campo supportedCreativeAttribute no
recurso PretargetingConfig exposto na API REST do comprador. Esse campo descreve os atributos 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 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 se o uso de cookies é permitido ou se os anúncios de mídia e/ou 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 setores 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, 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 Segmentação geográfica para mais informações. |
| Provedores da LGPD |
A lista de provedores de personalização de anúncios que podem ser veiculados no tráfego da LGPD,
com o ID, um nome legível por humanos, um 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 conforme transmitido pelos
editores para os usuários dos 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 tópicos da política neste arquivo para filtrar criativos durante a revisão na API Real-time Bidding
Faça o download dos tópicos das políticas como um arquivo CSV.Última atualização: 18 de abril de 2022