Anuncios de video de OpenRTB

En esta guía, se describen los requisitos de integración para la compra de RTB con el protocolo OpenRTB. Esta guía se debe usar junto con la de OpenRTB Integration, en la que se describen en detalle los campos que se analizan a continuación.

Si compras en apps para iOS con fragmentos HTML que incluyen etiquetas <video>, debes incluir el atributo playsinline en la etiqueta de video. De lo contrario, los usuarios tendrán una experiencia muy mala, ya que los anuncios de video que deberían reproducirse dentro de la creatividad parecen aparecer en pantalla completa. Se bloquearán los anuncios que no respeten esto.

Requisitos del comprador

Los nuevos compradores de RTB deben desarrollar sus ofertantes con el búfer de protocolo más reciente y la información que se describe en las siguientes secciones. Para descargar el protocolo, consulta la página de datos de referencia. Para obtener información sobre cómo desarrollar un ofertante, consulta Cómo procesar la solicitud y Cómo crear la respuesta.

Macros compatibles

Las siguientes macros son compatibles con las creatividades de video in-stream:

• %%CACHEBUSTER%%
• %%WINNING_PRICE%%

Ten en cuenta que el reemplazo de macros está permitido en la URL del video, pero no dentro del XML de VAST real.

Las macros de clics (como CLICK_URL_ESC) no son necesarias porque Authorized Buyers incluye sus herramientas de seguimiento de clics en un wrapper de VAST. Por lo tanto, las macros de clics no son compatibles con los anuncios de video in-stream. Para obtener más información sobre las macros compatibles, consulta Cómo especificar macros en Compila la respuesta.

Detalles del objeto de video

El protocolo OpenRTB usa un mensaje Video, que se define en el archivo openrtb-proto.txt para identificar las solicitudes de video y proporcionar información adicional específica del video sobre la solicitud.

Consulta la lista de campos de mensajes de video en la guía de integración de OpenRTB para obtener descripciones y ejemplos detallados.

Otros campos de solicitudes de oferta de video

No todos los indicadores que se muestran a continuación son exclusivos de las creatividades de video, pero son partes clave de la solicitud de oferta.

Campos de objeto imp

Este objeto describe una posición de anuncios o una impresión que se subasta.

banner	Un objeto de banner; es obligatorio si la impresión se ofrece como una oportunidad de anuncio de banner.
video	Indica el tipo de impresión que se ofrece, en este caso, video. Ten en cuenta que se permite el video en banner si el objeto imp incluye los objetos banner y video.
tagid	Es el identificador de una posición de anuncios o una etiqueta de anuncio específicas que se usó para iniciar la subasta. Esto puede ser útil para depurar cualquier problema o para la optimización por parte del comprador.
bidfloor	Es la oferta mínima para esta impresión expresada en CPM.
bidfloorcur	Una sola moneda, que se obtiene de los billing_id. incluidos

Consulta la sección Objeto Imp en la guía de OpenRTB para obtener más detalles.

Campos de objetos del dispositivo

Los campos del objeto Device proporcionan información sobre el dispositivo de destino.

ua	Es la cadena de usuario-agente del navegador.
ip	Dirección IPv4 más cercana al dispositivo.
geo	Ubicación del dispositivo que se supone que es la ubicación actual del usuario, definida por un objeto Geo.
devicetype	Es el tipo general de dispositivo.
ifa	Es el ID sancionado cuando el anunciante lo usa en el momento de la verificación (por ejemplo, sin codificación hash). ifa es compatible con dispositivos de TV conectados, como Roku, Apple TV, Fire TV y Xbox.

Consulta la sección Objeto de dispositivo en la guía de OpenRTB para obtener detalles adicionales.

Objeto de sitio

Los campos del objeto Site proporcionan información sobre el sitio con contenido compatible con anuncios.

page	URL de la página en la que se mostrará la impresión.
publisher	Detalles sobre el objeto Publisher del sitio.
content	Detalles sobre el Content dentro del sitio.

Consulta la sección del objeto Site en la guía de OpenRTB para obtener detalles adicionales.

Objeto de usuario

Los campos del objeto User proporcionan información sobre el sitio con contenido compatible con anuncios.

id	Es el ID específico de Exchange para el usuario. Se recomienda usar al menos uno de los siguientes valores: id o buyerid.
data	Detalles sobre el objeto Publisher del sitio.

Consulta la sección Objeto del usuario en la guía de OpenRTB para obtener detalles adicionales.

Campos de inventario de la solicitud de oferta

La solicitud de oferta de video también contiene información sobre los tipos de contenido y los anuncios complementarios especificados.

mimes

Lista de tipos de MIME de contenido admitidos.

companionad

Es el array de objetos de banner si hay anuncios complementarios disponibles.

Campos de respuesta a la oferta

Los campos clave en una respuesta a la oferta de video incluyen los siguientes:

id

Es el ID de la solicitud de oferta para la que es una respuesta.

seatbid

Es el array de objetos de Seatbid. Se requiere uno o más si se debe realizar una oferta.

seat

