Se usó la API de Cloud Translation para traducir esta página.

Crea la respuesta

Una vez que tu aplicación procesa la solicitud de oferta de Google, debe compilarse y enviar una respuesta. En esta guía, se explica cómo codificar tu aplicación para compilar la respuesta.

Crear mensaje de BidResponse

Authorized Buyers envía el BidRequest como el cuerpo del mensaje de una POST HTTP. La respuesta que envía tu aplicación debe tener el encabezado Content-Type configurado como application/octet-stream y un cuerpo del mensaje que contenga un búfer de protocolo serializado. El búfer de protocolo es un mensaje BidResponse, como se define en realtime-bidding.proto. Tu aplicación debe mostrar un BidResponse analizable en respuesta a cada BidRequest. Los tiempos de espera y las respuestas que no se pueden analizar se consideran errores y Google limita a los ofertantes con tasas de error altas.

Si no deseas realizar una oferta por una impresión, puedes configurar el campo processing_time_ms solo y dejar todos los demás campos vacíos. Puedes obtener realtime-bidding.proto de la página de datos de referencia.

ID de la creatividad

Tu BidResponse especifica una creatividad en el campo buyer_creative_id (límite de 64 bytes). Incluso las creatividades similares deben tener valores únicos para buyer_creative_id si difieren en cualquier característica destacada, incluidos, sin limitaciones, el tamaño, la URL declarada, los atributos de la creatividad y los tipos de proveedores. En otras palabras, debes asignar diferentes ID de creatividad a dos anuncios cualesquiera, lo que:

Se ven o se comportan de manera diferente.
Renderiza a diferentes imágenes.
Renderizarse por diferentes medios (por ejemplo, un anuncio consiste en una imagen y el otro contiene Flash)

Cuando diseñas tu aplicación, debes decidir una forma sistemática de generar identificadores que tengan sentido para los tipos de creatividades que planeas enviar.

Atributos del anuncio

