Especificación de OpenRTB de DV360

Ten a mano la Especificación de OpenRTB 2.6 mientras consultas esta página.

Display & Video 360 no admite todos los campos de la especificación de OpenRTB, y se pueden aplicar matices. Las secciones de este documento contienen información y recomendaciones específicas para la implementación de Display & Video 360. También debes seguir los lineamientos que se presentan en la especificación de OpenRTB, a menos que se indique lo contrario.

Algunos campos no se admiten, pero se analizan de todos modos. Estos campos deben tener el formato correcto, pero no afectarán el resultado de la oferta.

Especificación de la solicitud de oferta

Una solicitud de oferta es una solicitud HTTP POST con un cuerpo de un objeto de solicitud de oferta. El formato del cuerpo se define en el encabezado Content-Type.

La respuesta correspondiente es un HTTP 204 sin cuerpo para una respuesta sin oferta o un HTTP 200 con un cuerpo de una respuesta de oferta.

Si una solicitud de oferta está mal formada, se puede devolver un código HTTP 200 con el cuerpo de una respuesta de oferta con el campo nbr completado.

El formato de respuesta se controla con el encabezado Accept.

Formato JSON

El formato predeterminado se usa cuando no se proporciona ningún tipo de MIME aceptado.

Las solicitudes y respuestas JSON siguen la especificación de OpenRTB 2.6 de IAB. En la siguiente documentación, se describen las extensiones y la compatibilidad con los campos.

El encabezado Content-Type: application/json indica una solicitud de oferta en formato JSON; Accept: application/json indica que las respuestas de oferta deben estar en formato JSON.

Formato de Protobuf

NOTA: La compatibilidad con Protobuf está en versión beta. Si te interesa, comunícate con DV360.

Las solicitudes y respuestas de JSON siguen la especificación de Protobuf de OpenRTB 2.6 de IAB.

Las extensiones tienen asistencia limitada. Comunícate con DV360 si te interesan.

Envía el encabezado Content-Type: application/x-protobuf para indicar una solicitud de oferta de Protobuf y establece Accept: application/x-protobuf para recibir respuestas de oferta de Protobuf.

Objeto de solicitud de oferta

Campo Tipo Detalles
id String Obligatorio.
ID único de la solicitud de oferta. Se puede usar para identificar solicitudes individuales durante un tiempo muy limitado después de que se entregan.
imp Es un array de impresiones. Se requiere al menos 1 objeto imp.

En el caso de los podcasts de audio, se admite más de un objeto imp.
Para otros casos de uso (p.ej., varios espacios independientes en la página), se usa el primer objeto imp y se descartan los demás.
site Sitio Se requiere para las solicitudes de sitios web.
site y app son mutuamente excluyentes.
app Aplicaciones Se requiere para las solicitudes de apps.
app y site son mutuamente excluyentes.
device Dispositivo Obligatorio.
user Usuario Obligatorio.
test Número entero No es compatible.
at Número entero 1: Subasta de primer precio en la que se le cobra al anunciante el importe de su oferta.
2 (predeterminado): Subasta de segundo precio en la que se le cobra al anunciante un importe ligeramente superior al del segundo ofertante con la oferta más alta.
3: El precio mínimo está en la solicitud y no tiene relación con las ofertas de la competencia.
tmax Número entero Es opcional y el valor predeterminado es personalizado por integración.
wseat Matriz de string Es la lista de licencias de comprador permitidas.
Se recomienda, a menos que se permita que todos los anunciantes realicen ofertas.
Sin establecer implica que no hay restricciones.
bseat Matriz de string Es la lista de posiciones de compradores cuyas ofertas se deben bloquear. Se bloqueará la participación de los compradores incluidos en la lista en las ofertas de acuerdos y subastas abiertas.
allimps Número entero No es compatible.
cur Matriz de string

Es opcional, pero se recomienda. El valor predeterminado es por integración.

La moneda de la solicitud de oferta debe coincidir con una de las monedas registradas durante la integración.

Se recomienda admitir una sola moneda por intercambio.
wlang Matriz de string No es compatible.
bcat Matriz de string Se bloquearon las categorías de anunciantes con las categorías de contenido de IAB.
Sin establecer significa que no hay categorías bloqueadas.
badv Matriz de string Especifica el anunciante bloqueado según el dominio que proporcionó el anunciante.
Si no se establece, no se bloquea a ningún anunciante.
bapp Matriz de string No es compatible.
source Origen Se requiere parcialmente para schain.
regs Regs Opcional.
ext Extensiones de solicitud de oferta Opcional.

Objeto de extensiones de solicitudes de oferta

Campo Tipo Detalles
schain Cadena de suministro Las integraciones nuevas deben usar el campo BidRequest.source.schain en Source.
purch Número entero El parámetro Tráfico comprado es el tráfico que se redirecciona desde propiedades que no son propias, no son adquiridas ni es actividad incentivada de alguna otra manera.
Esto se basa en la nueva especificación de IVT 2.0 del MRC.

En los informes para compradores, se llamará Fuente de tráfico del publicador y tendrá uno de los siguientes valores :
0 (predeterminado): Sin definir. No se envía el valor en las solicitudes de oferta. No se puede captar el valor;
1: Comprado: Tráfico redirigido desde propiedades que no son propias (adquiridas, o bien alguna otra actividad incentivada).
2: Orgánico: Entrada de URL directa, búsqueda en el sitio o descarga de la aplicación.

gdemsignals String Es un blob de indicador de la API de SCAR del SDK de GMA.
Se recomienda si hay tráfico del SDK de GMA; de lo contrario, se prohíbe.
disable_gma_format int Es opcional si se proporciona gdemsignals; de lo contrario, se prohíbe.
0 (predeterminado): Cuando se completa gdemsignals, el objeto adm de la respuesta a la oferta es un blob json.
1: También se proporcionará una etiqueta de anuncio en lugar del BLOB de JSON.

Objeto de origen

Campo Tipo Detalles
fd Número entero Entidad responsable de la decisión final de venta de la impresión
0 (predeterminado): El intercambio toma la decisión.
1: Una fuente upstream decide.
tid String No es compatible.
pchain String No es compatible.
schain Cadena de suministro Es obligatorio en casi todos los casos.

Se prefiere este campo a proporcionar schain a través de las extensiones de solicitud de oferta o las extensiones de fuente.

ext Extensiones de fuente Opcional.