Un objeto Seatbid; ID de la licencia del comprador (por ejemplo, anunciante, agencia) en cuyo nombre se realiza esta oferta.

bid

Es el array de uno o más objetos Bid que están relacionados con una impresión.

Segmentación previa

Para recibir el inventario de video, los compradores de OpenRTB deben tener una configuración de orientación previa que incluya el inventario de video.

Ejemplo de solicitud de oferta y respuesta

Solicitud de oferta

Mostrar

{
  id: "XIsz9QAHfAYKj3oDMQ3QOg",
  imp: [{
    id: "1",
    banner: {
      w: 300,
      h: 250,
      format:     [{
        w: 300,
        h: 250
      },{
        w: 250,
        h: 250
      }],
      battr:     [5]
    },
    video: {
      mimes:     [video/mp4],
      linearity: 1,
      protocols:     [2,3,5,6],
      w: 300,
      h: 250,
      skip: 1,
      battr:     [5],
      playbackmethod:     [6],
      plcmt: 3
    },
    displaymanager: "GOOGLE",
    tagid: "2111189154",
    bidfloor: 0.01,
    bidfloorcur: "USD",
    secure: 1,
    native: {
      request_native: {
        ver: "1.2",
        assets:       [{
          id: 1,
          required: 1,
          title: {
            len: 25
          }
        },{
          id: 2,
          data: {
            type: 2,
            len: 90
          }
        },{
          id: 3,
          data: {
            type: 12,
            len: 15
          }
        },{
          id: 4,
          data: {
            type: 1,
            len: 25
          }
        },{
          id: 5,
          img: {
            type: 3,
            wmin: 1200,
            hmin: 627
          }
        },{
          id: 6,
          img: {
            type: 2,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 7,
          img: {
            type: 1,
            wmin: 100,
            hmin: 100
          }
        },{
          id: 8,
          data: {
            type: 3,
            len: 5
          }
        },{
          id: 9,
          video: {
            mimes:           [video/mp4]
          }
        }],
        eventtrackers:       [{
          event: 1,
          methods:         [1]
        }],
        adx_ext: {
          style_id: 188961,
          style_height: 250,
          style_width: 300
        }
      },
      ver: "1.2",
      battr:     [5]
    },
    metric:   [{
      type: "click_through_rate",
      value: 0.0006341254338622093,
      vendor: "EXCHANGE"
    },{
      type: "video_completion_rate",
      value: 0.017279919236898422,
      vendor: "EXCHANGE"
    },{
      type: "viewability",
      value: 0.7,
      vendor: "EXCHANGE"
    },{
      type: "session_depth",
      value: 1,
      vendor: "EXCHANGE"
    }],
    adx_ext: {
      billing_id:     [12345567890],
      publisher_settings_list_id:     [5509324247698256194,14109776396365339331],
      allowed_vendor_type:     [3,42,79,4463,4513,4538,4625],
      ampad: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED"
    }
  }],
  site: {
    page: "https:/example.com/school",
    publisher: {
      id: "pub-783270600012345",
      adx_ext: {
        country: "IN"
      }
    },
    content: {
      contentrating: "DV-G",
      language: "en"
    },
    mobile: 1,
    adx_ext: {
      amp: "DIALECT_HTML"
    }
  },
  device: {
    ua: "Mozilla/5.0 (iPad; CPU OS 12_1_4 like Mac OS X) FBOP/5;FBRV/0]",
    ip: "121.222.242.0",
    geo: {
      lat: -26.487831115722656,
      lon: 153.0424346923828,
      country: "AUS",
      region: "AU-QLD",
      zip: "4562",
      utcoffset: 600
    },
    make: "apple",
    model: "ipad",
    os: "iOS",
    osv: "12.1.1",
    w: 768,
    h: 1024,
    pxratio: 2,
    devicetype: 5
  },
  user: {
    id: "CAESEK6jGeddIeo_opp-WrY",
    buyeruid: "anFTbmRJMVF3VXy0",
    customdata: "anFTbmRJMVVXy0",
    data:   [{
      id: "DetectedVerticals",
      name: "DoubleClick",
      segment:     [{
        id: "1263",
        value: "0.5"
      },{
        id: "625",
        value: "0.1"
      }]
    }]
  },
  at: 2,
  tmax: 122,
  cur: [USD],
  bcat: [IAB7-39],
  adx_ext: {
    google_query_id: "ANy-zJFcyG8sUO0_hYbujPqNXbB3bPA"
  }
}

Respuesta a la oferta

Mostrar

{
  "id": "AB1abcDEfghijklMno2pqr",
  "seatbid": [
    {
      "seat": "Example Seat",
      "bid": [
        {
          "id": "12345678901234567890",
          "impid": "1",
          "price": 15,
          "adid": "AB1234-1234",
          "adm": "https://example.com/AdX/win?tag=AbcdEfGhIJ0kLMN2OPQ2RST3UVXyZAB2Cde114eF
          "cid": "12345678901",
          "crid": "1234",
          "adomain": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "cur": "USD",
  "bidid": "1234567890123456789"
}

Glosario

Consulta el glosario de video de Authorized Buyers.