Compartir a través de


Requisitos de la solicitud de puja de OpenRTB

Los asociados de suministro de Xandr deben proporcionar metadatos de subasta suficientes en las solicitudes de puja entrantes para garantizar que los compradores tengan la información que necesitan para pujar de forma inteligente. Esta página documenta los campos de OpenRTB necesarios y los umbrales de volumen correspondientes que deben cumplirse. Por ejemplo, un umbral del 95 % para el campo de altura del banner indica que el 95 % de las solicitudes muestreadas aleatoriamente deben contener información sobre el alto del banner. Los ejemplos de tráfico deben cumplir los umbrales de todos los campos pertinentes. El inventario que no cumpla los requisitos descritos a continuación será apto para la venta a través de ofertas, pero no estará disponible en el intercambio abierto.

Actualmente, determinamos la idoneidad para los siguientes formatos:

  • Web Banner
  • Vídeo web
  • Web Audio
  • Web Native
  • Banner de la aplicación
  • Vídeo de la aplicación
  • Audio de la aplicación
  • Nativo de la aplicación

La designación "web" incluye tanto web de escritorio como web móvil; "app" se define como inventario en la aplicación. En el futuro se pueden agregar umbrales adicionales para otros tipos de medios, como nativos o de audio.

Criterios y umbrales de la solicitud de puja

En las secciones siguientes se describen los campos de solicitud de puja de OpenRTB necesarios para cada formato. La columna "Campo OpenRTB requerido" representa los campos de OpenRTB de IAB que corresponden al "Atributo de subasta" de la primera columna. En los casos en los que se enumeran varios campos OpenRTB para un atributo de subasta determinado, solo se requiere uno de esos campos. Por ejemplo, para que una solicitud pase el criterio "Id. de etiqueta" para "Criterios de banner web", es necesario pasar site.id o imp.tagid.

Criterios de banner web

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Height imp.banner.h integer Especifica el alto exacto del banner en píxeles. 95 %
Width imp.banner.w integer Especifica el ancho exacto del banner en píxeles. 95 %
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor. 95 %
Identificadores site.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador site.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Dominio site.domain string Especifica el dominio del sitio (por ejemplo, publishersite.com) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión, si está disponible, o extraído del page campo. 95 %
Dominio site.page Especifica la dirección URL completa de la página donde se mostrará la impresión (por ejemplo, page.publishersite.com/path/to/page). Debe ser la dirección URL del referenciador y se prefiere sobre el domain campo. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, Xandr establece el dispositivo make y devicetype se basa en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Criterios de vídeo web

Atributo Campo OpenRTB requerido Tipo Description Umbral
Height imp.video.h integer Especifica el alto del reproductor de vídeo, en píxeles. 95 %
Width imp.video.w integer Especifica el ancho del reproductor de vídeo, en píxeles. 95 %
Tipo mime imp.video.mimes matriz de cadenas Especifica los tipos MIME de contenido de vídeo admitidos; por ejemplo, video/x-ms-wmv y video/x-flv. Si no se especifica, se permite cualquier tipo MIME. 95 %
Tipo de API imp.video.api matriz de enteros Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son:
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2
95 %
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor.
Identificadores site.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador site.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Velocidad de bits mínima imp.video.minbitrate integer Especifica la velocidad de bits mínima, en kilobytes por segundo. Si se especifica, solo se devuelven creatividades que tengan al menos un archivo multimedia dentro del intervalo de bits adecuado. 95 %
Velocidad de bits máxima imp.video.maxbitrate integer Especifica la velocidad de bits máxima, en kilobytes por segundo. Si se especifica, solo se devuelven creatividades que tengan al menos un archivo multimedia dentro del intervalo de bits adecuado. 95 %
Playback (método) imp.video.playbackmethod matriz de enteros Especifica los métodos de reproducción permitidos. Si no se especifica, se supone que se permite todo. Los valores admitidos actualmente son:
- 1: Reproducción automática, sonido activado
- 2: Reproducción automática, sonido desactivado
- 3: haga clic para reproducir
- 4: pase el mouse sobre para reproducir
95 %
Duración mínima imp.video.minduration integer Especifica la duración máxima del anuncio de vídeo, en segundos. 95 %
Duración máxima imp.video.maxduration integer Especifica la duración máxima del anuncio de vídeo, en segundos. 95 %
Retraso de inicio imp.video.startdelay integer Especifica el retraso de inicio del vídeo:
- >0: para valores mayores que cero, el retraso antes del inicio del vídeo, en segundos.
- 0: pre-roll
- -1: mid-roll genérico
- -2: post-roll genérico
95 %
Protocolos imp.video.protocols matriz de enteros Matriz de protocolos de respuesta de puja de vídeo admitidos. 95 %
Dominio site.domain string Especifica el dominio del sitio (por ejemplo, publishersite.com) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión, si está disponible, o extraído del page campo. 95 %
Dominio site.page Especifica la dirección URL completa de la página donde se mostrará la impresión (por ejemplo, page.publishersite.com/path/to/page). Debe ser la dirección URL del referenciador y se prefiere sobre el domain campo. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, se establecerá el dispositivo make y devicetype se basará en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Los siguientes valores de campo en las solicitudes de puja deben ser coherentes internamente.