Objeto de extensiones de fuente

Se recomienda mucho esta extensión, ya que afecta la forma en que se registran las mediciones de visibilidad en DV3 para el cliente. Si el nombre del socio de OMID NO aparece en la lista de certificación de IAB, el MRC nos exige que informemos las métricas de visibilidad por separado de las métricas certificadas por el MRC. Más información.

Campo Tipo Detalles
omidpn String Es el identificador de la integración del SDK de OM. Es el mismo que el parámetro "name" del objeto OMID Partner.
omidpv String Es la versión de la integración del SDK de OM. Es igual al parámetro "versionString" del objeto OMID Partner.
schain Cadena de suministro Las integraciones nuevas deben usar el campo schain en Source.

Objeto Regs

Campo Tipo Detalles
coppa Número entero 0 (predeterminado): La COPPA no se aplica a esta solicitud.
1: Esta solicitud está sujeta a la COPPA.
ext Extensiones de Regs Opcional.

Objeto de extensiones de regs

Campo Tipo Detalles
gdpr Número entero Indica si la solicitud de oferta proviene de la región del EEE.
0 (predeterminado): Región fuera del EEE.
1: Región del EEE,
Consulta la Solución de proveedor con consentimiento para el RGPD para obtener más detalles.
us_privacy String Sigue la especificación técnica proporcionada por IAB Tech Lab para implementar la cadena us_privacy.

Cuando recibimos la cadena us_privacy en la solicitud de oferta y cuando la cadena de IAB indica que un usuario no inhabilitó la función, Display & Video 360 realizará una oferta para esas solicitudes. No propagaremos el indicador de IAB a otros proveedores. Si la cadena de IAB indica que un usuario inhabilitó la función, Google no realizará una oferta para esas solicitudes.

Objeto Imp

Campo Tipo Detalles
id String Es un identificador único para esta impresión dentro del contexto de la solicitud de oferta (por lo general, el valor comienza con 1 y aumenta hasta n para n impresiones).
metric Objeto No es compatible.
banner Banner Es obligatorio para las oportunidades de anuncios de banner.
video Video Se requiere para las oportunidades de anuncios de video.
audio Audio Se requiere para las oportunidades de anuncios de audio.
native Nativo Es obligatorio para las oportunidades de anuncios nativos.
pmp Pmp Son los acuerdos de mercado privado vigentes para esta impresión.
displaymanager String Nombre del socio de mediación de anuncios, la tecnología del SDK o el reproductor responsable de renderizar el anuncio (por lo general, de video o para dispositivos móviles). Algunos servidores de anuncios lo utilizan para personalizar el código de anuncios según el socio. Se recomienda para videos o apps.
displaymanagerver String Versión del socio de mediación de anuncios, la tecnología del SDK o el reproductor responsable de renderizar el anuncio (por lo general, video o dispositivo móvil). Algunos servidores de anuncios lo utilizan para personalizar el código de anuncios según el socio. Se recomienda para videos o apps.
instl Número entero 0 (predeterminado): No es intersticial.
1: El anuncio es intersticial o de pantalla completa.
tagid String Es el identificador de la posición del anuncio o la etiqueta del anuncio específicos que se usaron para iniciar la subasta. Esto puede ser útil para depurar cualquier problema o para la optimización por parte del comprador.
bidfloor Número de punto flotante Es la oferta mínima para esta impresión, expresada en CPM.
bidfloorcur String

Moneda especificada con códigos alfa ISO-4217.

clickbrowser Número entero

Indica el tipo de navegador que se abre cuando se hace clic en la creatividad en una app.
0 (predeterminado): integrado
1: nativo

Ten en cuenta que el Safari View Controller en dispositivos iOS 9.x se considera un navegador nativo a los efectos de este campo.

secure Número entero Indica si esta impresión requiere una URL HTTPS segura o una URL HTTP no segura.
0 (predeterminado):insecure
1: secure
iframebuster Matriz de string
exp Número entero DV360 establece el vencimiento de la oferta sin tener en cuenta el valor que envía un socio en este campo. Los eventos de impresión que se reciben después del período de obsolescencia de la impresión (generalmente, 1 hora) se descartan como obsoletos y DV360 no los considera facturables.
rwdd Número entero Indica si el usuario recibe una recompensa por ver el anuncio.
0 (predeterminado): No se otorga recompensa
1: Se otorga recompensa

Por lo general, las implementaciones de anuncios de video permiten que los usuarios lean un artículo de noticias adicional de forma gratuita, reciban una vida extra en un juego o disfruten de una sesión de música patrocinada sin anuncios. Por lo general, la recompensa se distribuye después de que finaliza el anuncio de video.

Objeto de extensión de impresión

Campo Tipo Detalles
bcrid String Es la lista de IDs de creatividades que se deben bloquear.
Campo Tipo Detalles
format Es un array de formato. Es una lista de formatos compatibles.
w Número entero

h y w se combinan en el campo format.

Se recomienda usar format en su lugar.
h Número entero

h y w se combinan en el campo format.

Se recomienda usar format en su lugar.
wmax Número entero No es compatible.
hmax Número entero No es compatible.
wmin Número entero No es compatible.
hmin Número entero No es compatible.
btype Array de números enteros A continuación, se incluye una lista de los tipos de anuncios de banner incluidos en la lista de entidades bloqueadas:

1: Anuncios de texto en HTML
2: Anuncios de banner en HTML
3: Anuncios de JavaScript
4: Anuncios de IFrame

battr Array de números enteros Se admiten los siguientes valores:

1: Reproducción automática de audio
2: Audio iniciado por el usuario
3: Automático expandible
4: Expandible iniciado por clic
5: Expandible iniciado por desplazamiento
6: Reproducción automática de video en banner
7: Video en banner iniciado por el usuario
8: Ventana emergente(superpuesta, inferior o de salida)
9: Provocativo o sugerente
10: "Molesto", p. ej., tembloroso, parpadeante, parpadeante, animación extrema, emoticonos
11: Encuestas
12: Solo texto
13: Interactivo para el usuario (juegos)
14: Estilo de alerta o diálogo de Windows
15: Tiene botón de activación o desactivación de audio
16: Se puede omitir el anuncio
17: Flash

pos Número entero Posición del anuncio:

