Proto e dados de referência

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 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 JSON ou Protobuf. e codificação. Esse proto é necessário se você usa o OpenRTB/Protobuf. Ela também inclui documentação dos campos suportados e seu mapeamento para os um protocolo nativo. 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.175 15 de julho de 2024
publisher-settings.proto 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. Esta é a mensagem que o Google usa para solicitar lances. Um BidRequest inclui o espaço de anúncio de um 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.180 15 de julho de 2024
realtime-bidding.proto protocolo RTB do Authorized Buyers do Google. Esta é a mensagem que o Google usa para solicitar lances. Um BidRequest inclui o espaço de anúncio de um uma única impressão. v.338 21 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 que não são permitidos por um editor, por exemplo, se ele não deseja hospedar anúncios relacionados a internet banking.
Categorias restritas de anúncios Usado no campo allowed_restricted_category de BidRequest e o campo restricted_category de BidResponse. O allowed_restricted_category descreve categorias que normalmente são restritas, mas explicitamente declarados por um editor como permitidos, por exemplo, anúncios que contêm conteúdo relacionado a álcool.
Categorias sensíveis de anúncios Usado no campo excluded_sensitive_category de BidRequest e o campo category de BidResponse. O 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. Isso especifica o anunciante representado pelo criativo associado à no snippet. Essa lista reflete os anunciantes em todo o Ad Exchange e não refletem 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 precisam não aparecem em excluded_attribute nos BidRequest.
Códigos de status da frase de destaque Códigos de status retornados pelo método performancereport a chamada.
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 do protocolo RTB relatórios de desempenho. Os códigos disponíveis são descritos na seção Correspondência de cookie guia.
Códigos de status do criativo

Usado em

creative_status_code retornados em tempo real feedback.
Códigos de status de correspondência hospedada Usado no campo hostedMatchStatusRate do protocolo RTB relatórios de desempenho.
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 do criativo pré-segmentáveis Usado no campo supportedCreativeAttribute da classe Recurso PretargetingConfig exposto na API REST do comprador. Este campo descreve os atributos que devem estar presentes em todos os criativos que correspondem 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 mídia e/ou texto anúncios são permitidos.
Setores de editores Usado no campo detected_vertical de BidRequest. Este campo especifica os setores (semelhante a palavras-chave) da página em que o anúncio será exibido. O Google gera esse , 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 o criativo veiculado, conforme especificado pelo editor.

Inclui fornecedores do serviço desativado Arquivo de dicionário gdn-vendors.txt.

Provedores de dados Usado no campo SegmentData.id de BidRequest. Este campo contém informações sobre a entidade que forneceu o 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 e legíveis.
Tabelas geográficas A tabela usada para decodificar o campo geo_criteria_id de BidRequest. Consulte Segmentação por área geográfica informações imprecisas ou inadequadas.
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ídas ao provedor. a aplicação da LGPD é indicada determinada solicitação de lance por meio do BidRequest.adslot.regs_lgpd no protocolo de lances do Authorized Buyers e o 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 do Google Maps para um nome legível, um valor de URL da política e uma lista de domínios que podem ser atribuídos ao provedor. Atualmente, os provedores são usados Campo BidRequest.AdSlot.consented_providers_settings para o AdX e BidRequest.User.UserExt.consented_providers_settings para OpenRTB protocolo. Nesses campos, os provedores listados têm o consentimento do usuário conforme transmitido por editores para usuários nos países do Espaço Econômico Europeu.

Configurações do editor

Solicitar o arquivo publisher-settings.pb.gz da sua conta representante de vendas.

Tópicos da política de revisão de criativos

Você pode usar os tópicos da política neste arquivo para filtrar criativos durante revisão na API Real-time Bidding

Fazer o download os tópicos da política como um arquivo CSV.

Última atualização: 18 de abril de 2022