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 | 22 de maio de 2024 |
openrtb-adx.proto | O protocolo OpenRTB do Google inclui algumas extensões, fornecidas em um .proto separado. | v.174 | 21 de maio 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.328 | 21 de maio 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.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 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 |
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 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