Datos de referencia de protos

Consulte o descargue archivos compatibles con el protocolo de RTB.

Protos

Archivo Descripción Versión Última actualización
cookie-bulk-upload.proto Utiliza este mensaje para realizar una carga masiva de datos de segmentación de usuarios. v.24 27 de marzo de 2024
openrtb.proto Google admite el protocolo OpenRTB, ya sea mediante la codificación JSON o Protobuf. Este proto es necesario si usas OpenRTB/Protobuf. También se incluye documentación de los campos admitidos y su asignación al protocolo nativo de Google. 2.6 23 de marzo de 2024
openrtb-adx.proto El protocolo OpenRTB de Google incluye algunas extensiones, proporcionadas en un proto independiente. v.170 4 de abril de 2024
publisher-settings.proto Es un conjunto de parámetros de configuración del publicador específicos para una red de ofertantes en tiempo real. v.13 5 de feb de 2024
realtime-bidding.proto Protocolo de RTB de Authorized Buyers de Google. Este es el mensaje que usa Google para solicitar ofertas. Un elemento BidRequest incluye el espacio publicitario de una sola impresión. v.323 4 de abril de 2024

Protocolos de la versión beta abierta

Archivo Descripción Versión Última actualización
openrtb-adx.proto El protocolo OpenRTB de Google incluye algunas extensiones, proporcionadas en un proto independiente. v.173 4 de abril de 2024
realtime-bidding.proto Protocolo de RTB de Authorized Buyers de Google. Este es el mensaje que usa Google para solicitar ofertas. Un elemento BidRequest incluye el espacio publicitario de una sola impresión. v.330 4 de abril de 2024

Datos de referencia

Diccionarios (haz clic para descargar el archivo .txt)

Categorías de productos publicitarios Se usa en el campo excluded_product_category de BidRequest. En este campo, se describen las categorías de productos y servicios que un publicador no permite, por ejemplo, si el publicador no desea alojar anuncios relacionados con la banca en línea.
Categorías restringidas de anuncios Se usa en el campo allowed_restricted_category de BidRequest y en el campo restricted_category de BidResponse. El campo allowed_restricted_category describe categorías que normalmente están restringidas, pero que el publicador las declara explícitamente como permitidas, por ejemplo, anuncios que incluyen contenido relacionado con bebidas alcohólicas.
Categorías sensibles de anuncios Se usa en el campo excluded_sensitive_category de BidRequest y en el campo category de BidResponse. El campo excluded_sensitive_category describe categorías sensibles que el publicador no permite, por ejemplo, si el publicador no desea alojar anuncios relacionados con la política.
Anunciantes Se usa en el campo advertiser_id de SnippetStatusItem. Este campo especifica el anunciante representado por la creatividad asociada con el fragmento. Esta lista incluye a los anunciantes de todo el intercambio y no a los que representa un solo comprador.
Marcas Lista de marcas, que se usan en la API de acceso de cliente.
Atributos de creatividades declarables del comprador Se usa para el campo attribute en BidResponse. Este campo describe los atributos declarables del comprador en las creatividades que no deben aparecer en excluded_attribute, en BidRequest.
Códigos de estado del texto destacado Códigos de estado que muestra la llamada al método performancereport
Etiquetas de contenido Se usa en el campo detected_content_labels de BidRequest.
Códigos de estado del comparador de cookies Se usa en el campo cookieMatcherStatusRate de los informes de rendimiento del protocolo de RTB. Los códigos disponibles se describen en la guía Coincidencia de cookies.
Códigos de estado de las creatividades

Se usa en

Se muestra creative_status_code en comentarios en tiempo real.
Códigos de estado de coincidencia alojados Se usa en el campo hostedMatchStatusRate de los informes de rendimiento del protocolo de RTB.
No hay motivos de oferta Se deben proporcionar los valores estándar del motivo de no oferta en el campo BidResponse.no_bid_reason del protocolo de oferta de Authorized Buyers.
Atributos de creatividades que se pueden orientar previamente Se usa en el campo supportedCreativeAttribute del recurso PretargetingConfig expuesto en la API de REST del comprador. En este campo, se describen los atributos de creatividades que se espera que estén presentes en todas las creatividades correspondientes a una configuración de segmentación previa única.
Atributos de creatividades que se pueden excluir por el publicador Se usa en el campo excluded_attribute de BidRequest. En este campo, se describen los tipos de creatividades que el publicador no permite. Por ejemplo, podrían especificar restricciones sobre si se permite el uso de cookies o si se permiten anuncios multimedia o de texto.
Verticales de publicador Se usa en el campo detected_vertical de BidRequest. Este campo especifica las verticales (similares a las palabras clave) de la página en la que se mostrará el anuncio. Para generar este campo, Google rastrea la página y determina las verticales que se usan.
IDs de las redes de vendedores Se usa en el campo seller_network_id de BidRequest. Este campo especifica la red de vendedores a la que pertenece el publicador. El contenido de este archivo está en orden ascendente según el valor del ID de red de vendedores.
Proveedores Se usa en el campo allowed_vendor_type de BidRequest. Este campo indica qué proveedores de rich media, como Campaign Monitor y VoiceFive, pueden permitir la creatividad que se publica, según lo especificado por el publicador.

Incluye proveedores del archivo de diccionario gdn-vendors.txt retirado.

Tablas de referencia (haz clic para descargar archivos CSV)

Apps para dispositivos móviles en Android Es la lista de apps para dispositivos móviles Android que se pueden orientar con sus IDs de app, ID de categoría y nombres de apps legibles.
Tablas geográficas La tabla que se usa para decodificar el campo geo_criteria_id de BidRequest. Consulta Segmentación geográfica para obtener más información.
Proveedores de la LGPD Es la lista de proveedores de personalización de anuncios que pueden publicar anuncios en el tráfico de la LGPD, con su ID, un nombre legible, una URL de privacidad y una lista de dominios que se pueden atribuir al proveedor. La aplicación de la LGPD se indica en una solicitud de oferta determinada a través del campo BidRequest.adslot.regs_lgpd en el protocolo de ofertas de Authorized Buyers y el campo BidRequest.regs.ext.lgpd en el protocolo de ofertas de OpenRTB.
Operadores de telefonía celular Lista de operadores de telefonía celular.
Dispositivos móviles Lista de dispositivos móviles.
Sistemas operativos para dispositivos móviles Lista de sistemas operativos para dispositivos móviles.
Proveedores Los IDs de proveedores de personalización de anuncios de Maps a un nombre legible por humanos, una URL de la política de privacidad y una lista de dominios que se pueden atribuir al proveedor. Actualmente, los proveedores se utilizan en el campo BidRequest.AdSlot.consented_providers_settings para el protocolo AdX y BidRequest.User.UserExt.consented_providers_settings para el protocolo OpenRTB. En estos campos, los proveedores enumerados tienen el consentimiento del usuario aprobado por los publicadores para los usuarios de los países dentro del Espacio Económico Europeo.

Configuración del editor

Solicita el archivo publisher-settings.pb.gz al representante de tu cuenta.

Temas de la política de revisión de creatividades

Puedes usar los temas de políticas de este archivo para filtrar creatividades durante la revisión en la API de Ofertas en tiempo real

Descarga los temas de políticas como un archivo CSV.

Última actualización: 18 de abril de 2022