Debes declarar los atributos de la creatividad que describen en detalle las características del anuncio y su segmentación en BidResponse.Ad.attribute. Se deben declarar los siguientes atributos (consulta también la lista completa de atributos admitidos en buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
El anuncio contiene un píxel o baliza web con el fin de crear una lista de ID de cookies para su posterior comercialización.
8 Remarketing: IsRemarketing
El anuncio se orienta a los consumidores según su ID de cookie o ID de dispositivo, en los que la lista de IDs de cookies o IDs de dispositivos representan un conjunto de consumidores que anteriormente interactuaron con un sitio que pertenecía al comprador o estaba representado.
9 UserInterestTargeting: IsUserInterestTargeted
El anuncio se orienta a los consumidores según su ID de cookie o ID de dispositivo, en los que la lista de ID de cookies o ID de dispositivo representa un conjunto de consumidores que el comprador definió como un grupo de interés común.
30 InstreamVastVideoType: Vpaid
El anuncio requiere compatibilidad con VPAID para renderizarse.
32 MraidType: MRAID
El anuncio requiere que se renderice la API de MRAID.

Además, se admiten los siguientes atributos, pero su declaración no es obligatoria, ya que Authorized Buyers los detecta automáticamente y bloqueará (o permitirá) tus creatividades en función de los valores detectados, en lugar de tu declaración. Consulta la API de Creatives para obtener una explicación sobre cómo obtener comentarios sobre las propiedades detectadas de tus creatividades.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
El anuncio requiere compatibilidad con Flash para renderizarse.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
El anuncio no requiere Flash para renderizarse.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
El anuncio se puede renderizar en una página SSL. Ten en cuenta que Authorized Buyers considera las creatividades con valores declarados diferentes para este atributo como distintas (se revisarán por separado y tendrán un estado de aprobación distinto). Por lo tanto, si realiza una oferta con versiones SSL y no SSL de la misma creatividad, debe declarar este atributo según corresponda para que esta distinción se refleje correctamente en AdX.

Campos de Open Bidding

Las respuestas a las ofertas enviadas por los ofertantes de intercambio y red que participan en Open Bidding son similares a las de los ofertantes de Authorized Buyers que participan en las ofertas estándar en tiempo real. Los clientes de Open Bidding pueden especificar una pequeña cantidad de campos adicionales, y es posible que algunos campos existentes tengan usos alternativos. Estos son algunos ejemplos:

OpenRTB	Authorized Buyers	Detalles
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	Es el ID de acuerdo del espacio de nombres del intercambio asociado con esta oferta y que se informa a los publicadores. Nota: Por el momento, este campo solo se envía a los participantes de la versión beta cerrada.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Es el tipo de acuerdo que se informa a los publicadores y que afecta la forma en que se trata en la subasta. Nota: Por el momento, este campo solo se envía a los participantes de la versión beta cerrada.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	El token que se usa para identificar la información del comprador externo si el intercambio como ofertantes de Open Bidding es un intermediario. Estos datos se obtienen del comprador externo y se deben pasar a Google sin cambios en la respuesta a la oferta.

Recomendaciones

Habilita 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. En muchos casos, los valores más altos son beneficiosos. Google verifica esto durante las pruebas de latencia iniciales de tu aplicación, ya que Authorized Buyers envía solicitudes a una velocidad alta y necesita evitar la sobrecarga de latencia que supone establecer una conexión TCP separada 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 cuando gana el ofertante. Debido al abandono entre las victorias y las renderizaciones, esto produce estadísticas de seguimiento más precisas.

Nota: Cuando se usa OpenRTB 2.5 o una versión posterior, el campo estándar es BidResponse.seatbid[].bid[].burl.
Mantén tu código de ofertante libre de dependencias en campos obsoletos, ya que esto puede provocar errores en tus ofertas.
Incluye BidResponse.Ad.width y BidResponse.Ad.height en tu BidResponse. Una BidResponse para una solicitud que incluye varios tamaños de anuncios debe incluir los valores width y height; de lo contrario, se descartará de la subasta.
Limita el tamaño de las respuestas a menos de 8K. Las respuestas muy grandes pueden aumentar la latencia de red y causar tiempos de espera.
Sigue los lineamientos para las ofertas en el inventario de iOS que requieren atribución de SKAdNetwork.

Ejemplo de respuesta a la oferta

Los siguientes ejemplos representan muestras legibles de las solicitudes de Protobuf y JSON.

Google

Muéstrame el ejemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

OpenRTB Protobuf

Muéstrame el ejemplo

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Importante: Los mensajes de Protobuf que se muestran en las muestras se representan aquí como texto legible. Sin embargo, no es así como se envían los mensajes por cable. Cuando se usa el formato OpenRTB Protobuf o Google, solo se aceptarán mensajes de BidResponse serializados.

Puedes crear y serializar un mensaje BidResponse con el siguiente código de 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
}

Especificar creatividad

Su respuesta a la oferta especifica la creatividad que se publicará si su 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 mediante uno de los siguientes campos, según el formato del anuncio:

Anuncio renderizado por SDK
- BidResponse.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url o
- BidResponse.Ad.video_vast_xml
Nativo
- BidResponse.Ad.native_ad

Especifica un anuncio alojado en tus propios servidores con un fragmento HTML en el campo html_snippet de BidResponse. El fragmento se encierra 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 HTML de modo que el anuncio (de banner o intersticial) se renderice correctamente dentro de un iframe y tenga un tamaño apropiado para el espacio publicitario en el que realices ofertas.

Además, el tamaño del anuncio declarado en la respuesta a la oferta debe coincidir exactamente con una de las combinaciones de tamaños en la solicitud de oferta en los siguientes casos:

Los anuncios son banners normales (no de video, nativos ni intersticiales).
El ofertante declaró el tamaño en la respuesta a la oferta. Es obligatorio declarar el tamaño 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 el alto debe ser de, al menos, el 40% de la altura de la pantalla.

El campo html_snippet admite cualquier código HTML válido que se renderice correctamente, pero ten en cuenta las restricciones para especificar el campo buyer_creative_id en la sección Create BidResponse message. Puedes usar esta opción para colocar información adicional en los argumentos de las URLs que se recuperan de tus servidores como parte del procesamiento del anuncio. Esto te permite pasar datos arbitrarios sobre la impresión a tus propios servidores.