Criterios Campo OpenRTB requerido Description Umbral
VPAID1 imp.video.mimes
imp.video.api
Si la matriz imp.video.mimes contiene el valor "1" para VPAID1, la matriz imp.video.mimes debe contener el valor "application/x-shockwave-flash" o estar vacía, en cuyo caso se supone que se admiten todos los tipos mime. 95 %
VPAID2 imp.video.mimes
imp.video.api
Si la matriz imp.video.mimes contiene el valor "2" para VPAID2, la matriz imp.video.mimes debe contener el valor "application/x-shockwave-flash" o "application/javascript" o estar vacía, en cuyo caso se supone que se admiten todos los tipos mime. 95 %

Criterios de audio web

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Tipo mime imp.audio.mimes matriz de cadenas Especifica los tipos MIME de contenido de audio admitidos; por ejemplo, audio/vnd.wav, audio/mpeg, audio/mp4, audio/oggo audio/mp2.. 95 %
Tipo de API imp.audio.api matriz de enteros Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son:
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2
95 %
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor. 95 %
Identificadores site.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador site.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Velocidad de bits mínima imp.audio.minbitrate integer Velocidad mínima de bits, en kilobytes por segundo. 95 %
Velocidad de bits máxima imp.audio.maxbitrate integer Velocidad de bits máxima, en kilobytes por segundo. 95 %
Duración mínima imp.audio.maxduration integer Especifica la duración máxima del anuncio de audio, en segundos. 95 %
Duración máxima imp.audio.maxduration integer Especifica la duración máxima del anuncio de audio, en segundos. 95 %
Retraso de inicio imp.audio.startdelay integer Especifica el retraso de inicio del vídeo:
- >0: para valores mayores que cero, el retraso antes del inicio del vídeo, en segundos.
- 0: pre-roll
- -1: mid-roll genérico
- -2: post-roll genérico
95 %
Protocolos imp.audio.protocols matriz de enteros Matriz de protocolos de respuesta de puja de vídeo admitidos. 95 %
Dominio site.domain string Especifica el dominio del sitio (por ejemplo, publishersite.com) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión, si está disponible, o extraído del page campo. 95 %
Dominio site.page string Especifica la dirección URL completa de la página donde se mostrará la impresión (por ejemplo, page.publishersite.com/path/to/page). Debe ser la dirección URL del referenciador y se prefiere sobre el domain campo. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, se establecerá el dispositivo make y devicetype se basará en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Criterios nativos web

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor. 95 %
Identificadores site.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador site.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Dominio site.domain string Especifica el dominio del sitio (por ejemplo, publishersite.com) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión, si está disponible, o extraído del page campo. 95 %
Dominio site.page string Especifica la dirección URL completa de la página donde se mostrará la impresión (por ejemplo, page.publishersite.com/path/to/page). Debe ser la dirección URL del referenciador y se prefiere sobre el domain campo. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, Xandr establece el dispositivo make y devicetype se basa en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Versión native.ver string Versión de la versión de marcado nativo en uso.
Xandr admite actualmente las siguientes versiones nativas:
- 1.0
- 1.1
Nota: Obligatorio si se usa la versión 1.1. Si no se envía ninguna versión, el valor predeterminado será 1.0.
95 %
Solicitud native.request string Marcado creativo representado que se va a entregar; Las creatividades nativas se pueden devolver en este campo como una cadena codificada en JSON.
Ejemplo nativo 1.0:
"native": { "request": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3}}]}" }
Ejemplo nativo 1.1:
Nota: la diferencia principal de las dos versiones es la eliminación de "nativo" en el objeto de solicitud.
"native": { "request": "{\"ver\":\"1.1\",\"assets\":[{\"id\":3}}]}" }
95 %
Id. de recurso native.request.native.assets.id integer Id. de recurso único, asignado por exchange. Normalmente es un contador para la matriz. Cada objeto de recurso debe contener un identificador de recurso único. Use native.request.native.assets.id para la versión nativa 1.0 y use native.request.assets.id para la versión nativa 1.1. 95 %
Id. de recurso native.request.assets.id integer Id. de recurso único, asignado por exchange. Normalmente es un contador para la matriz. Cada objeto de recurso debe contener un identificador de recurso único. Use native.request.native.assets.id para la versión nativa 1.0 y use native.request.assets.id para la versión nativa 1.1. 95 %
Activo de título native.request.assets.title object El objeto Title se usará para el elemento title del anuncio nativo. 95 %