0 (predeterminado): Desconocido
1: Sobre el pliegue
2: No compatible: Probablemente debajo del pliegue
3: Debajo del pliegue
4: Encabezado
5: Pie de página
6: Barra lateral
7: Pantalla completa
mimes Matriz de string No es compatible.

DV360 usará text/html para todas las creatividades de banner.

topframe Número entero 0 (predeterminado): El banner se publica en un iframe.
1: No compatible: El banner se publica en el fotograma superior.
expdir Array de números enteros 1: Izquierda
2: Derecha
3: Arriba
4: Abajo
5: Pantalla completa expandible
api Array de números enteros Marcos de trabajo de API admitidos

1: Izquierda
2: Derecha
3: Arriba
4: Abajo
5: Pantalla completa expandible

id String Es un identificador del objeto de banner y debe ser único en la impresión.

Se recomienda cuando se usan objetos banner con un objeto de video.

vcm Número entero

Solo es pertinente para un objeto banner que se usa con un objeto de video.

0: El banner se muestra de forma simultánea con la creatividad de video.
1: El banner es una tarjeta final que aparece después del video.

Objeto de formato

Campo Tipo Detalles
w Número entero Ancho en píxeles independientes del dispositivo (DIP).
h Número entero Altura en píxeles independientes del dispositivo (DIP).
wratio Número entero No es compatible.
hratio Número entero No es compatible.
wmin Número entero No es compatible.

Objeto de video

Te recomendamos que especifiques la posición del video en la solicitud de oferta. Si falta un campo de posición, se clasifica como una posición desconocida. Consulta el artículo sobre la segmentación por posición para obtener más detalles.

Campo Tipo Detalles
mimes Matriz de string Se requiere al menos un tipo de MIME.

video/flv o video/x-f4v
video/mp4, video/x-mp4 o application/mp4
video/webm o video/x-webm
video/x-ms-wmv
video/3gpp
video/ogg o application/ogg
application/javascript o application/x-javascript

minduration Número entero Es la duración mínima del video en segundos. El valor predeterminado es que no hay un mínimo.
maxduration Número entero Es la duración máxima de un video en segundos. El valor predeterminado es sin máximo.
protocols Array de números enteros Se requiere al menos un protocolo compatible.

1: VAST 1.0
2: VAST 2.0
3: VAST 3.0
4: Wrapper de VAST 1.0
5: Wrapper de VAST 2.0
6: Wrapper de VAST 3.0
7: VAST 4.0
8: Wrapper de VAST 4.0
9: DAAST 1.0
10: Wrapper de DAAST 1.0

w Número entero Ancho del reproductor de video en píxeles independientes del dispositivo (DIP).
h Número entero Altura del reproductor de video en píxeles independientes del dispositivo (DIP).
startdelay Número entero Es la demora en segundos para las posiciones de anuncios previos al video, durante el video o al final del video.
placement Número entero Se recomienda especificar el plcmt (o) la posición del video en la solicitud de oferta. Si faltan ambos campos, se clasificará como una posición desconocida.

0 (predeterminado): Desconocido
1: En el video
2: En el banner
3: En el artículo
4: En el feed
5: Flotante

Nota: Para que se consideren in-stream (posición o tipo de posición 1), las posiciones o impresiones de video deben configurarse como “con sonido” y deben indicarse correctamente en el método de reproducción (todos los valores 1, 3, 4 y 5 son válidos).
plcmt Número entero Se recomienda especificar el plcmt (o) la posición del video en la solicitud de oferta. Si faltan ambos campos, se clasificará como una posición desconocida.

0 (predeterminado): Desconocido
1: In-stream
2: Contenido complementario
3: Intersticial
4: Sin contenido/Independiente

Nota: Para que se consideren in-stream (posición o tipo de posición 1), las posiciones o impresiones de video deben configurarse como “con sonido” y deben indicarse correctamente en el método de reproducción (todos los valores 1, 3, 4 y 5 son válidos).

Nota: Si se proporcionan plcmt y placement, plcmt tendrá prioridad. Consulta la Guía de IAB sobre la migración a plcmt.

Nota: plcmt: Accompanying Content (2) se considera placement: In Article (3)
plcmt: No Content/Standalone (4) se considera placement: In feed (4)
placement: In Banner no tiene asignación en plcmt
linearity Número entero No es compatible.
skip Número entero Indica si el reproductor de video permitirá omitir el anuncio.

0 (predeterminado): No se puede omitir
1: Se puede omitir
skipmin Número entero No es compatible.
skipafter Número entero No es compatible.
sequence Número entero Si se ofrecen varias impresiones de anuncios en la misma solicitud de oferta, el número de secuencia permitirá la publicación coordinada de varias creatividades.
battr Array de números enteros Son los atributos de creatividad bloqueados.
maxextended Número entero Es la duración máxima del anuncio de video expandido, si se permite la extensión.

0 (predeterminado): No se permite la extensión.
-1: Se permite la extensión y no se impone ningún límite de tiempo.
>0: Es la cantidad de segundos de reproducción extendida admitida más allá del valor de maxduration.

minbitrate Número entero Es la tasa de bits mínima en Kbps.
maxbitrate Número entero Es la tasa de bits máxima en Kbps.
boxingallowed Número entero Indica si se permite el letterboxing del contenido en 4:3 en una ventana de 16:9.

0: No permitido
1 (predeterminado): Permitido
playbackmethod Array de números enteros Son los métodos de reproducción que se pueden usar. Si no se especifica ninguno, se puede usar cualquier método.

0 (predeterminado): Desconocido
1: Reproducción automática con sonido
2: Reproducción automática sin sonido
3: Haz clic para reproducir
4: Al pasar el mouse
5: Se inicia al ingresar al viewport, con sonido
6: Se inicia al ingresar al viewport, sin sonido

Nota: Todas las impresiones con el sonido desactivado de forma predeterminada (método de reproducción 2, 6 o 0) deben indicar una posición fuera del flujo de tipo 2, 3, 4 o 5 (oRTB 2.5) o un subtipo de posición 2, 3 o 4.
playbackend Número entero Es el evento que provoca que finalice la reproducción.

1: Se completó el video o el usuario lo detuvo
2: Se salió del viewport o el usuario lo detuvo
3: Cuando se sale del viewport, continúa como una ventana flotante hasta que se completa o el usuario lo detiene
delivery Array de números enteros Son los métodos de publicación admitidos. Si no se especifica ninguno, se supone que todos son compatibles.

