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

Crea la respuesta

Una vez que su aplicación procese la solicitud de oferta de Google, debe crear y envía una respuesta. En esta guía, se explica cómo programar tu aplicación para compilarla la respuesta.

Crear mensaje BidResponse

Authorized Buyers envía el elemento BidRequest como el cuerpo del mensaje de un POST HTTP. La respuesta que envía tu aplicación debe tener el encabezado Content-Type se estableció en application/octet-stream y un cuerpo de mensaje que consta de un búfer de protocolo serializado. El protocolo búfer es un mensaje BidResponse, como se define en realtime-bidding.proto Tu aplicación debe mostrar un código BidResponse en respuesta a cada BidRequest. Suspensión temporal y las respuestas que no pueden analizarse se consideran errores, y Google regula a los ofertantes con tasas de error altas.

Si no desea realizar una oferta para una impresión, puede configurar processing_time_ms solo y dejar todos los demás campos vacío. Puedes obtener realtime-bidding.proto de la datos de referencia.

ID de la creatividad

Tu BidResponse especifica una creatividad mediante el elemento Campo buyer_creative_id (límite de 64 bytes). Incluso las creatividades similares debe tener valores únicos para buyer_creative_id si difieren en características notables, incluidas, sin limitaciones, el tamaño, la URL declarada, atributos de creatividades y tipos de proveedores. En otras palabras, debes asignar ID de creatividad de dos anuncios cualquiera que:

Verse o comportarse de manera diferente.
Renderiza en diferentes imágenes.
Renderice de forma diferente (por ejemplo, un anuncio consta de una imagen, mientras que la otra contiene Flash).

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

Atributos del anuncio

Debe declarar los atributos de la creatividad que describen plenamente los atributos características y su segmentación en BidResponse.Ad.attribute. El que se deben declarar son (consulta también la lista completa de atributos en buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
El anuncio contiene un píxel o una baliza web para crear una lista de los ID de las cookies para su posterior remarketing.
8 Remarketing: IsRemarketing
El anuncio se orienta a los consumidores según su ID de cookie o ID de dispositivo, donde la lista de IDs de cookies o IDs de dispositivos representa un conjunto de consumidores que interactuaron previamente con un sitio que pertenece al comprador o que está representado por este.
9 UserInterestTargeting: IsUserInterestTargeted
El anuncio se orienta a los consumidores según su ID de cookie o ID de dispositivo, donde La lista de IDs de cookies o de ID de dispositivo representa a un conjunto de consumidores que el comprador se define como un grupo de interés común.
30 InstreamVastVideoType: Vpaid
El anuncio requiere compatibilidad con VPAID para su renderización.
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 necesario, ya que Authorized Buyers los detecta automáticamente y los bloqueará (o (permitir) tus creatividades en función de los valores detectados, en lugar de tu declaración. Consulta API de Creatives para ver una explicación sobre cómo obtener comentarios acerca de las propiedades detectadas de tu creatividades.

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

Campos de Open Bidding

Respuestas a ofertas enviadas por los ofertantes de intercambio y red que participan en Open Bidding Las ofertas son similares a las de los compradores de Authorized Buyers que participan en el con las ofertas en tiempo real. 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: Actualmente, este campo solo se envía a versiones beta cerradas participantes.
`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: Actualmente, este campo solo se envía a versiones beta cerradas participantes.
`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. Esto se obtiene de la comprador externo y se debe enviar a Google sin alteraciones en la oferta respuesta.

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 a las mínimo, ya que 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 cuando la de impresiones, en lugar de cuando gana el ofertante. Debido al destino entre victorias y renderizaciones, esto proporciona un seguimiento más preciso estadísticas.

Nota: Si utilizas OpenRTB 2.5 o una versión posterior, el campo estándar de 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.Ad.width y BidResponse.Ad.height en tu BidResponse. R BidResponse a una solicitud que incluye varios tamaños de anuncios debe incluyas los valores width y height, o será de la subasta.
Limita el tamaño de las respuestas a menos de 8 KB. Las respuestas muy grandes pueden aumentar la latencia de la 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.

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

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"
}

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
}

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 Por ejemplo, especificamos la creatividad con el campo html_snippet.

También puedes especificar tu creatividad usando uno de los 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

Especifique un anuncio alojado en su(s) propio(s) servidor(es) mediante un fragmento de HTML en el campo html_snippet de BidResponse. El se encierra en un iframe insertado en la página web, lo que genera el anuncio que se recupera y renderiza cuando se carga la página. Debes crear el archivo HTML para que el anuncio (banner o anuncio intersticial) se dibuje correctamente en una y en un tamaño adecuado para el espacio publicitario en el que realizas ofertas.

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

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 se requiere 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 de, al menos, el 40% de el alto de la pantalla.