Criterios de banner de la aplicación

Atributo auction Campo OpenRTB Tipo Description Umbral
Height imp.banner.h integer Especifica el alto exacto del banner en píxeles. 95 %
Width imp.banner.w integer Especifica el ancho exacto del banner en píxeles. 95 %
Id. de dispositivo device.ifa string El "identificador de publicidad" es un id. de dispositivo no autorizado para el uso del anunciante. Este es el IDFA en iOS y el AAID en Android. 95 %
Identificadores app.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador app.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Dominio app.domain string Especifica el dominio de la aplicación (por ejemplo, mygame.publishersite.com) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión si está disponible. 95 %
Id. de paquete app.bundle string Especifica el paquete de aplicaciones o el nombre del paquete (por ejemplo, com.foo.mygame). Está pensado para ser un identificador único en varios intercambios. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, Xandr establece el dispositivo make y devicetype se basa en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del campo ua.
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Criterios de vídeo de la aplicación

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Height imp.video.h integer Especifica el alto del reproductor de vídeo, en píxeles. 95 %
Width imp.video.w integer Especifica el ancho del reproductor de vídeo, en píxeles. 95 %
Tipo mime imp.video.mimes matriz de cadenas Especifica los tipos MIME de contenido de vídeo admitidos; por ejemplo, video/x-ms-wmv y video/x-flv. Si no se especifica, se permite cualquier tipo MIME. 95 %
Tipo de API imp.video.api matriz de enteros Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son:
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2
95 %
Id. de dispositivo device.ifa string El "identificador de publicidad" es un id. de dispositivo no autorizado para el uso del anunciante. Este será el IDFA en iOS o AAID en Android. 95 %
Identificadores app.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador app.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Velocidad de bits mínima imp.video.minbitrate integer Especifica la velocidad de bits mínima, en kilobytes por segundo. Si se especifica, solo se devuelven creatividades que tengan al menos un archivo multimedia dentro del intervalo de bits adecuado. 95 %
Velocidad de bits máxima imp.video.maxbitrate integer Especifica la velocidad de bits máxima, en kilobytes por segundo. Si se especifica, solo se devuelven creatividades que tengan al menos un archivo multimedia dentro del intervalo de bits adecuado. 95 %
Playback (método) imp.video.playbackmethod matriz de enteros Especifica los métodos de reproducción permitidos. Si no se especifica, se supone que se permite todo. Los valores admitidos actualmente son:
- 1: Reproducción automática, sonido activado
- 2: Reproducción automática, sonido desactivado
- 3: haga clic para reproducir
- 4: pase el mouse sobre para reproducir
95 %
Duración máxima imp.video.maxduration integer Especifica la duración máxima del anuncio de vídeo, en segundos. 95 %
Retraso de inicio imp.video.startdelay integer Especifica el retraso de inicio del vídeo:
- >0: para valores mayores que cero, el retraso antes del inicio del vídeo, en segundos.
- 0: pre-roll
- -1: mid-roll genérico
- -2: post-roll genérico
95 %
Protocolos imp.video.protocols integer Matriz de protocolos de respuesta de puja de vídeo admitidos. 95 %
Dominio app.domain string Especifica el dominio de la aplicación (por ejemplo, mygame.publishersite.com ) donde se mostrará la impresión. Establezca como dominio de referencia en la impresión si está disponible. 95 %
Id. de paquete app.bundle string Especifica el paquete de aplicaciones o el nombre del paquete (por ejemplo, com.foo.mygame). Está pensado para ser un identificador único en varios intercambios. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, se establecerá el dispositivo make y devicetype se basará en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver las creaciones registradas en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Los siguientes valores de campo en las solicitudes de puja deben ser coherentes internamente.

Criterios Campo OpenRTB requerido Description Umbral
VPAID1 imp.video.mimes
imp.video.api
Si la matriz imp.video.mimes contiene el valor "1" para VPAID1, la matriz imp.video.mimes debe contener el valor "application/x-shockwave-flash" o estar vacía, en cuyo caso se supone que se admiten todos los tipos mime. 95 %
VPAID2 imp.video.mimes
imp.video.api
Si la matriz imp.video.mimes contiene el valor "2" para VPAID2, la matriz imp.video.mimes debe contener el valor "application/x-shockwave-flash" o "application/javascript" o estar vacía, en cuyo caso se supone que se admiten todos los tipos mime. 95 %

