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

Crea la respuesta

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 elemento BidRequest como el cuerpo del mensaje de un POST HTTP. Si tu extremo de ofertas está configurado para usar protobuf, tu aplicación debe enviar una respuesta con el Se estableció el encabezado Content-Type 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. Suspensión temporal y las respuestas que no pueden analizarse se consideran errores, y Google regula ofertantes con tasas de error altas.

Si no desea realizar una oferta para una impresión, puede configurar BidResponse.ext.processing_time_ms solo y dejar todo otros campos vacíos. Puedes obtener openrtb.proto de la 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). Igual las creatividades deben tener valores únicos en este campo si difieren en características notables, incluidas, sin limitaciones, el tamaño, la URL declarada, los atributos de las creatividades y los tipos de proveedores. En otras palabras, debes asignar ID de creatividad de dos anuncios cualquiera que:

Se ven o se comportan de manera diferente.
Renderiza en diferentes imágenes.
Renderice de forma diferente (por ejemplo, un anuncio consta de una imagen, mientras que la otra es un video).

A medida que diseñas 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 la creatividad para describir la características y su orientación mediante una combinación de BidResponse.seatbid.bid.apis y BidResponse.seatbid.bid.attr o el BidResponse.seatbid.bid.ext.attribute. Lo siguiente se describe cómo puedes declarar atributos:

VPAID
Establece BidResponse.seatbid.bid.apis en VPAID_1, o VPAID_2. En el caso del formato JSON, se puede configurar en 1 o 2, respectivamente.
MRAID
Establece BidResponse.seatbid.bid.apis en MRAID_1 o 3 para el formato JSON.
SIZELESS
Establecer BidResponse.seatbid.bid.attr en RESPONSIVE o 18 para JSON de un conjunto de datos tengan un formato común.
PLAYABLE
Para indicar esto, configura BidResponse.seatbid.bid.attr como USER_INTERACTIVE o 13 para el formato JSON.

Nota: Si utilizas el BidResponse.seatbid.bid.ext.attribute, puedes usar valores encontrados en buyer-declarable-creative-attributes.txt para declarar estos atributos.

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. Estos incluyen lo siguiente:

OpenRTB	Authorized Buyers	Detalles
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	El ID del acuerdo del espacio de nombres del intercambio asociado y se informan a los publicadores. Nota: 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`	El tipo de acuerdo que se informa a los publicadores y que afecta su funcionamiento que se trataron en la subasta. Nota: 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 utiliza para identificar la información del comprador externo si el Exchange como ofertante de Open Bidding es intermediario. Se obtiene del comprador externo y se debe pasar a Google sin modificaciones en la respuesta de la oferta.

Recomendaciones

Habilitar 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 verifica durante las pruebas de latencia iniciales de tu aplicación, ya que Authorized Buyers envía solicitudes con una frecuencia elevada y necesita evitar las de latencia adicional del establecimiento de una conexión TCP separada para cada 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.

Nota: Cuando se usa OpenRTB, el campo estándar para esto es BidResponse.seatbid.bid.burl.
Mantén tu código de ofertante libre de dependencias en campos obsoletos. lo que puede provocar errores en tus ofertas.
Incluye BidResponse.seatbid.bid.w y BidResponse.seatbid.bid.h en tu BidResponse. R BidResponse a una solicitud que incluye varios tamaños de anuncios debe incluir estos campos o se eliminará de la subasta.
Limita el tamaño de tu respuesta a menos de 8,000. Las respuestas muy grandes pueden aumentar la latencia de red y provocar tiempos de espera.
Sigue las pautas para en el inventario de iOS que requieren una atribución de SKAdNetwork.

Ejemplo de respuesta a la oferta

Los siguientes ejemplos representan muestras legibles de Protobuf y Solicitudes JSON.

Protocolo de OpenRTB

Muéstrame el ejemplo

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    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: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "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": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

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: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

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

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
}

Especificar creatividad

Tu respuesta a la oferta especifica la creatividad que se publicará si gana tu oferta. Su oferta Debe incluir uno de los formatos del anuncio 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

Especifique un anuncio alojado en su(s) propio(s) servidor(es) mediante un fragmento de HTML en el campo BidResponse.seatbid.bid.adm El fragmento se encierra en un iframe insertado en la página web, lo que hace que se recupere el anuncio se renderiza cuando se carga la página. Debes crear el fragmento HTML para que el (banner o intersticial) se renderiza correctamente en un iframe y en para el espacio publicitario en el que realizas ofertas.

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 común (no de video, nativo ni intersticial).
El ofertante declaró el tamaño en la respuesta a la 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 poner información adicional en 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 sus propios servidores.

La mayoría de las políticas para los fragmentos de HTML que se muestran en las respuestas a las ofertas son las mismas que para los anuncios de terceros. Consulte Authorized Buyers Lineamientos de los Programas, Requisitos para Terceros publicación de anuncios y declarar las URLs de clic en los anuncios para obtener más información.

Especifica macros

Las macros son texto con formato incorporado en algunos campos de respuesta a la oferta que contienen Son las URLs que se reemplazan por un valor relevante en el momento de la publicación de anuncios. Por ejemplo: si tu oferta ganadora incluyó la macro AUCTION_PRICE en el código HTML de fragmento de creatividad incluido en su oferta, la macro se reemplazará por una valor que podrías desencriptar para determinar el importe que pagaste por la impresión en durante 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 XML de VAST de video.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

Solo se admiten WINNING_PRICE y Las macros de WINNING_PRICE_ESC son compatibles con las creatividades de AMP.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

Úsalo en lugar de BidResponse.seatbid.bid.burl si necesitas más de una URL de facturación.

Por ejemplo, podrías incluir una macro como parte de un fragmento HTML incorporar ${MACRO} en la URL que se usó para recuperar la creatividad en la que MACRO es una de las macros admitidas que se describen en el 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 describe con 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 identificadores de anunciantes. para conocer los detalles.
`CACHEBUSTER`	Es una representación de cadena de un número entero aleatorio de cuatro bytes sin firma.
`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: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> En el momento de la publicación del anuncio, se expande de la siguiente manera: <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 en Google y, luego, lo redireccionará 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: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> En el momento de la publicación del anuncio, se expande de la siguiente manera: <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 los usuarios a la URL que se pase en el Parámetro `google_click_url`. Esto supone que `my.adserver.com` quita el escape de Parámetro `google_click_url`. Puedes agregar una URL con escape doble después `%%CLICK_URL_ESC%%` Después de que se realice el unecap `my.adserver.com`, que deja una versión de escape único de la URL 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`	La URL con doble escape del anuncio. Usa esto en lugar de `CLICK_URL_UNESC` si primero necesitas pasar el valor a través de otro servidor que devolverá un redireccionamiento. Por ejemplo, el siguiente código podría usarse en un fragmento de 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, esto se expande 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 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`	Desplazamiento de la 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 macros, para `true-val` y `false-val`, incluidas las cadenas vacías. Para Open Bidding, recomendar que los intercambios usen esta macro una vez que lo hagan, las apps orientadas a la demanda plataformas no necesitan hacer 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 de `WINNING_PRICE` decoded 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 las Desencriptación de confirmaciones de precio para obtener más información.
`WINNING_PRICE_ESC`	`WINNING_PRICE` con escape 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 los requisitos que los publicadores otorgan a las creatividades en la subasta.