1: Transmisión
2: Progresiva
pos Número entero Es la posición del anuncio en la pantalla.

0 (predeterminado): Desconocido
1: Sobre el pliegue
2: No compatible: Probablemente debajo del pliegue
3: Debajo del pliegue
4: Encabezado
5: Pie de página
6: Barra lateral
7: Pantalla completa
companionad Array de banners Anuncios complementarios, si están disponibles
api Array de números enteros

0 (predeterminado): Desconocido
1: VPAID 1
2: VPAID 2
3: MRAID 1
4: ORMMA
5: MRAID 2
6: MRAID 3
7: OMID 1: Se requiere para habilitar la medición con OMID para Active View.
8: SIMID 1
companiontype Array de números enteros No es compatible.
maxseq Número entero Es la cantidad máxima de anuncios que se devolverán en un grupo de anuncios de video dinámico.
poddur Array de números enteros Es la duración máxima de un grupo de anuncios de video dinámico en segundos.

Extensión admitida para el objeto de video

Campo Tipo Detalles
rewarded Número entero Este campo indica si las solicitudes son recompensadas o no. Se debe enviar como un número entero.

0 (predeterminado): No se otorga recompensa
1: Se otorga recompensa

Objeto de audio

Campo Tipo Detalles
mimes Matriz de string Se requiere al menos un tipo de MIME.

audio/m4a, audio/mp4 o audio/x-m4a
audio/mpeg o audio/mp3
audio/ogg o audio/x-ogg

minduration Número entero Es la duración mínima del anuncio en segundos.
maxduration Número entero Es la duración máxima del anuncio en segundos.
protocols Array de números enteros

3: VAST 3.0
6: Wrapper de VAST 3.0
7: VAST 4.0
8: Wrapper de VAST 4.0
startdelay Número entero Es la demora de inicio en segundos para las posiciones de anuncios previos al video, durante el video o al final del video.

-2: Anuncio al final del video
-1: Anuncio durante el video
0: Anuncio previo al video
>0: Anuncio durante el video

sequence Número entero No es compatible.
battr Array de números enteros No es compatible.
maxextended Número entero No es compatible.
minbitrate Número entero Es la tasa de bits mínima en Kbps.
maxbitrate Número entero Es la tasa de bits máxima en Kbps.
delivery Array de números enteros No es compatible.
companionad Es un array de objetos Banner. Son los espacios para creatividades complementarias de banner.
api Array de números enteros Es la lista de frameworks de API compatibles con esta impresión.

7: Omid V1

companiontype Array de números enteros No es compatible.
maxseq Array de números enteros No es compatible.
feed Número entero Es el tipo de feed de audio.

1: Servicio de música
2: Transmisión
3: Podcast

stitched Número entero No es compatible.
nvol Número entero No es compatible.

Objeto nativo

Consulta las especificaciones de los anuncios nativos de DV360 para obtener más detalles.

Campo Tipo Detalles
request String Objeto JSON nativo codificado como cadena.
ver String 1.0: No compatible
1.1: No compatible
1.2
api Array de números enteros Es la lista de frameworks de API compatibles con esta impresión.

7: Omid V1

battr Array de números enteros No es compatible.

Objeto de PMP

Campo Tipo Detalles
private_auction Número entero 0 (predeterminado): Se permiten todas las ofertas
1: Solo ofertas
deals Es un array de objetos Deal. Son las ofertas que se incluirán.

Objeto Deal

Campo Tipo Detalles
id String El objeto de PMP no puede contener más de un objeto de acuerdo por ID.
bidfloor Doble Es la oferta mínima para esta impresión en CPM.

Obligatorio si at=3.

bidfloorcur String Moneda especificada con códigos alfa ISO-4217.

Si no se especifica, se usa la moneda de la solicitud de oferta de forma predeterminada.

at Número entero Si no se especifica, el valor predeterminado coincide con bid_request.at.

1: Primer precio
2: Segundo precio
3: Precio fijo

wseat Matriz de string Son los IDs de los socios aptos para el acuerdo.

Si no se especifican asientos, no se aplican restricciones.

wadomain Matriz de string Son los dominios de los anunciantes que pueden ofertar en este acuerdo.

La ausencia de asientos implica que no hay restricciones de dominio.

guar Número entero Este campo se usa para indicar si el acuerdo es garantizado. Se debe enviar como un número entero.

El intercambio debe estar en la lista de entidades permitidas para que DV360 acepte acuerdos garantizados; comunícate para solicitarlo.

Si tu intercambio actualmente usa un mecanismo diferente para indicar acuerdos garantizados con DV360, comunícate con nosotros para analizar la posibilidad de cambiar a esta extensión preferida.

0 (predeterminado): No garantizada
1: Garantizada

ext Extensiones de ofertas Opcional.

Extensión admitida para el objeto de oferta

Campo Tipo Detalles
guaranteed Número entero Este campo se usa para indicar si el acuerdo es garantizado. Se debe enviar como un número entero.

El intercambio debe estar en la lista de entidades permitidas para que DV360 acepte acuerdos garantizados; comunícate para solicitarlo.

Si tu intercambio actualmente usa un mecanismo diferente para indicar acuerdos garantizados con DV360, comunícate con nosotros para analizar la posibilidad de cambiar a esta extensión preferida.

0 (predeterminado): No garantizada
1: Garantizada

Se recomienda usar deal.guar en lugar de este campo.

Objeto Site

Campo Tipo Detalles
id String Es el ID del sitio en el intercambio.
name String No es compatible.
domain String Es el dominio del sitio.

Se recomienda enviar una URL completa en site.page en lugar de solo completar site.domain.

cat Matriz de string No es compatible.
sectioncat Matriz de string No es compatible.
pagecat Matriz de string No es compatible.
page String Es la URL completa en la que se mostrará la impresión.

Se recomienda enviar la URL completa para fines de segmentación.

ref String Es la URL de referencia que provocó la navegación a la página actual.
search String No es compatible.
mobile Número entero No es compatible.
privacypolicy Número entero No es compatible.
publisher Objeto Publisher Son los detalles sobre el editor del sitio.
content Objeto de contenido Son los detalles sobre el contenido de un sitio.
keywords Cadena (formato CSV) No es compatible.
ext Extensiones de sitio Son las extensiones del objeto site.

Objeto de extensión de sitio