Criterios de audio de la aplicación

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Tipo mime imp.audio.mimes matriz de cadenas Especifica los tipos MIME de contenido de audio admitidos; por ejemplo, audio/vnd.wav, audio/mpeg, audio/mp4, audio/oggo audio/mp2.. 95 %
Tipo de API imp.audio.api matriz de enteros Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son:
- 1: VPAID 1.0
- 2: VPAID 2.0
- 3: MRAID-1
- 4: ORMMA
- 5: MRAID-2
95 %
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor. 95 %
Identificadores app.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador app.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Velocidad de bits mínima imp.audio.minbitrate integer Velocidad mínima de bits, en kilobytes por segundo. 95 %
Velocidad de bits máxima imp.audio.maxbitrate integer Velocidad de bits máxima, en kilobytes por segundo. 95 %
Duración máxima imp.audio.maxduration integer Especifica la duración máxima del anuncio de audio, en segundos. 95 %
Retraso de inicio imp.audio.startdelay integer Especifica el retraso de inicio del vídeo:
- >0: para valores mayores que cero, el retraso antes del inicio del vídeo, en segundos.
- 0: pre-roll
- -1: mid-roll genérico
- -2: post-roll genérico
95 %
Protocolos imp.audio.protocols matriz de enteros Matriz de protocolos de respuesta de puja de vídeo admitidos. 95 %
Id. de paquete app.bundle string Especifica el paquete de aplicaciones o el nombre del paquete (por ejemplo, com.foo.mygame). Está pensado para ser un identificador único en varios intercambios. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, se establecerá el dispositivo make y devicetype se basará en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %

Criterios nativos de la aplicación

Atributo auction Campo OpenRTB requerido Tipo Description Umbral
Id. de usuario user.buyeruid integer Identificador único de Xandr de este usuario. Si se establece, este valor sobrescribirá el customdata valor. 95 %
Identificadores app.id string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Identificadores imp.tagid string Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el código de selección de ubicación de Xandr. 95 %
Id. del publicador site.publisher.id string Especifica el identificador del publicador del vendedor, que se usa para buscar un identificador de publicador de Xandr. 95 %
Id. de paquete app.bundle string Especifica el paquete de aplicaciones o el nombre del paquete (por ejemplo, com.foo.mygame). Está pensado para ser un identificador único en varios intercambios. 95 %
Datos del dispositivo
device.model string Especifica el modelo del dispositivo. Si se pasa, Xandr establece el dispositivo make y devicetype se basa en el modelo y no en los campos pasados. Este valor invalidará el campo analizado si se ua pasa. Use device model service para ver los modelos registrados en el sistema Xandr. 95 %
Datos del dispositivo device.ua string Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". 95 %
Datos del dispositivo device.devicetype string Especifica el tipo de dispositivo mediante valores IAB:
- 1: Móvil/Tableta
- 2: Equipo personal
- 3: TV conectada
- 4:Teléfono
- 5:Tableta
- 6: dispositivo conectado
- 7: establecer el cuadro superior
Solo se usa si no se admite a través del ua campo .
95 %
Datos del dispositivo device.make string Especifica la make del dispositivo. Solo se usa si el modelo no se pasa, no es válido o no está disponible mediante el análisis del ua campo. Use device make service para ver las creaciones registradas en el sistema Xandr. 95 %
IP device.ip string Especifica la dirección IPv4 más cercana al dispositivo. Se omite cuando se envía a los compradores si la configuración de visibilidad del vendedor prohíbe el uso compartido. 95 %
Versión native.ver string Versión de la versión de marcado nativo en uso.
Xandr admite actualmente las siguientes versiones nativas:
- 1.0
- 1.1
Nota: Obligatorio si se usa la versión 1.1. Si no se envía ninguna versión, el valor predeterminado será 1.0.
95 %
Solicitud native.request string Marcado creativo representado que se va a entregar; Las creatividades nativas se pueden devolver en este campo como una cadena codificada en JSON.
Ejemplo nativo 1.0:
"native": "request": "{\"native\":{\"ver\":\"1.0\",\"assets\":[{\"id\":3}}]}" }
Ejemplo nativo 1.1:
Nota: la diferencia principal de las dos versiones es la eliminación de "nativo" en el objeto de solicitud.
"native": { "request": "{\"ver\":\"1.1\",\"assets\":[{\"id\":3}}]}" }
95 %
Id. de recurso native.request.native.assets.id integer Id. de recurso único, asignado por exchange. Normalmente es un contador para la matriz. Cada objeto de recurso debe contener un identificador de recurso único. Use native.request.native.assets.id para la versión nativa 1.0 y use native.request.assets.id para la versión nativa 1.1. 95 %
Id. de recurso native.request.assets.id integer Id. de recurso único, asignado por exchange. Normalmente es un contador para la matriz. Cada objeto de recurso debe contener un identificador de recurso único. Use native.request.native.assets.id para la versión nativa 1.0 y use native.request.assets.id para la versión nativa 1.1. 95 %
Activo de título native.request.assets.title object El objeto Title se usará para el elemento title del anuncio nativo. 95 %

