Después de que tu aplicación procese la solicitud de oferta de Google, debe compilar
y enviar una respuesta. En esta guía, se explica cómo codificar tu aplicación para compilar la respuesta.
Crea un mensaje de BidResponse de Protobuf
Authorized Buyers envía el BidRequest como el cuerpo del mensaje de un POST HTTP. Si tu extremo de ofertas está configurado para usar el formato Protobuf, tu aplicación debe enviar una respuesta con el encabezado Content-Type establecido en application/octet-stream y un cuerpo de mensaje que consta de un búfer de protocolo serializado. El búfer de protocolo es un mensaje BidResponse, como se define en openrtb.proto. Tu aplicación debe mostrar un BidResponse que se pueda analizar en respuesta a cada BidRequest. Los tiempos de espera y las respuestas que no se pueden analizar se consideran errores, y Google regula a los ofertantes con tasas de error altas.
Si no quieres ofertar por una impresión, debes mostrar una respuesta HTTP 204 vacía. Puedes obtener openrtb.proto de la página de
datos de referencia.
ID de la creatividad
Tu BidResponse especifica una creatividad a través del campo BidResponse.seatbid.bid.crid (límite de 64 bytes). Incluso las creatividades similares deben tener valores únicos para este campo si difieren en alguna característica notable, incluidos, sin limitaciones, el tamaño, la URL declarada, los atributos de creatividad y los tipos de proveedores. En otras palabras, debes asignar IDs de creatividad diferentes a cualquier par de anuncios que cumplan con las siguientes condiciones:
Se ven o se comportan de manera diferente.
Renderiza en diferentes imágenes.
Renderización por diferentes medios (por ejemplo, un anuncio consta de una imagen, mientras que el otro es un video)
A medida que diseñes tu aplicación, debes decidirte por una forma sistemática de generar identificadores que tenga sentido para los tipos de creatividades que planeas enviar.
Atributos del anuncio
Google recomienda declarar atributos de creatividad para describir las características de tu anuncio y su segmentación con una combinación de BidResponse.seatbid.bid.apis y BidResponse.seatbid.bid.attr, o la extensión BidResponse.seatbid.bid.ext.attribute. A continuación, se describe cómo puedes declarar atributos:
VPAID
Establece BidResponse.seatbid.bid.apis como VPAID_1 o VPAID_2. Para el formato JSON, se puede establecer en 1 o 2, respectivamente.
MRAID
Establece BidResponse.seatbid.bid.apis en MRAID_1 o 3 para el formato JSON.
SIZELESS
Establece BidResponse.seatbid.bid.attr en RESPONSIVE o 18 para el formato JSON.
PLAYABLE
Para indicar esto, configura BidResponse.seatbid.bid.attr como USER_INTERACTIVE o 13 para el formato JSON.
Consulta el recurso de creatividades para obtener una explicación sobre cómo obtener comentarios sobre las propiedades detectadas de tus creatividades.
Campos de Open Bidding
Las respuestas de ofertas que envían los ofertantes de intercambios y redes que participan en Open Bidding son similares a las de Authorized Buyers que participan en las ofertas en tiempo real estándar. Los clientes de Open Bidding pueden especificar una pequeña cantidad de
campos adicionales, y algunos campos existentes pueden tener usos alternativos. Entre estos, se incluyen los siguientes:
OpenRTB
Authorized Buyers
Detalles
BidResponse.imp[].pmp.deals[].id
BidResponse.ad[].adslot[].exchange_deal_id
Es el ID del acuerdo del espacio de nombres del mercado que está asociado con esta oferta y se informa a los publicadores.
Es un token que se usa para identificar la información del comprador externo final si el intercambio como oferta abierta es un intermediario. Se obtiene del comprador externo y se debe pasar a Google sin modificaciones en la respuesta de la oferta.
Recomendaciones
Habilita las conexiones HTTPS persistentes (también conocidas como "keep-alive" o "reutilización de la conexión") en tus servidores. Establece el tiempo de espera en 10 segundos como mínimo. Los valores más altos son beneficiosos en muchos casos. Google lo verifica durante las pruebas de latencia iniciales de tu aplicación, ya que los compradores autorizados envían solicitudes a una velocidad alta y deben evitar la sobrecarga de latencia de establecer una conexión TCP independiente para cada solicitud.
Incluye la URL de seguimiento de impresiones opcional para hacer un seguimiento de cuándo se renderiza la impresión en lugar de cuándo gana el ofertante. Debido a la disminución entre las victorias y las renderizaciones, esto genera estadísticas de seguimiento más precisas.
Mantén tu código del ofertante libre de dependencias en campos obsoletos, que pueden hacer que tus ofertas fallen con errores.
Incluye BidResponse.seatbid.bid.w y BidResponse.seatbid.bid.h en tu BidResponse. Un BidResponse para una solicitud que incluye varios tamaños de anuncios debe incluir estos campos o se descartará de la subasta.
Limita el tamaño de tu respuesta a menos de 8,000. Las respuestas muy grandes pueden aumentar la latencia de la red y provocar tiempos de espera.
Importante: Los mensajes de Protobuf que se muestran en los ejemplos se representan aquí como texto legible por humanos. Sin embargo, no es así como se envían los mensajes por cable. Cuando se usa el formato Protobuf de Google o OpenRTB, solo se aceptan mensajes BidResponse serializados.
Puedes crear y serializar un mensaje BidResponse con el siguiente código C++:
BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
// respond to the POST with post_response as the content
} else {
// return an error to the POST
}
Especifica la creatividad
Tu respuesta a la oferta especifica la creatividad que se publicará si tu oferta gana. Tu oferta debe incluir uno de los formatos de anuncios admitidos (AMP, video o nativo). En este ejemplo, especificamos la creatividad con el campo html_snippet.
Como alternativa, puedes especificar tu creatividad con uno de los siguientes campos, según el formato del anuncio:
Anuncio renderizado por el SDK
BidResponse.seatbid.bid.ext.sdk_rendered_ad
AMP
BidResponse.seatbid.bid.amp_ad_url
Video
BidResponse.seatbid.bid.adm
Nativo
BidResponse.seatbid.bid.adm_native
Especifica un anuncio alojado en tus propios servidores con un fragmento HTML en el campo BidResponse.seatbid.bid.adm. El fragmento se incluye en un iframe insertado en la página web, lo que hace que el anuncio se recupere y renderice cuando se carga la página. Debes crear el fragmento de código HTML para que el anuncio (banner o intersticial) se renderice correctamente dentro de un iframe y en un tamaño adecuado para el espacio de anuncios por el que estás ofertando.
Además, el tamaño del anuncio declarado en la respuesta de oferta debe coincidir exactamente con una de las combinaciones de tamaños en la solicitud de oferta en los siguientes casos:
Un anuncio es un banner normal (no de video, nativo ni intersticial).
El ofertante declaró el tamaño en la respuesta de oferta. La declaración de tamaño es obligatoria cuando hay más de un tamaño en la solicitud.
Se hace una excepción para los anuncios intersticiales. En el caso de los anuncios intersticiales, el ancho debe ser de al menos el 50% del ancho de la pantalla y la altura de al menos el 40% de la altura de la pantalla.
Puedes especificar una creatividad de fragmento HTML con cualquier código HTML válido que se renderice correctamente, pero ten en cuenta las restricciones para especificar el campo crid en la sección Crea un mensaje BidResponse.
Un uso de esto es colocar información adicional en los argumentos de las URLs que se recuperan de tus servidores como parte de la renderización del anuncio. Esto te permite pasar datos arbitrarios sobre la impresión a tus propios servidores.
Las macros son texto con formato incorporado en algunos campos de respuesta de ofertas que contienen URLs que se reemplazan por un valor relevante en el momento de la publicación del anuncio. Por ejemplo, si tu oferta ganadora incluía la macro AUCTION_PRICE en la creatividad del fragmento de código HTML incluida con tu oferta, la macro se reemplazaría por un valor que podrías desencriptar para determinar el importe que pagaste por la impresión en la subasta.
Puedes incluir macros en los siguientes campos:
BidResponse.seatbid.bid.adm
Las macros son compatibles con los formatos de fragmento HTML, nativo, URL de video y VAST de video en formato XML.
Úsalo en lugar de BidResponse.seatbid.bid.burl si necesitas más de una URL de facturación.
A modo de ejemplo, puedes incluir una macro como parte de un fragmento HTML si incorporas ${MACRO} dentro de la URL que se usa para recuperar la creatividad, donde MACRO es una de las macros compatibles que se describen en la especificación de OpenRTB.
Macros de RTB de Google
Google admite macros adicionales además de las que se encuentran en las especificaciones de OpenRTB. Estas tienen un formato diferente y aparecerían como %%MACRO%% si se incorporaran en una URL. En la siguiente tabla, se describen estas macros:
Macro
Descripción
ADVERTISING_IDENTIFIER
Permite que los compradores reciban el IDFA de iOS o el ID de publicidad de Android en la renderización de impresiones.
Consulta Cómo desencriptar los identificadores del anunciante para obtener más información.
CACHEBUSTER
Es una representación de cadena de un número entero aleatorio de cuatro bytes sin firmar.
CLICK_URL_UNESC
La URL de clic sin escape del anuncio. En el fragmento, una versión escapada de la URL de clic de terceros debe seguir directamente a la macro.
Por ejemplo, si la URL de clic de terceros es http://my.adserver.com/some/path/handleclick?click=clk, se puede usar el siguiente código con la versión con una sola barra de escape de la URL de clic de terceros después de la invocación de la macro:
La URL primero registrará el clic con Google y, luego, redireccionará al usuario a la URL de clic de terceros.
CLICK_URL_ESC
La URL de clic escapada del anuncio. Usa esto en lugar de CLICK_URL_UNESC si primero necesitas pasar el valor a través de otro servidor que, luego, mostrará un redireccionamiento.
Por ejemplo, se podría usar el siguiente código en un fragmento de HTML:
Esto registrará el clic con my.adserver.com, que luego será responsable de redireccionar a la URL que se pasa en el parámetro google_click_url. Esto supone que my.adserver.com quita el escape del parámetro google_click_url.
Puedes agregar una URL con doble escape después de %%CLICK_URL_ESC%%. Después de que my.adserver.com quita el escape, queda una versión de la URL con un solo escape adjunta a google_click_url. Cuando se recupere google_click_url, se escapará una vez más y, luego, se redireccionará.
CLICK_URL_ESC_ESC
Es la URL con escape doble del anuncio. Usa esto en lugar de CLICK_URL_UNESC si primero necesitas pasar el valor a través de otro servidor que, luego, mostrará un redireccionamiento.
Por ejemplo, se podría usar el siguiente código en un fragmento de HTML:
Se expande a http: si la solicitud de oferta no requiere SSL o a https: si la solicitud de oferta requiere SSL.
SITE
El dominio con codificación de URL de la URL del contenido o el ID anónimo para el inventario anónimo
SITE_URL
Obsoleta. Se reemplazó por la macro SITE, que proporciona una funcionalidad idéntica.
TZ_OFFSET
El desfase de zona horaria.
VERIFICATION
Los diferentes valores para la producción y cuándo se analiza la creatividad en la canalización de verificación El formato es:
%%?VERIFICATION:true-val:false-val%%, en el que se pueden usar cualquier valor
excepto las macros para true-val y
false-val, incluidas las cadenas vacías. En el caso de las ofertas abiertas, te recomendamos que los intercambios usen esta macro. Una vez que lo hagan, las plataformas orientadas a la demanda no necesitarán realizar cambios.
Por ejemplo, si una creatividad incluye %%?VERIFICATION:-1:5000%%, el reemplazo de texto sería 5000 en la publicación y -1 en la canalización de verificación. Esto ayuda a diferenciar entre estos dos conjuntos de pings.
WINNING_PRICE
Es el costo de impresión codificado (es decir, CPI en lugar de CPM) en micros de la moneda de la cuenta. Por ejemplo, un CPM ganador de USD 5 corresponde a 5,000,000 de micros de CPM o 5,000 de micros de CPI. El valor decodificado de WINNING_PRICE en este caso sería 5,000.
El precio ganador se especifica en CPI.
Para analizar esta macro, deberás implementar una aplicación que descrypte las confirmaciones de precios. Consulta la página Cómo desencriptar las confirmaciones de precios para obtener más información.
WINNING_PRICE_ESC
WINNING_PRICE con codificación de URL
Google requiere que uses la macro CLICK_URL_UNESC o CLICK_URL_ESC dentro de la creatividad del anuncio publicado por terceros. Google usa las macros CLICK_URL para el seguimiento de clics.
El escape de URL en macros usa el siguiente esquema:
El carácter de espacio se reemplaza por un signo más (+).
Los caracteres alfanuméricos (0-9, a-z, A-Z) y los caracteres del conjunto !()*,-./:_~ no se modifican.
Todos los demás caracteres se reemplazan por %XX, donde XX es el número hexadecimal que representa el carácter.
Restricciones y requisitos para publicadores
La solicitud de oferta incluye información sobre los tipos de restricciones y requisitos que los publicadores imponen a las creatividades en la subasta.
BidRequest.bcat
Puedes comparar las categorías bloqueadas que especifica este campo con las que se detectan en las creatividades que enviaste con el campo detectedCategories de la API de Real-time Bidding.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
En la práctica, siempre se establecerá como true porque Google requiere compatibilidad con SSL para todas las creatividades.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes
Nunca realices ofertas con un anuncio que contenga una función restringida. En el caso de las funciones permitidas, como el tipo de proveedor, muestra un anuncio solo si su tipo de proveedor está en la lista allowed_vendor_type en BidRequest. Solo se deben incluir en tu oferta los formatos de anuncios especificados en la solicitud de oferta a través de la propagación de campos como BidRequest.imp.banner. Consulta los comentarios de estos campos en la definición del búfer de protocolo BidRequest para obtener más detalles.
Si se muestra un anuncio en BidResponse, debes configurar con precisión los campos BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat y BidResponse.seatbid.bid.adomain o BidResponse.seatbid.bid.adm_native.link.url en BidResponse. Si un anuncio tiene varios valores aplicables para estos campos, debes incluir todos los valores. Consulta los comentarios de estos campos en la definición del búfer de protocolo BidResponse para obtener más detalles.
Se descartan las respuestas que no tienen estos campos configurados.
Open Measurement
Open Measurement te permite especificar proveedores externos que proporcionan servicios de medición y verificación independientes para los anuncios que se publican en entornos de apps para dispositivos móviles.
Los formatos de anuncios admitidos incluyen anuncios de video, de banner y intersticiales. Para obtener más información sobre cómo usar Open Measurement en una respuesta de oferta que contiene estos formatos, consulta el artículo del Centro de ayuda del SDK de Open Measurement.
Ejemplos de respuestas de ofertas
En las siguientes secciones, se muestran respuestas de ofertas de muestra para diferentes tipos de anuncios.
id:"96Z599PGNvp7Mr99138Fm0"seatbid{bid{id:"NQb32Ge7Rtt84wFn2p8"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB13-7"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"billing_id:29846056590dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}bid{id:"4vwb23qm6iqU6w6G978"impid:"1"price:0.153584adid:"test_creative_id_272596"adomain:"google.com"crid:"test_creative_id_272596"cat:"IAB21"burl:"https://test.com/imp?id=123456"adm_native{ver:"1.2"assets{id:1required:truetitle{text:"Luxury Mars Cruises"}}assets{id:2required:truedata{value:"Visit the planet in a luxury spaceship."}}assets{id:3required:falsedata{value:"Book today"}}assets{id:4required:truedata{value:"Galactic Luxury Cruises"}}assets{id:5required:trueimg{url:"https://native.test.com/image?id=123456"w:1200h:627}}link{url:"https://www.google.com"}eventtrackers{event:IMPRESSIONmethod:IMGurl:"https://test.com/event?id=123456"}privacy:"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"}[com.google.doubleclick.bid]{ad_choices_destination_url:"https://test.com/preferences"dsa{behalf:"TEST_ADVERTISER"paid:"TEST_PAYING_ENTITY"adrender:false}}}seat:"4528:1161:591635"group:false}bidid:"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC"cur:"USD"
JSON de OpenRTB
Muéstrame el ejemplo
{"id":"96Z599PGNvp7Mr99138Fm0","seatbid":[{"bid":[{"id":"NQb32Ge7Rtt84wFn2p8","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB13-7"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","billing_id":"29846056590","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"},{"id":"4vwb23qm6iqU6w6G978","impid":"1","price":0.153584,"adid":"test_creative_id_272596","adomain":["google.com"],"crid":"test_creative_id_272596","cat":["IAB21"],"burl":"https://test.com/imp?id=123456","ext":{"ad_choices_destination_url":"https://test.com/preferences","dsa":{"behalf":"TEST_ADVERTISER","paid":"TEST_PAYING_ENTITY","adrender":0}},"adm":"{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"required\":1,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"required\":0,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"required\":1,\"data\":{\"value\":\"Galactic Luxury Cruises\"}},{\"id\":5,\"required\":1,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}}],\"link\":{\"url\":\"https://www.google.com\"},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"}],"seat":"4528:1161:591635","group":0}],"bidid":"hgu4ev7j-ZK929XM0-79f7-0A23O0VN2CFC","cur":"USD"}
ad{adslot{id:1max_cpm_micros:158000billing_id:41106584355deal_id:1}click_through_url:"google.com"attribute:70buyer_creative_id:"test_creative_id_251451"advertiser_name:"Google"native_ad{headline:"Luxury Mars Cruises"body:"Visit the planet in a luxury spaceship."call_to_action:"Book today"advertiser:"Galactic Luxury Cruises"image{url:"https://native.test.com/image?id=123456"width:1200height:222}app_icon{url:"https://native.test.com/icon?id=123456"width:512height:512}star_rating:4.300000190734863click_link_url:"https://www.google.com"}impression_tracking_url:"https://test.com/imp?id=123456"impression_tracking_url:"https://test.com/imp?id=123456"event_notification_token:"token"skadn{version:"4.0"network:"l6x39K4z"itunesitem:"731305960"sourceapp:"627009739"fidelities{fidelity_type:STOREKIT_RENDERED_ADSnonce:"9216faff-74a9-4b35-badc-66878c35f67c"timestamp:1728975919221signature:"b0USXkmg02Q3v6p301kYOHG36CCOWWdEo52RHRttB9t8PTNi79qL17E4D6h7UeUSuq479oTK13G2Ev34MJlU86C5vY1SMVw2"}fidelities{fidelity_type:VIEW_THROUGH_ADSnonce:"9216faff-74a9-4b35-badc-66878c35f67c"timestamp:1728975919221signature:"4Cf4NH6239z9f3wa8j6420Z7H0UISYxyxN5720444dkq6457I5FY0Jg8bk1xge2P8YgiDp74l2738136v2g1A8D50331IRm0"}source_identifier:1}click_tracking_urls:"https://google.com/rtb/click?imp_id=55d2112c-4947-4da5-bc37-b79ebf4577dd"advertised_app_id:"APP_ID_OMITTED"app_promotion_type:INSTALLS}processing_time_ms:63
[null,null,["Última actualización: 2025-02-12 (UTC)"],[[["Bid responses must be serialized `BidResponse` protocol buffers with the `Content-Type` header set to `application/octet-stream` for Protobuf, and a parsable `BidResponse` is required for each `BidRequest`, while an empty HTTP 204 response signals no bid."],["Each creative needs a unique `crid` (creative ID) limited to 64 bytes, and this ID must be unique across creatives if there are differences in size, declared URL, attributes, vendor types, appearance, behavior, or rendering method."],["Ad characteristics should be declared using `BidResponse.seatbid.bid.apis`, `BidResponse.seatbid.bid.attr`, or `BidResponse.seatbid.bid.ext.attribute`, with specific values indicating VPAID, MRAID, SIZELESS, or PLAYABLE attributes, respectively, and additional attributes from `buyer-declarable-creative-attributes.txt`."],["Responses should remain under 8KB, utilize persistent HTTPS connections with at least a 10-second timeout, and employ `BidResponse.seatbid.bid.burl` or `BidResponse.seatbid.bid.ext.impression_tracking_url` for tracking impressions."],["The `BidResponse` must accurately set creative attributes (`BidResponse.seatbid.bid.attr`), categories (`BidResponse.seatbid.bid.cat`), and advertiser domain (`BidResponse.seatbid.bid.adomain`) or native ad link (`BidResponse.seatbid.bid.adm_native.link.url`), as responses lacking these are discarded."]]],[]]