El campo html_snippet admite cualquier código HTML válido que se renderiza correctamente, pero debes tener en cuenta las restricciones para especificar la Campo buyer_creative_id de la sección Crear mensaje de respuesta a la oferta Uno para esto es colocar información extra en los argumentos de las URLs que se recuperados 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 HTML que se muestran en las respuestas de oferta son las mismas que para anuncios de terceros. Consulte Authorized Buyers Lineamientos del Programa, Requisitos para Terceros publicación de anuncios y declarar las URLs de clic en los anuncios para obtener más información.

Cómo especificar macros

El fragmento HTML que define una creatividad puede incluir una o más construcciones llamadas macros. En el momento de la publicación de anuncios, se sustituyen los valores por o usar las macros. Por ejemplo, tu aplicación de licitación cliente podría usar el WINNING_PRICE para determinar cuánto pagó por el anuncio si gana la subasta. Para analizar esta macro, debes implementar un que desencripta las confirmaciones de precios. Consulta Cómo desencriptar el precio Confirmaciones para obtener más información.

Especifica una macro como parte de un fragmento HTML en el formato %%MACRO%%, donde MACRO es uno de los formatos admitidos que se muestran en la tabla a continuación.

Nota: Solo en el caso de las respuestas de ofertas de anuncios de AMP (amp_ad_url), Las macros WINNING_PRICE y WINNING_PRICE_ESC son es compatible.

