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 superiorSolo 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 superiorSolo 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/ogg o 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 superiorSolo 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 superiorSolo 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 superiorSolo 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 superiorSolo 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/ogg o 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 superiorSolo 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 superiorSolo 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"
}