Visualize ou faça 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 dos 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 | 23 de março de 2024 |
| openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um .proto separado. | v.171 | 17 de abril de 2024 |
| publisher-settings.proto (link em inglês) | Um conjunto de configurações do editor específicas de 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.324 | 17 de abril de 2024 |
Protos 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.174 | 17 de abril 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.331 | 17 de abril 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 ele
não quiser hospedar anúncios relacionados a bancos on-line. |
| 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 permitido, 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 ele 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 todo o Ad Exchange, e não
os anunciantes representados por nenhum 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 no excluded_attribute no
BidRequest. |
| Códigos de status da frase de destaque | Códigos de status retornados pela chamada do método performancereport. |
| Classificação de conteúdo | Usado no campo detected_content_labels da BidRequest. |
| Códigos de status de 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 hospedados | 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 lances 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 do criativo que devem estar presentes em todos os criativos correspondentes a uma única configuração de pré-segmentação. |
| Atributos do criativo que não podem ser incluí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, elas podem especificar restrições sobre se o uso de cookies é permitido ou se anúncios de mídia e/ou texto são permitidos. |
| Setores do editor | Usado no campo detected_vertical de BidRequest. Esse campo especifica as indústrias (semelhante a palavras-chave) da página em que o anúncio será exibido. O Google gera esse
campo rastreando a página e determinando quais indústrias são usadas. |
| IDs de rede do vendedor | Usado no campo seller_network_id de BidRequest. Esse campo especifica a rede do vendedor à qual
o editor pertence. O conteúdo desse arquivo está em ordem crescente
com base no valor do ID de rede do vendedor. |
| Fornecedores | Usado no campo allowed_vendor_type de BidRequest. Esse campo lista quais fornecedores de rich media, como o Campaign Monitor e o VoiceFive, têm permissão para o criativo em exibição, conforme especificado pelo editor. Inclui fornecedores do arquivo de dicionário |
Tabelas de referência (clique para fazer o download dos CSVs) |
|
| Apps para dispositivos móveis Android | Lista de apps para dispositivos móveis Android segmentáveis com os respectivos IDs de app, IDs de categoria 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 com permissão para veiculação no tráfego da LGPD,
com o ID deles, um nome legível, 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 no campo BidRequest.adslot.regs_lgpd
no protocolo de lances do Authorized Buyers e no 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, 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
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 fornecido 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 seu representante
da conta.
Tópicos da política da Revisão de criativo
É possível usar os tópicos da política nesse arquivo para filtrar criativos durante a revisão na API de lances em tempo real
Faça o download dos tópicos de políticas como um arquivo CSV.Última atualização: 18 de abril de 2022