Campo Tipo Detalles
inventorypartnerdomain String Se usa para el uso compartido del inventario de CTV. Consulta la explicación sobre la adición de la app de CTV de IAB.

Objeto de la app

Campo Tipo Detalles
id String Es el ID de la aplicación en el intercambio.
name String Nombres de las aplicaciones, que pueden tener alias a solicitud de los publicadores

El publicador puede proporcionar directamente en la solicitud los nombres de las apps para las solicitudes sin SDK (principalmente, TVs conectadas).

bundle String Obligatorio.

En el caso de iOS, debe ser el ID numérico de la tienda de aplicaciones. No aceptamos el ID de paquete de estilo de DNS inverso.

En el caso de las apps para CTV, recomendamos pasar el identificador de la app definido por la tienda. Cumple con los lineamientos sobre el ID asignado por la tienda de OTT/CTV del IAB que se publicaron recientemente.

domain String El dominio, por ejemplo, mygame.foo.com
storeurl String Se requiere para la verificación de app-ads.txt y la validación de la tienda de aplicaciones para TVs conectadas.
cat Matriz de string No es compatible.
sectioncat Matriz de string No es compatible.
pagecat Matriz de string No es compatible.
ver String No es compatible.
privacypolicy Número entero No es compatible.
paid Número entero No es compatible.
publisher Objeto Publisher Es la información sobre el publicador de la app.
content Objeto de contenido Es la información sobre el contenido de la app.
keywords Cadena (formato CSV) No es compatible.
ext Extensiones de aplicación Son extensiones para el objeto de la app.

Objeto de extensión de aplicación

Campo Tipo Detalles
inventorypartnerdomain String Se usa para el uso compartido del inventario de CTV. Consulta la explicación sobre la adición de la app de CTV de IAB.

Objeto de contenido

Te recomendamos que pases estos atributos cuando estén disponibles.

Campo Tipo Detalles
id String Es un ID que identifica el contenido de forma única.
episode Número entero Número de episodio del contenido (normalmente para contenido de video).
title String Se recomienda para las solicitudes de CTV, audio y video.
series String Se recomienda para las solicitudes de CTV, audio y video.
season String Es una etiqueta para la temporada del contenido.
artist String Es el artista al que se le atribuye el contenido.
genre String Es el género que mejor describe el contenido. DV360 recomienda proporcionar este indicador para las solicitudes de CTV, audio y video.
DV360 admite algunas taxonomías de valores de género de video para este campo:
  • Lista de géneros de Google (Descargar)
  • Categorías de IAB para TV, películas y deportes (Descargar)
  • Taxonomía de géneros de video de Gracenote de Nielsen
album String Es el álbum al que pertenece el contenido, generalmente para audio.
isrc String Código de grabación estándar internacional que cumple con la norma ISO-3901.
producer Objeto Producer Son los detalles sobre el productor de contenido.
url String Es la URL del contenido.
cat Matriz de string Son las categorías de contenido de IAB que describen el contenido.
prodq Número entero Calidad de producción:

0 (predeterminado): Desconocido
1: Profesional
2: Prosumer
3: Generado por el usuario

videoquality Número entero No es compatible.
context Número entero Tipo de contenido:

1: Video
2: Juego
3: Música
4: Aplicación
5: Texto
6: Otro
7: Desconocido

