Datos de referencia de protos

Consulte o descargue archivos que admitan el protocolo de RTB.

Protocolos

Archivo Descripción Versión Última actualización
cookie-Bulk-upload.proto Usa este mensaje para subir de forma masiva los datos de segmentación de usuarios. v.24 27 de marzo de 2024
openrtb.proto Google admite el protocolo OpenRTB mediante la codificación JSON o Protobuf. Este proto es necesario si utilizas OpenRTB/Protobuf. También se incluye documentación de los campos compatibles y su asignación al protocolo nativo de Google. 2.6 22 de mayo de 2024
openrtb-adx.proto El protocolo OpenRTB de Google incluye algunas extensiones, proporcionadas en un proto independiente. v.174 21 de mayo 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 El protocolo de RTB de Authorized Buyers de Google Este es el mensaje que Google utiliza para solicitar ofertas. Una BidRequest incluye el espacio publicitario de una sola impresión. v.328 21 de mayo de 2024

Protos en 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.179 24 de mayo de 2024
realtime-bidding.proto El protocolo de RTB de Authorized Buyers de Google Este es el mensaje que Google utiliza para solicitar ofertas. Una BidRequest incluye el espacio publicitario de una sola impresión. v.338 24 de mayo de 2024

Datos de referencia

Diccionarios (haz clic para descargar un 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 editor no permite, por ejemplo, si no desea alojar anuncios relacionados con la banca en línea.
Categorías con anuncios restringidos Se usa en el campo allowed_restricted_category de BidRequest y en el campo restricted_category de BidResponse. En el campo allowed_restricted_category, se describen las categorías que normalmente están restringidas, pero que un publicador las declara de forma explícita según lo permitido, por ejemplo, anuncios que incluyen contenido relacionado con bebidas alcohólicas.
Categorías sensibles a los 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 no desea alojar anuncios relacionados con política.
Anunciantes Se usa en el campo advertiser_id de snippetStatusItem. Este campo especifica el anunciante que representa la creatividad asociada con el fragmento. Esta lista incluye a los anunciantes en todo el intercambio y no a los anunciantes representados por ningún comprador.
Marcas Lista de marcas, utilizadas en la API de acceso de cliente.
Atributos de creatividad declarables del comprador Se usa para el campo attribute en BidResponse. Este campo describe los atributos que declara el 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 la creatividad

Se usa en

Se muestra creative_status_code en los 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 Valores estándares de motivos de no oferta que se deben proporcionar en el campo BidResponse.no_bid_reason del protocolo de oferta de Authorized Buyers.
Atributos de creatividades que se pueden segmentar 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 sola configuración de segmentación previa.
Atributos de creatividades que no 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, pueden especificar restricciones sobre si se permite el uso de cookies o si se permite el uso de anuncios multimedia o de texto.
Verticales de publicadores 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.
Proveedores Se usa en el campo allowed_vendor_type de BidRequest. Este campo enumera qué proveedores de Rich Media, como Campaign Monitor y VoiceFive, están permitidos para la creatividad que se publica, según lo especifique el editor.

Incluye a los proveedores del archivo de diccionario gdn-vendors.txt desactivado.
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 Lista de apps para dispositivos móviles Android a las que se pueden orientar los anuncios con sus ID de app, ID de categoría y nombres de apps legibles por humanos.
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 autorizados a publicar 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 pueden atribuirse 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 del protocolo de oferta de Authorized Buyers y del campo BidRequest.regs.ext.lgpd del protocolo de oferta 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 los proveedores de personalización de anuncios de Maps con un nombre legible por humanos, una URL de 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 cuentan con el consentimiento del usuario proporcionado por los publicadores para los usuarios de los países 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 las políticas de este archivo para filtrar creatividades durante la revisión en la API de Ofertas en tiempo real.

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

Última actualización: 18 de abril de 2022