Datos de referencia de protos

Visualizar o descargar archivos que admitan el protocolo RTB

Protos

Archivo Descripción Versión Última actualización
cookie-bulk-upload.proto Usa este mensaje para subir datos de segmentación de usuarios de forma masiva. v.24 27 de marzo de 2024
openrtb.proto Google admite el protocolo OpenRTB con codificación JSON o Protobuf. Este proto es necesario si usas OpenRTB/Protobuf. También incluye documentación de los campos admitidos y su asignación al protocolo nativo de Google. 2.6 18 de noviembre de 2024
openrtb-adx.proto El protocolo OpenRTB de Google incluye algunas extensiones, que se proporcionan en un proto independiente. v.180 1 de noviembre de 2024
publisher-settings.proto Es un conjunto de parámetros de configuración del publicador específicos de una red de oferta en tiempo real. v.13 5 de febrero de 2024
realtime-bidding.proto El protocolo de RTB de Authorized Buyers de Google Este es el mensaje que Google usa para solicitar ofertas. Un BidRequest incluye el espacio publicitario de una sola impresión. v.331 1 de noviembre de 2024

Prototipos 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, que se proporcionan en un proto independiente. v.186 1 de noviembre de 2024
realtime-bidding.proto El protocolo de RTB de Authorized Buyers de Google Este es el mensaje que Google usa para solicitar ofertas. Un BidRequest incluye el espacio publicitario de una sola impresión. v.342 31 de octubre de 2024

Datos de referencia

Diccionarios (haz clic para descargar el archivo .txt)

Categorías de productos del anuncio 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 no quiere alojar anuncios relacionados con la banca en línea.
Categorías de anuncios restringidas Se usa en el campo allowed_restricted_category de BidRequest y en el campo restricted_category de BidResponse. El campo allowed_restricted_category describe las categorías que normalmente están restringidas, pero que un publicador declara explícitamente como permitidas, por ejemplo, los anuncios que contienen contenido relacionado con bebidas alcohólicas.
Categorías de anuncios sensibles Se usa en el campo excluded_sensitive_category de BidRequest y en el campo category de BidResponse. El campo excluded_sensitive_category describe las categorías sensibles que el publicador no permite, por ejemplo, si no quiere alojar anuncios relacionados con la política.
Anunciantes Se usa en el campo advertiser_id de SnippetStatusItem. En este campo, se especifica el anunciante que representa la creatividad asociada con el fragmento. Esta lista refleja a los anunciantes de todo el mercado y no a los anunciantes representados por un solo comprador.
Marcas Es la lista de marcas que se usa en la API de acceso de clientes.
Atributos declarables de creatividad del comprador Se usa para el campo attribute en BidResponse. En este campo, se describen los atributos declarables por el comprador en las creatividades que no deben aparecer en excluded_attribute en BidRequest.
Códigos de estado de los textos destacados 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 de coincidencia de cookies.
Códigos de estado de las creatividades

Se usa en

creative_status_code se muestra en los comentarios en tiempo real.
Códigos de estado de las coincidencias alojadas Se usa en el campo hostedMatchStatusRate de los informes de rendimiento del protocolo de RTB.
No hay motivos para no ofertar Valores estándar de motivos de no oferta que se deben proporcionar en el campo BidResponse.no_bid_reason del protocolo de ofertas de Authorized Buyers.
Atributos de creatividad presegmentables Se usa en el campo supportedCreativeAttribute del recurso de PretargetingConfig expuesto en la API de REST del comprador. En este campo, se describen los atributos de creatividad que se espera que estén presentes en todas las creatividades correspondientes a una sola configuración de segmentación previa.
Atributos de creatividad que el publicador puede excluir 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, pueden especificar restricciones sobre si se permite el uso de cookies o si se permiten anuncios multimedia o de texto.
Verticales de los publicadores Se usa en el campo detected_vertical de BidRequest. En este campo, se especifican las verticales (similares a las palabras clave) de la página en la que se mostrará el anuncio. Google genera este campo rastreando la página y determinando qué verticales se utilizan.
Proveedores Se usa en el campo allowed_vendor_type de BidRequest. En este campo, se enumeran los proveedores de Rich Media, como Campaign Monitor y VoiceFive, que se permiten para la creatividad que se publica, según lo especifique el publicador.

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

Proveedores de datos Se usa en el campo SegmentData.id de BidRequest. Este campo contiene información sobre la entidad que proporcionó los indicadores proporcionados por el publicador.

Tablas de referencia (haz clic para descargar los archivos CSV)

Apps para dispositivos móviles en Android Es una lista de apps para dispositivos móviles Android segmentables con sus IDs de app, IDs de categoría y nombres de app legibles por humanos.
Tablas geográficas Es 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 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 por humanos, 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 Es una lista de dispositivos móviles.
Sistemas operativos para dispositivos móviles Es la lista de sistemas operativos para dispositivos móviles.
Proveedores Asigna los IDs de los proveedores de personalización de anuncios 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 usan en el campo BidRequest.AdSlot.consented_providers_settings para el protocolo de AdX y BidRequest.User.UserExt.consented_providers_settings para el protocolo de OpenRTB. En estos campos, los proveedores enumerados tienen el consentimiento de los usuarios que los publicadores pasan para los usuarios de los países del Espacio Económico Europeo.

Configuración del editor

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

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

Puedes usar los temas de políticas de este archivo para filtrar las creatividades durante la revisión en la API de Real-time Bidding.

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

Última actualización: 18 de abril de 2022