Solicitudes de puja de ejemplo

Solicitud de banner web

{
    "site": {
        "publisher": {
            "id": "534561625"
        },
        "domain": "publishersite.com",
        "id": "537123178",
        "page": "https://page.publishersite.com/path/to/page"
    },
    "imp": [
        {
            "banner": {
                "h": 250,
                "w": 300
            },
            "id": "7bbab3f3-83db-4b00-a82d-faa69fcbb5c5"
        }
    ],
    "device": {
        "os": "Windows",
        "make": "desktop",
        "dnt": 0,
        "ua": "Mozilla/5.0 (Windows NT 6.0; rv:50.0) Gecko/20100101 Firefox/50.0",
        "devicetype": 2,
        "model": "browser",
        "user": {
            "buyeruid": "8320715123477372344"
        },
        "id": "7bbab3f3-83db-4b00-a82d-faa69fcbb5c5"
    }
}

Solicitudes de banner de aplicación

{
    "app": {
        "publisher": {
            "id": "537133097"
        },
        "bundle": "com.publisher.app",
                "domain": "publisher.com",
                "id": "537252150"
    },
    "imp": [
        {
            "banner": {
                "h": 250,
                "w": 300
            },
            "id": "a4d94cdc-3999-4708-9a6d-6ac01f6c07d4"
        }
    ],
    "device": {
        "os": "Android",
        "language": "en",
        "make": "generic",
        "dnt": 0,
        "ua": "Mozilla/5.0 (Linux; Android 4.4.2; GT-I9301I Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/30.0.0.0 Mobile Safari/537.36",
        "devicetype": 4,
        "ifa": "ffab2dd1-c6eb-4be9-b88b-1c24e431766d",
        "ip": "5.90.222.251",
        "model": "android phone"
    },
    "id": "a4d94cdc-3999-4708-9a6d-6ac01f6c07d4"
}

Solicitudes de vídeo web

 {
    "site": {
        "publisher": {
            "id": "74964"
        },
        "domain": "publishersite.com",
        "id": "123456",
        "page": "page.publishersite.com/path"
    },
    "imp": [
        {
            "video": {
                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash"
                ],
                "api": [
                    1
                ],
                                "minbitrate": 1,
                                "maxbitrate": 2000,
                                "playbackmethod": [2],
                                "maxduration": 30,
                                "startdelay":0,
                                "protocols": [2, 5],
                "h": 360,
                "w": 480
            },
            "id": "1"
        }
    ],
    "device": {
        "language": "en",
        "os": "Windows 10",
        "make": "Google",
        "devicetype": 2,
        "ip": "24.171.153.60",
        "model": "Chrome - Windows",
        "ua": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.99 Safari/537.36"
    },
    "id": "32683827af9b11e6b43212a6e39f0001",
    "user": {
        "buyeruid": "6415517486677292084"
    }
}

Solicitudes de vídeo de aplicación

 {
    "app": {
        "publisher": {
            "id": "1100001685"
        },
        "bundle": "com.publisher.app",
        "domain": "publishersite.com",
        "id": "123456",
        "page": "page.publishersite.com/path"
    },
    "imp": [
        {
            "tagid": "130200094",
            "video": {
                                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash"
                ],
                "api": [
                    1
                ],
                                "minbitrate": 1,
                                "maxbitrate": 2000,
                                "playbackmethod": [2],
                                "maxduration": 30,
                                "startdelay":0,
                                "protocols": [2, 5],
                "h": 480,
                "w": 320
            }
        }
    ],
    "device": {
        "os": "Android",
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-N920V Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/54.0.2840.85 Mobile Safari/537.36",
        "make": "Samsung",
        "devicetype": 1,
        "ifa": "C8A53AB8-D371-4955-BFDA-7805FA931E44",
        "model": "SM-N920V"
    },
    "id": "Nr4EZZiP5z"
}