Datos de referencia de protos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Consulta o descarga archivos compatibles con el protocolo RTB.

Proto

Archivo Descripción Versión Última actualización
cookie-bulk-upload.proto. Utilice este mensaje para subir datos de orientación de usuarios de forma masiva. v.19 23 de agosto de 2022
openrtb.proto Google admite el protocolo OpenRTB mediante la 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 29 de noviembre de 2022
openrtb-adx.proto. El protocolo OpenRTB de Google incluye algunas extensiones, que se proporcionan en un proto aparte. v.118 3 de octubre de 2022
publisher-settings.proto Un conjunto de opciones de configuración del publicador específicas para una red de ofertantes en tiempo real. Versión 12 19 de enero de 2022
realtime-bidding.proto Protocolo de RTB para 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.258 9 de noviembre de 2022
snippet-status-report.proto Este es el mensaje que Google utiliza para comunicar informes de estado de las creatividades. v.34 19 de enero de 2022

Datos de referencia

Diccionarios (haga clic para descargar el archivo .txt)

Categorías de productos de anuncios Se usa en el campo excluded_product_category de BidRequest. En este campo, se describen 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 de anuncios restringidos Se usa en el campo allowed_restricted_category de BidRequest y el campo restricted_category de BidResponse. En el campo allowed_restricted_category, se describen las categorías que suelen estar restringidas, pero que un publicador declara de forma explícita como permitidas, por ejemplo, anuncios que incluyen contenido relacionado con bebidas alcohólicas.
Categorías sensibles al anuncio Se usa en el campo excluded_sensitive_category de BidRequest y el campo category de BidResponse. En el campo excluded_sensitive_category, se describen categorías sensibles que el publicador no permite, por ejemplo, si este no desea alojar anuncios relacionados con la 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 muestra los anunciantes en todo el intercambio y no los representa a ningún comprador.
Agencias Se usa en el campo agency_id de BidResponse. Este campo se utiliza para declarar la agencia asociada con el anuncio que se muestra.
Marcas Lista de marcas, usadas en la API de Acceso a clientes.
Atributos de creatividad declarables por el comprador Se usa para el campo attribute en BidResponse. Este campo describe los atributos que el comprador puede declarar en 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 RTB. Los códigos disponibles se describen en la guía Coincidencia de cookies.
Códigos de estado de las creatividades

Se usa en

Códigos de estado de coincidencia alojados Se usa en el campo hostedMatchStatusRate de los informes de rendimiento del protocolo RTB.
Sin motivos de oferta Se deben proporcionar los valores estándar del motivo sin oferta en el campo BidResponse.no_bid_reason del protocolo de ofertas de Authorized Buyers.
Atributos de creatividad que se pueden orientar previamente Se usa en el campo supportedCreativeAttribute del recurso PretargetingConfig expuesto en la API de REST del comprador. Este campo describe los atributos de las creatividades que se espera que estén presentes en todas las creatividades correspondientes a una sola configuración de orientación previa.
Atributos de creatividad excluidos 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 permiten los 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 qué verticales se usan.
ID de red del vendedor Se usa en el campo seller_network_id de BidRequest. Este campo especifica la red del vendedor a la que pertenece el editor. El contenido de este archivo está en orden ascendente, según el valor del ID de la red del vendedor.
Proveedores Se usa en el campo allowed_vendor_type de BidRequest. En este campo, se indica qué proveedores de rich media, como Campaign Monitor y VoiceFive, pueden tener la creatividad publicada, como lo especifica el editor.

Incluye los proveedores del archivo del diccionario gdn-vendors.txt que se dio de baja.

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

Apps para dispositivos móviles Android Lista de apps para dispositivos móviles Android a las que se pueden orientar con sus ID 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 La lista de proveedores de personalización de anuncios permitidos para publicar 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 oferta de Authorized Buyers y el campo BidRequest.regs.ext.lgpd en el protocolo de oferta de OpenRTB.
Operadores de telefonía celular Lista de proveedores 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 ID de proveedores de personalización de anuncios en Maps para un nombre legible, una URL de la Política de Privacidad y una lista de dominios que se puedan atribuir al proveedor Actualmente, se usan proveedores 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 mencionados cuentan con el consentimiento de los usuarios que pasan los publicadores en los países del Espacio Económico Europeo.

Configuración del editor

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