BidRequest.bcat
- Puedes comparar las categorías bloqueadas especificadas por este campo con aquellas detectado para las creatividades enviadas con la API de Real-time Bidding campo detectedCategories.
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 oferte 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 ofrecen servicios de medición y verificación para anuncios que se publican en aplicaciones para dispositivos móviles entornos de prueba.

Entre los formatos de anuncios admitidos, se incluyen los anuncios de video, intersticiales y de banner. 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 ejemplos de respuestas de oferta para diferentes tipos de anuncios.

Protobuf de OpenRTB

Muéstrame el ejemplo

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    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: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "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": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

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: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

Anuncio intersticial para aplicaciones

Protobuf de OpenRTB

Muéstrame el ejemplo

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    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"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "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": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

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: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  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: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

Anuncio intersticial de video en la aplicación

Protocolo de OpenRTB

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"

Google

Muéstrame el ejemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

App nativa

Protocolo de OpenRTB

Muéstrame el ejemplo

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

JSON de OpenRTB

Muéstrame el ejemplo

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Google

Muéstrame el ejemplo

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    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"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

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

Protobuf de OpenRTB

Muéstrame el ejemplo

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    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: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Crea la respuesta

Crea un mensaje de BidResponse de Protobuf

ID de la creatividad

Atributos del anuncio

Campos de Open Bidding

Recomendaciones

Ejemplo de respuesta a la oferta

Protocolo de OpenRTB

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Google

Muéstrame el ejemplo

Especificar creatividad

Especifica macros

Macros de RTB de Google

Restricciones y requisitos para publicadores

Open Measurement

Ejemplos de respuestas de ofertas

Banner de la app

Protobuf de OpenRTB

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Google

Muéstrame el ejemplo

Anuncio intersticial para aplicaciones

Protobuf de OpenRTB

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Google

Muéstrame el ejemplo

Anuncio intersticial de video en la aplicación

Protocolo de OpenRTB

Muéstrame el ejemplo

Google

Muéstrame el ejemplo

App nativa

Protocolo de OpenRTB

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Google

Muéstrame el ejemplo

Video web

Google

Muéstrame el ejemplo

Banner web móvil para ofertantes de intercambio

Protobuf de OpenRTB

Muéstrame el ejemplo