Google requiere que uses CLICK_URL_UNESC o Macro CLICK_URL_ESC en la creatividad de la plataforma publicada por terceros anuncio. Google usa 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 si alguien hace clic en él. El valor que se muestra de la recuperación es un redireccionamiento a otro 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 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 de escape del elemento la URL de clic de terceros debe seguir directamente la macro. Por ejemplo, si la URL de clic de terceros es `http://my.adserver.com/some/path/handleclick?click=clk`, puede usarse el siguiente código con la versión con escape único de la tercera URL de clic de parte que sigue a 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, esto se expande 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`	La URL de clic con escape para el anuncio. Usa esto en lugar de `CLICK_URL_UNESC` si primero necesitas pasar el valor mediante 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%%"></a> En el momento de la publicación de anuncios, esto se expande 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 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 `google_click_url` parámetro. 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 la URL con un solo escape se agrega a `google_click_url`. Cuando `google_click_url` se recupera, dejará de escapar una vez más y, luego, o redireccionamiento.
`CLICK_URL_ESC_ESC`	La URL con escape doble para el anuncio. Usa esto en lugar de `CLICK_URL_UNESC` si primero necesitas pasar el valor mediante 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 para Es `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`	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 el proceso de verificación en una canalización de integración continua. El formato es: `%%?VERIFICATION:true-val:false-val%%`, donde cualquier de salida, excepto que las macros se pueden usar para `true-val` y `false-val`, incluidas las cadenas vacías. Para Open Bidding, recomendamos que los socios de intercambio usen esta macro. una vez que lo hacen, las plataformas orientadas a la demanda no necesitan hacer cambios. Por ejemplo, si una creatividad incluyera `%%?VERIFICATION:-1:5000%%` entonces el reemplazo del texto sería `5000` en la publicación y `-1` en la de verificación de identidad. 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 de CPM) en micros 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. La arquitectura el valor de `WINNING_PRICE` en este caso 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 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 valor hexadecimal el número que representa el carácter.

Restricciones para publicadores

Los publicadores usan la BidRequest para pasar restricciones sobre qué 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, atributos no permitidos. Nunca muestres un anuncio con una función no permitida. Permitidas funciones como el tipo de proveedor, muestran un anuncio solo si su tipo de proveedor se encuentra en allowed_vendor_type en la lista BidRequest. Consulta la comentarios para estos campos en el búfer de protocolo BidRequest definición para obtener más detalles.

Si se muestra un fragmento HTML en BidResponse, sucede lo siguiente: necesarios para establecer con precisión attribute, category y y click_through_url en el BidResponse. Si un anuncio tiene múltiples valores aplicables para estos campos, entonces 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.

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 una baliza web con el objetivo de crear una lista de los ID de las cookies para su posterior remarketing.
8 CookieTargeting: IsCookieTargeted
No se permiten los anuncios si se segmentan para los consumidores en función de su ID de cookie donde la lista de IDs de cookies representa un conjunto de consumidores que interactuaron anteriormente con un sitio que es propiedad del comprador o que este representa.
9 UserInterestTargeting: IsUserInterestTargeted
No se permiten los anuncios si se segmentan para los consumidores en función de su ID de cookie donde la lista de IDs de cookies representa un conjunto de consumidores que el comprador definió como grupo de interés común.
21 CreativeType: Html
Los anuncios no pueden usar html_snippet ni snippet_template en BidResponse.Ad.
22 CreativeType: VastVideo
Los anuncios no pueden usar el campo video_url en BidResponse.Ad.
30 InstreamVastVideoType: Vpaid
No se permite que los anuncios requieran compatibilidad con VPAID para su renderización.
32 MraidType: MRAID
No se permite que los anuncios requieran que la API de MRAID se renderice.
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
Los anuncios no pueden realizar solicitudes que no sean SSL.

Por lo tanto, si el campo excluded_attribute contiene el valor 7, no debería mostrar un anuncio que use un píxel o una baliza web para creando una lista. Ten en cuenta que si un anuncio hace esto, debe establecer el valor 7 en el campo de atributo de BidResponse De manera similar, si el campo excluded_attribute contiene el valor 48, solo debería mostrar anuncios que puedan renderizarse en una página SSL (y, en consecuencia, declarar el atributo 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

También el campo excluded_sensitive_category en la BidRequest usa códigos de la Archivo ad-sensitive-categories.txt disponible en la página de datos de referencia. Aquí tienes descripciones de algunos de estos códigos:

3 Politics
Incluye cuestiones políticas o cuestiones sociales polémicas. no incluye los anuncios de organizaciones de noticias que no suelen tener 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 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, incluidos tonos y otras funciones descargables, como protectores y fondos de pantalla para PCs de escritorio, así como diseños de perfil y elementos gráficos para redes sociales
10 Get Rich Quick
Esquemas que prometen ingresos rápidos
18 Weight Loss
Incluye programas y productos relacionados con la pérdida de peso y las dietas. No incluye anuncios sobre nutrición saludable ni ejercicio físico general.
19 Cosmetic Procedures & Body Modification
Incluye liftings, liposucciones, tratamientos con láser, depilación, implantes capilares, tatuajes y modificaciones corporales.
23 Drugs & Supplements:
Incluye productos farmacéuticos, vitaminas, suplementos y minoristas relacionados. no incluye los recursos que proporcionan información sobre drogas.
24 Sexual & Reproductive Health
Incluye anuncios sobre fertilidad y función sexual. no incluye recursos sobre el embarazo normal.
35 Social Casino Games
Incluye juegos de apuestas simuladas (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 no está vestida ninguna parte del cuerpo humano, desde el esternón hasta la mitad del muslo o vestido con ropa interior, trajes de baño, lencería o cualquier otra ropa transparente o prendas que no sean ropa, como una toalla o sábana
37 Sensationalism
Anuncios que tienen como objetivo inducir a los usuarios a hacer clic en ellos apelando a su curiosidad, a menudo a través de un mensaje de avance con texto o imágenes hiperbólicos. 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 externos que ofrecen mediciones y servicios de verificación para anuncios publicados en entornos de apps para dispositivos móviles.

Actualmente, los formatos de anuncios admitidos incluyen anuncios de video, intersticiales y de banner. Más información Para obtener información sobre cómo usar Open Measurement en una respuesta de oferta que contiene estos formatos, consulte el Centro de ayuda del SDK de Open Measurement .

Ejemplo de respuestas de oferta

En las siguientes secciones, se muestran ejemplos de respuestas de oferta 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: 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

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"
}

Protocolo 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"

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: 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

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"
}

Protocolo 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"

Video intersticial para aplicaciones

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

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"

Aplicación nativa

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

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"
}

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"

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

Protocolo 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

Crear mensaje 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

Protocolo de OpenRTB

Muéstrame el ejemplo

Especificar creatividad

Cómo especificar macros

Restricciones para publicadores

Open Measurement

Ejemplo de respuestas de oferta

Banner de la app

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Protocolo de OpenRTB

Muéstrame el ejemplo

Intersticial para aplicaciones

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Protocolo de OpenRTB

Muéstrame el ejemplo

Video intersticial para aplicaciones

Google

Muéstrame el ejemplo

Protocolo de OpenRTB

Muéstrame el ejemplo

Aplicación nativa

Google

Muéstrame el ejemplo

JSON de OpenRTB

Muéstrame el ejemplo

Protocolo de OpenRTB

Muéstrame el ejemplo

Video web

Google

Muéstrame el ejemplo

Banner de Web móvil para ofertante de intercambio

Protocolo de OpenRTB

Muéstrame el ejemplo