contentrating String Se recomienda para Audio y video/CTV, ya que comenzaremos a tomar decisiones en función de este atributo.
userrating String Cantidad de estrellas, Me gusta, etc.
qagmediarating Número entero Calificación de medios según los [lineamientos de QAG](http://www.iab.net/ne_guidelines).

1: Todos los públicos
2: Mayores de 12 años
3: Contenido para mayores

keywords Cadena (formato CSV) No es compatible.
livestream Número entero Indica si el contenido es de transmisión en vivo.

0: No está en vivo
1: El contenido está en vivo

sourcerelationship Número entero

0: Indirecta
1: Directa

len Número entero Es la duración del contenido en segundos.

Se recomienda para las solicitudes de CTV, audio y video.

language Cadena (ISO-639-1-alpha-2) Es el idioma del contenido.
embeddable Número entero Indicador que señala si el contenido se puede incorporar o no (p.ej., un reproductor de video incorporable)

0: No se puede incorporar
1: Se puede incorporar

data Es un array de objetos de datos. Son datos adicionales.

Objeto Producer

Campo Tipo Detalles
id String No es compatible.
name String No es compatible.
cat Matriz de string No es compatible.
domain String Es el dominio de nivel superior del productor.

Objeto de datos

Campo Tipo Detalles
id String Es el ID del proveedor de datos.
name String Es el nombre del intercambio para el proveedor de datos.
segment Es un array de objetos Segment. Son los valores de datos reales.
ext Extensiones de datos Son extensiones para el objeto Data.

Extensiones admitidas para el objeto de datos

Campo Tipo Detalles
segtax Número entero Es el ID de la taxonomía. Consulta Taxonomías de segmentos para obtener más detalles.
segclass String Es la versión del clasificador que produjo los IDs de segmento dentro de la taxonomía.

Objeto Segment

Campo Tipo Detalles
id String Es un ID del segmento de datos específico del proveedor de datos.
name String Es el nombre del segmento de datos.
value String Es el valor del segmento de datos.

Objeto Publisher

Campo Tipo Detalles
id String Obligatorio.
name String No es compatible.
cat Matriz de string No es compatible.
domain String No es compatible.

Objeto Device

Campo Tipo Detalles
ua String Obligatorio.
sua Objeto UserAgent Es información estructurada del usuario-agente.
geo Objeto Geo Es la ubicación del dispositivo.
dnt Número entero Es la marca de No hacer seguimiento establecida en el encabezado del navegador.

0: El seguimiento no está restringido
1: No realizar seguimiento

lmt Número entero Es el indicador de Limitar el seguimiento de anuncios que se respalda comercialmente.

0: El seguimiento no está restringido
1: El seguimiento debe limitarse según los lineamientos comerciales

ip String Obligatorio si es IPv4.

Si la dirección IP está truncada, se debe declarar en device.ext.truncated_ip.

ipv6 String Obligatorio si es IPv6.

Si la dirección IP está truncada, se debe declarar en device.ext.truncated_ip.

devicetype Número entero Se recomienda para todos los tipos de inventario. Se usa para mejorar el reconocimiento del tipo de dispositivo.
make String
model String
os String El sistema operativo del dispositivo

ios: En una solicitud de App, identifica el tráfico de iOS.
android: Identifica un dispositivo Android si ua o sua no lo identifican.
[anything else]: Se usa en el diagnóstico para aislar problemas.

Este campo no distingue mayúsculas de minúsculas.

osv String No es compatible.
hwv String Es la versión de hardware del dispositivo.
h Número entero Altura física de la pantalla en píxeles.
w Número entero Ancho físico de la pantalla en píxeles.
ppi Número entero No es compatible.
pxratio Doble Es la proporción de píxeles físicos con respecto a los píxeles independientes del dispositivo.
js Número entero No es compatible.
geofetch Número entero No es compatible.
flashver String No es compatible.
language Cadena (ISO-639-1-alpha-2) Idioma del dispositivo.
carrier String No es compatible.
mccmnc String No es compatible.
connectiontype Número entero Tipo de conexión de red
ifa String Es el ID autorizado para que el anunciante lo use de forma explícita.
didsha1 String No es compatible.
didmd5 String No es compatible.
dpidsha1 String No es compatible.
dpidmd5 String No es compatible.
macsha1 String No es compatible.
macmd5 String No es compatible.
ext Extensiones de dispositivos Son extensiones para el objeto del dispositivo.

Extensión admitida para el objeto del dispositivo

Si se cambia o trunca ip, te recomendamos que envíes las siguientes extensiones para evitar que el tráfico se declare como no válido.

Campo Tipo Detalles
truncated_ip Número entero Indica si la dirección IP en el campo device.ip de la solicitud de oferta está truncada.

0: No truncado
1: Truncado

El valor predeterminado no está truncado y se requiere si la dirección IP está truncada.

Si no se declara, es posible que la solicitud de oferta se clasifique como tráfico no válido.

ifa_type String Indica el origen del campo device.ifa, ya sea que se haya proporcionado desde el dispositivo o que lo haya generado el publicador o la SSP en la cadena de suministro.

aaid: Android TV
rida: Roku
afai: Amazon Fire
idfa: Apple tvOS
msai: Xbox/Microsoft
dpid: ID de plataforma de dispositivo genérico
ppid: ID proporcionado por el publicador
sspid: ID proporcionado por la SSP
sessionid: ID de sesión de corta duración (solo para fcapping)

attestation_token Cadena (codificación en base64) Es un token de certificación basado en el dispositivo para los intercambios que admiten ese nivel de validación del dispositivo.
atts Número entero (Solo para iOS) Es un número entero que se pasa para representar el estado de autorización del rastreo en apps de la app.

0: No determinado
1: Restringido
2: Denegado
3: Autorizado

cdep String Es la etiqueta de baja de las cookies de terceros de Chrome.

Consulta Pruebas facilitadas por Chrome y la Especificación de la comunidad de IAB

Objeto UserAgent

Campo Tipo Detalles
browsers Es un array de objetos BrandVersion. Cada objeto BrandVersion identifica un navegador o un componente de software similar.
platform Objeto BrandVersion Identifica la plataforma.
mobile Número entero 0 (predeterminado): El agente prefiere el contenido de "escritorio" o "completo".
1: El agente prefiere el contenido para dispositivos móviles.
architecture String Arquitectura del dispositivo, por ejemplo, "x86" o "arm".
bitness String Cantidad de bits del dispositivo, por ejemplo, "64" para la arquitectura de 64 bits.
model String Modelo del dispositivo
source Número entero Es la fuente de datos que se usa para crear este objeto. Consulta List: User-Agent Source. Se recomienda cuando se pasa un objeto UserAgent.

Objeto BrandVersion

Campo Tipo Detalles
brand String Es el identificador de la marca, por ejemplo, "Chrome" o "Windows". Obligatorio.
version Matriz de string Es una secuencia de componentes de versión, en orden jerárquico descendente (principal, secundaria, micro, etcétera).

Objeto de ubicación geográfica

Campo Tipo Detalles
lat Doble No es compatible.
lon Doble No es compatible.
type Número entero No es compatible.
accuracy Número entero No es compatible.
lastfix Número entero No es compatible.
ipservice Número entero No es compatible.
country String No es compatible.
region String No es compatible.
regionfips104 String No es compatible.
metro String No es compatible.
city String No es compatible.
zip String No es compatible.
utcoffset Número entero No es compatible.

Objeto de usuario

Campo Tipo Detalles
id String Se admite si Google aloja la tabla de coincidencias de ID.
buyeruid String Se admite si la SSP aloja la tabla de coincidencias de ID.
yob Número entero Se recomienda para la segmentación demográfica.
gender String Se recomienda para la segmentación demográfica.
keywords Cadena (CSV) No es compatible.
customdata String No es compatible.
geo Objeto Geo No es compatible.
data Es un array de objetos de datos. Son datos adicionales.
eids Es un array de objetos de ID extendido. Son las instancias de ID extendido que proporciona el exchange.
ext Extensiones del usuario Son extensiones para el objeto del usuario.

Extensiones compatibles para el objeto user

Campo Tipo Detalles
consent Cadena (base64 segura para la Web) Es la cadena de consentimiento de IAB.

Contiene metadatos sobre la información que el usuario consintió que se recopilara y qué proveedores pueden usar esa información.

El valor es una cadena binaria codificada en base64 segura para la Web que utiliza un formato binario personalizado.

us_privacy String Indica si el usuario vio el cumplimiento de la CCPA o leyes similares.
consented_providers_settings.consented_providers Objeto externo (consented_providers_settings) que contiene un array de números enteros interno (consented_providers). Cuando se recopila el consentimiento según el RGPD a través del MTC, en este campo se enumeran los proveedores de tecnología publicitaria que obtuvieron el consentimiento del usuario y que no participan en el MTC. Consulta la "Especificación técnica del Consentimiento adicional de Google".
eids Es un array de objetos de ID extendido. Son las instancias de ID extendido que proporciona el exchange.

Objeto de ID extendido

Campo Tipo Detalles
source String El proveedor del identificador
uids Es un array de objetos UID de ID extendido. Los identificadores reales

Objeto UID de ID extendido

Campo Tipo Detalles
id String Es el identificador en sí.
atype Número entero Es el tipo de usuario-agente asociado con este ID.

Objeto de la cadena de suministro

Campo Tipo Detalles
complete Número entero 0 (predeterminado): La cadena de suministro está incompleta.
1: La cadena de suministro está completa hasta el publicador.
ver String Obligatorio.
El valor tiene el formato "major.minor", por ejemplo, la versión 1.0 es la cadena "1.0".
nodes Es un array de nodos de la cadena de suministro. Obligatorio.

En una cadena de suministro completa, el primer nodo representa el sistema publicitario inicial y el ID del vendedor involucrados en la transacción, es decir, el propietario del sitio, la aplicación o cualquier otro medio.

En una cadena de suministro incompleta, representa el primer nodo conocido. El último nodo representa la entidad que envía esta solicitud de oferta.

Objeto de nodo de la cadena de suministro

Campo Tipo Detalles
asi String Es el nombre de dominio canónico del sistema de SSP, Exchange, Header Wrapper, etcétera, al que se conectan los ofertantes. Puede ser el dominio operativo del sistema, si es diferente del dominio corporativo principal, para facilitar el protocolo WHOIS y las búsquedas de IP inversas para establecer la propiedad clara del sistema delegado.

Debe ser el mismo valor que se usa para identificar a los vendedores en un archivo ads.txt, si existe uno.

sid String Es el identificador asociado con la cuenta del vendedor o revendedor en el sistema publicitario. Debe contener el mismo valor que se usa en las transacciones (es decir, las solicitudes de ofertas de OpenRTB) en el campo especificado por la SSP o el intercambio.

Por lo general, en OpenRTB, es publisher.id. Para OpenDirect, suele ser el ID de organización del publicador.

Debe tener un límite de 64 caracteres.

rid String Es el RequestId de OpenRTB de la solicitud tal como la emitió este vendedor.
name String Es el nombre de la empresa (la entidad legal) a la que se le paga por el inventario que se transacciona con el seller_id determinado.

Este valor es opcional y NO se debe incluir si existe en el archivo sellers.json del sistema publicitario.

domain String Es el nombre de dominio comercial de la entidad representada por este nodo.

Este valor es opcional y NO se debe incluir si existe en el archivo sellers.json del sistema publicitario.

hp Número entero Indica si este nodo participará en el flujo de pago del inventario.

1: El sistema publicitario en el campo asi paga al vendedor en el campo sid, quien es responsable de pagar al nodo anterior en la cadena.
0: Este nodo no participa en el flujo de pago del inventario.

Para la versión 1.0 de SupplyChain, esta propiedad siempre debe ser 1. Se requiere explícitamente que se incluya, ya que se espera que las versiones futuras de la especificación introduzcan nodos de manejo que no sean de pago.

Los implementadores deben asegurarse de admitir este campo y propagarlo cuando construyan objetos SupplyChain en las solicitudes de ofertas que se envían a un sistema publicitario downstream.

Especificación de la respuesta a la oferta

Objeto BidResponse

Atributo Compatible Detalles de implementación Siempre se aprueba
id Si se produce un error de análisis, es posible que este valor sea "0" en lugar del ID de la solicitud de oferta. Sí
seatbid
bidid
cur Si se produce un error de análisis, no se pasa. Para el tráfico de solicitudes de oferta válidas, siempre se proporciona la moneda (cur). Sí
customdata
nbr Solo se incluye si se encontró un problema con la solicitud de oferta. Los valores posibles incluyen los siguientes:
2: Solicitud no válida
12: Incumplimiento de la autorización de ads.txt
16: SupplyChain incompleta
17: Nodo de SupplyChain bloqueado
Nota: Cuando se detecta un incumplimiento específico de (app-)ads.txt o SupplyChain, uno de los códigos 12, 16 o 17 se completará en una fracción (1%) de las respuestas. El código 2 se completará para todas las demás solicitudes no válidas.
Las solicitudes que incluyen NBR se verán de la siguiente manera: 
{
  "id": "0",
  "nbr": 2,
  "ext": {
    "err": "Bid request body was empty.",
    "errHelp": "https://.../ortb-spec"
  }
}
ext Si hay un problema con la solicitud de oferta, el objeto ext puede contener información para ayudar a diagnosticar el error, cuando sea compatible.

Extensiones admitidas para el objeto BidResponse

Atributo Detalles de implementación
err

Es una descripción legible del error con la solicitud de oferta. Los casos de respuesta incluyen los siguientes:

  • El cuerpo de la solicitud de oferta estaba vacío.
  • La solicitud de oferta no se realizó en una moneda incluida en la lista de entidades permitidas para el intercambio en particular.
  • La solicitud de oferta no contenía un tipo de MIME aceptado.
errHelp Un vínculo a esta página

Objeto Seatbid

Atributo Compatible Detalles de implementación Siempre se aprueba
oferta sí
asiento sí
grupo

Objeto de oferta

Atributo Compatible Detalles de implementación Siempre se aprueba
id sí
impid sí
precio sí
nurl
nudo
lurl
adm
adid
adomain
Conjunto
iurl
cid sí
crid sí
táctica
cat
attr
api
protocol
qagmediarating
idioma
dealid
w
h
wratio
hratio
exp

Extensiones admitidas para el objeto de oferta

Atributo Detalles de implementación
apis DV360 enviará seatbid.bid.apis si se admiten OMID y MRAID. DV360 establecerá OMID_1 y MRAID como un array de números enteros.

Opciones de publicación de anuncios

En la sección 4.3 de la especificación de OpenRTB, se incluyen dos opciones de publicación diferentes:

  • Marcado que se muestra en el aviso de victoria
  • El margen de beneficio que se aplica a la oferta

DV360 admite ambas opciones.

  • En el caso de los anuncios de banner, DV360 siempre devuelve el lenguaje de marcado en el campo adm. El lenguaje de marcado que se muestra en el aviso de victoria es opcional.
  • En el caso de los anuncios de audio o video que utilizan el protocolo VAST, DV360 admite la devolución de XML de VAST en el campo adm o en la respuesta de la notificación de victoria según los requisitos de los socios de intercambio.

Consulta la especificación de OpenRTB para conocer las ventajas y desventajas de estas dos opciones.

Prácticas recomendadas

Se recomienda usar el ID de socio de Display & Video 360 como ID de asiento. No se recomienda usar el ID de asiento específico del intercambio.

Asegúrate de que tus publicadores tengan archivos ads.txt o aplicaciones con archivos app-ads.txt asociados, y de que te incluyan en el archivo como vendedor o revendedor autorizado. Obtén más información.

También asegúrate de que se pase información coherente en las solicitudes de oferta. Por ejemplo, app.bundle debe ser coherente con la información del dispositivo móvil y app.storeurl.

TV conectada

Cumple con los lineamientos de IFA de IAB OTT cuando pases device.ifa y device.lmt. También debes implementar device.ext.ifa_type para cumplir con los lineamientos. Todas nuestras capacidades de limitación de frecuencia y segmentación por público de CTV requerirán la presencia de un IFA.

También debes cumplir con los lineamientos sobre el ID asignado por la tienda de OTT/CTV de la IAB publicados recientemente, que definen cómo se debe pasar app.bundle para las apps de CTV, principalmente con el ID definido por la tienda de aplicaciones.

Medición de Vista activa

Vista activa es una tecnología de Google que se usa para medir si una impresión fue visible y por cuánto tiempo. La Vista activa utiliza OMID para los anuncios gráficos y de video. Para habilitar la medición con OMID, los intercambios deben agregar los siguientes campos en las solicitudes de OpenRTB para que DV360 conozca la compatibilidad del cliente con OMID.

  • Obligatorio: Agrega un framework de API (Video.api=7 para OMSDK) a las solicitudes de oferta. Esto es obligatorio para que Vista activa habilite la medición con OMID.
  • Recomendación: Se recomienda mucho agregar omidpn y omidpv a Source.Ext, ya que afectará la forma en que se informan las mediciones de visibilidad en DV360 al cliente. Si el nombre del socio de OMID no aparece en la lista de certificación del IAB, el MRC nos exige que informemos las métricas de visibilidad por separado de las métricas certificadas por el MRC. Obtén más información.

Preguntas frecuentes

¿DV360 admite extensiones personalizadas de intercambio?
Sí, además de las extensiones que se indican en esta especificación, Display & Video 360 también puede admitir extensiones personalizadas según cada caso. Se recomienda especificar y probar la extensión personalizada durante el período de integración.
¿DV360 admite los videos recompensados?
Sí, envíenos la extensión de video recompensado.
Gran parte de mi inventario se muestra como datos demográficos desconocidos. ¿Cómo puedo mejorar la cobertura demográfica?
Completa user.yob y user.gender en las solicitudes de oferta a DV360 para aumentar la cobertura.
¿DV360 tiene extremos para cada región?
No, usamos un solo extremo a nivel global y enrutamos automáticamente las solicitudes al centro de datos más cercano, por lo que no podemos proporcionar un extremo específico de la región.
¿Cuáles son los requisitos para las solicitudes de servidor a servidor (s2s)?
Comunícate con nosotros para solicitar que se te agregue a nuestra lista de entidades permitidas. El encabezado User-Agent del cliente debe reenviarse, y se debe garantizar que las cookies estén inhabilitadas o se ignoren en la respuesta a una recuperación de VAST de servidor a servidor.
¿DV360 admite OMID?
Podemos medir la visibilidad con OMID siempre que se declare como habilitado para OMID en el momento de la solicitud de oferta. Los detalles sobre este tema se resumen en las páginas 24 y 25.
¿Qué versión de Native admites? ¿Tienes algún requisito para los anuncios nativos?
Solo admitimos la versión 1.2 de Native. Especificación de nativo.
¿DV360 admite solicitudes de ofertas enviadas como GZIP?
DV360 puede recibir solicitudes de ofertas comprimidas con gzip y responderá con respuestas comprimidas con gzip si el encabezado Accept-Encoding indica que se admite.
¿DV360 admite DBURL?
No por el momento.
¿DV360 admite notificaciones de victorias y derrotas?
No por el momento. Si crees que sería útil que lo admitiéramos, comunícate con nosotros y danos más detalles.
¿DV360 requiere App.name para la segmentación?
No, DV360 usa App.name como referencia, pero no es obligatorio para la segmentación.App.bundle se usa para la segmentación.
¿DV360 admite varios tamaños de anuncios enviados en una sola solicitud de oferta?
Sí, tendremos en cuenta todos los tamaños de creatividad aptos en banner.format.
¿DV360 admite múltiples formatos en la misma solicitud de oferta?
Tenemos asistencia limitada para las solicitudes de ofertas con varios formatos, pero estamos trabajando para mejorarla. Admitimos los formatos de video y gráficos para los anuncios intersticiales, pero actualmente no admitimos los formatos gráficos ni nativos. Si envías solicitudes de ofertas con varios formatos, comunícate con nosotros para solicitar una prueba.
¿DV360 admite tipos de impresiones mixtas en la misma solicitud?
Actualmente, solo admitimos anuncios intersticiales de video o de banner. Estamos trabajando en banners nativos y de video. Si hay otras combinaciones, comunícate con nuestro equipo.
¿Pueden varios asientos enviar varias ofertas en una o más de esas oportunidades de impresión en la misma solicitud?
Sí.
¿DV360 tiene una solución o una necesidad particular con respecto a la limitación o la visualización del mismo anunciante para varias oportunidades de impresión de este tipo en la misma solicitud?
DV360 aplica la regla de que un anunciante solo puede ofertar por una oportunidad de impresión por cada solicitud. Esperamos que las SSP agrupen los objetos de impresión de forma significativa, por ejemplo, todos en la misma página, todos en la misma app, etcétera.
¿DV360 admite varias impresiones en la misma solicitud de oferta?
Actualmente, DV360 admite varios objetos de audio de impresión. Sin embargo, tendremos que probar o habilitar cada intercambio que quiera usar esta función. Consulta la especificación de la solicitud de oferta para obtener más información. Estamos trabajando para expandir esta función a otros formatos: 
{
id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38",
seatbid {
bid {
  id: "0",
  impid: "234232",
  price: 41.373926619828261,
  adid: "123",
  adm: "...",
  adomain: "xxx.com",
  cid: "0",
  crid: "123",
  dealid: "sample-deal-id-1",
  language: "xx",
},
bid {
  id: "1",
  impid: "234255",
  price: 2.34192037470726,
  adid: "234",
  adm: "...",
  adomain: "xyz.com",
  cid: "0",
  crid: "234",
  dealid: "sample-deal-id-2",
  language: "xx",
},
seat: "123456"
},
cur: "EUR"
}

Comunícate con nosotros

Si tienes alguna pregunta o problema, comunícate con nuestro equipo de asistencia al cliente para intercambios.