La mayoría de las políticas para fragmentos HTML que se muestran en las respuestas a la oferta son las mismas que para anuncios de terceros. Para obtener más información, consulta los Lineamientos del programa Authorized Buyers, los Requisitos para la publicación de anuncios mediante servidor de terceros y Declara las URLs de clic en anuncios.

Cómo especificar macros

El fragmento HTML que define una creatividad puede incluir una o más construcciones especiales llamadas macros. Durante la publicación de anuncios, se sustituyen los valores por las macros. Por ejemplo, tu aplicación de ofertas cliente podría usar la macro WINNING_PRICE para determinar cuánto pagó el anuncio, si gana la subasta. Para analizar esta macro, deberás implementar una aplicación que desencripte las confirmaciones de precios. Consulta la página Desencriptación de confirmaciones de precios para obtener más información.

Especifica una macro como parte de un fragmento HTML en el formato %%MACRO%%, en el que MACRO es una de las macros compatibles que se enumeran en la siguiente tabla.

Nota: En el caso de las respuestas de oferta de anuncios de AMP (amp_ad_url), solo se admiten las macros WINNING_PRICE y WINNING_PRICE_ESC.

Google requiere que uses las macros CLICK_URL_UNESC o CLICK_URL_ESC en la creatividad del anuncio publicado por un tercero. Google utiliza las macros de CLICK_URL para el seguimiento de clics.

Para usar una macro, inclúyela en el anuncio para que se recupere la URL cuando alguien haga clic en ella. El valor que se muestra de la recuperación es un redireccionamiento a otra URL que agregas a CLICK_URL.

Macro	Descripción
`ADVERTISING_IDENTIFIER`	Permite que los compradores reciban el IDFA de iOS o el ID de publicidad de Android en el procesamiento de impresiones. Consulta Desencriptación de identificadores de anunciantes para obtener más información.
`CACHEBUSTER`	Representación de string de un número entero aleatorio de cuatro bytes sin firma.
`CLICK_URL_UNESC`	Es la URL de clic sin escape del anuncio. En el fragmento, una versión con escape de la URL de clic de terceros debería 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 podría usar el siguiente código con la versión de escape único de la URL de clic de terceros después de la invocación de la macro: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> En el momento de la publicación de anuncios, está expandido a: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> La URL primero registrará el clic con Google y, luego, redireccionará a la URL de clic de terceros.
`CLICK_URL_ESC`	Es la URL de clic con escape 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 HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> En el momento de la publicación de anuncios, está expandido a: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Esto registrará el clic con `my.adserver.com`, que será responsable de redireccionar a la URL que se pase en el parámetro `google_click_url`. De esta manera, se supone que `my.adserver.com` deja de escapar el parámetro `google_click_url`. Puedes agregar una URL con escape doble después de `%%CLICK_URL_ESC%%`. Una vez que `my.adserver.com` realiza la anulación de escape, esto deja una versión con un solo escape de la URL adjunta a `google_click_url`. Cuando se recupera el `google_click_url`, se anula el escape una vez más y, luego, se redirecciona.
`CLICK_URL_ESC_ESC`	Es la URL con escape doble para el 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 HTML: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> En el momento de la publicación de anuncios, está expandido a: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	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 escape de URL de la URL de contenido o el ID anónimo para el inventario anónimo.
`SITE_URL`	Ya no está disponible. Se reemplazó por la macro SITE que proporciona la misma funcionalidad.
`TZ_OFFSET`	Desfase de zona horaria.
`VERIFICATION`	Los diferentes valores para 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 cualquier valor, excepto las macros, se puede usar para `true-val` y `false-val`, incluidas las strings vacías. Para Open Bidding, 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 incluyera `%%?VERIFICATION:-1:5000%%`, el reemplazo de texto sería `5000` en la publicación y `-1` en la canalización de verificación. Esto es para ayudar a diferenciar entre estos dos conjuntos de pings.
`WINNING_PRICE`	El costo de las impresiones codificadas (es decir, CPI en lugar del CPM) en microsegundos de la moneda de la cuenta. Por ejemplo, un CPM ganador de USD 5 corresponde a un CPM de 5,000,000 micros, o un CPI de 5,000 micros. En este caso, el valor decodificado de `WINNING_PRICE` sería 5,000. El precio ganador se especifica en CPI.
`WINNING_PRICE_ESC`	`WINNING_PRICE` con escape de URL.

