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 con codificación JSON o Protobuf. Este proto es necesario si utilizas OpenRTB/Protobuf. También incluye documentación de los campos admitidos y su asignación al protocolo nativo de Google. | 2.6 | 31 de octubre de 2024 |
| openrtb-adx.proto | El protocolo OpenRTB de Google incluye algunas extensiones, proporcionadas 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. Una 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. Una 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 con anuncios restringidos | 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 | 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.
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 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 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 los motivos por los que no se realiza una 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 creatividades 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 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. 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 a los proveedores del archivo de diccionario |
| 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 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 | 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 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