El escape de URL en macros utiliza 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, en el que XX es el número hexadecimal que representa el carácter.

Restricciones para publicadores

Los editores usan el BidRequest para pasar restricciones sobre los anuncios que permitirán. Debes aplicar las restricciones en estos campos:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Un campo especifica las funciones permitidas del anuncio y el otro especifica las funciones no permitidas. Nunca mostrar un anuncio con una función no permitida. Para las funciones permitidas, como el tipo de proveedor, muestra un anuncio solo si su tipo de proveedor está en la lista allowed_vendor_type de BidRequest. 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 fragmento HTML en BidResponse, debes configurar con precisión los campos attribute, category y click_through_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. Las respuestas que no tienen estos campos configurados se descartan.

Los valores posibles de BidRequest.excluded_attribute son los siguientes (consulta publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
No se permiten los anuncios si contienen un píxel o un píxel contador web con el fin de crear una lista de ID de cookies para nuevos tipos de remarketing.
8 CookieTargeting: IsCookieTargeted
No se permiten los anuncios si se segmentan para consumidores según su ID de cookie. La lista correspondiente representa un conjunto de consumidores que interactuaron anteriormente con un sitio que pertenecía al comprador o estaba representado.
9 UserInterestTargeting: IsUserInterestTargeted
No se permiten los anuncios si se segmentan para consumidores según su ID de cookie, y la lista de IDs de cookies representa un conjunto de consumidores que el comprador definió como un grupo de interés común.
21 CreativeType: Html
No se permite que los anuncios usen los campos html_snippet o snippet_template en BidResponse.Ad.
22 CreativeType: VastVideo
No se permite que los anuncios utilicen el campo video_url en BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
No se permite que los anuncios requieran compatibilidad con VPAID para renderizarse.
32 MraidType: MRAID
No se permite que los anuncios requieran la renderización de la API de MRAID.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
No se permite que los anuncios requieran compatibilidad con Flash para su renderización.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
No se permite que los anuncios requieran funciones HTML5 para su renderización.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
No está permitido que los anuncios realicen solicitudes que no sean SSL.

Por lo tanto, si el campo excluded_attribute contiene el valor 7, no debes mostrar un anuncio que utilice un píxel o un pixel contador web para crear una lista. Ten en cuenta que si un anuncio hace esto, debe establecer el valor 7 en el campo de atributo de BidResponse. Del mismo modo, si el campo excluded_attribute contiene el valor 48, solo debes mostrar anuncios que se puedan renderizar en una página SSL (y, según corresponda, declarar el atributo 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Además, el campo excluded_sensitive_category de BidRequest usa códigos del archivo ad-sensitive-categories.txt disponible en la página de datos de referencia. A continuación, se incluyen descripciones extendidas de algunos de estos códigos:

3 Politics
Incluye temas políticos o sociales polémicos; no incluye anuncios de organizaciones de noticias que no suelen estar asociadas con un punto de vista partidario sobre ciertos temas.
4 Dating
Incluye servicios de citas y comunidades de citas en línea.
5 Religion
Incluye anuncios religiosos y anuncios que abogan a favor o en contra de opiniones religiosas; no incluye la astrología ni la espiritualidad no confesional.
7 Video Games (Casual & Online)
Incluye videojuegos, juegos en línea y juegos descargables; no incluye consolas de juegos.
8 Ringtones & Downloadables
Complementos para dispositivos móviles, como tonos y otros accesorios descargables, como protectores de pantalla y fondos de pantalla para computadoras de escritorio, así como diseños de perfil y gráficos para redes sociales
10 Get Rich Quick
Esquemas que prometen ingresos rápidos
18 Weight Loss
Incluye productos y programas relacionados con la pérdida de peso y las dietas; no incluye anuncios sobre alimentación saludable ni ejercicio físico general.
19 Cosmetic Procedures & Body Modification
Incluye elevadores, succiones, láseres, depilación y restauración, tatuajes y modificaciones corporales.
23 Drugs & Supplements:
Incluye minoristas de productos farmacéuticos, vitaminas, suplementos y productos relacionados; no incluye recursos que proporcionan información sobre medicamentos.
24 Sexual & Reproductive Health
Incluye anuncios sobre función sexual y fertilidad, pero no incluye recursos sobre embarazo normal.
35 Social Casino Games
Incluye juegos de apuestas simulados (incluidos, sin limitarse a ello, póquer, tragamonedas, bingo, loterías, apuestas deportivas, apuestas en carreras y otros juegos de cartas y casino) en los que no hay oportunidad de ganar ningún artículo de valor (como dinero o premios).
36 Significant Skin Exposure
Imágenes de anuncios en las que cualquier parte del cuerpo humano, desde el esternón hasta la mitad del muslo, no esté cubierta, o bien en las que el cuerpo esté cubierto con ropa interior, trajes de baño, lencería, prendas transparentes o artículos que no sean prendas de vestir, como una toalla o una sábana
37 Sensationalism
Anuncios que tienen como objetivo inducir a los usuarios a hacer clic en ellos. Para ello, apelan a su curiosidad, a menudo a través de un mensaje engañoso que utiliza imágenes o texto exagerados. Incluye anuncios que se centran en temas sensacionalistas (como muertes, divorcios o detenciones de celebridades) o que pretenden causar un impacto.

Open Measurement

Open Measurement te permite especificar proveedores de terceros que proporcionan servicios independientes de medición y verificación para anuncios que se publican en entornos de apps para dispositivos móviles.

Los formatos de anuncios admitidos actualmente incluyen anuncios intersticiales, de video y de banner. Si deseas obtener más información para usar Open Measurement en una respuesta a la oferta que contiene estos formatos, consulta el artículo del Centro de ayuda sobre el SDK de Open Measurement.

Ejemplos de respuestas a ofertas

Las siguientes secciones muestran ejemplos de respuestas a ofertas para diferentes tipos de anuncios.

Google

Muéstrame el ejemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

OpenRTB Protobuf

Muéstrame el ejemplo

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

Intersticial para aplicaciones

Google

Muéstrame el ejemplo

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

OpenRTB Protobuf

Muéstrame el ejemplo

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

Video intersticial para aplicaciones

Google

Muéstrame el ejemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

OpenRTB Protobuf

Muéstrame el ejemplo

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Nativo de la aplicación

Google

Muéstrame el ejemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  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: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    click_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: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

OpenRTB Protobuf

Muéstrame el ejemplo

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

Video web

Google

Muéstrame el ejemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB Protobuf

Muéstrame el ejemplo

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}

Crea la respuesta

Crear mensaje de BidResponse

ID de la creatividad

Atributos del anuncio

Campos de Open Bidding

Recomendaciones

Ejemplo de respuesta a la oferta

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

OpenRTB Protobuf

Muéstrame el ejemplo

Especificar creatividad

Cómo especificar macros

Restricciones para publicadores

Open Measurement

Ejemplos de respuestas a ofertas

Banner de la app

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

OpenRTB Protobuf

Muéstrame el ejemplo

Intersticial para aplicaciones

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

OpenRTB Protobuf

Muéstrame el ejemplo

Video intersticial para aplicaciones

Google

Muéstrame el ejemplo

OpenRTB Protobuf

Muéstrame el ejemplo

Nativo de la aplicación

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

OpenRTB Protobuf

Muéstrame el ejemplo

Video web

Google

Muéstrame el ejemplo

Banner web móvil para el ofertante de Ad Exchange

OpenRTB Protobuf

Muéstrame el ejemplo