Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Referencia de campo ORTB
<a name="yield-optimization-ortb-reference"></a>

Esta página es una referencia completa para todos los campos de la solicitud de oferta de OpenRTB. Los campos se clasifican según la forma en que los MediaTailor gestiona y si APS los requiere o recomienda para completar los anuncios de forma óptima.

Para ver la especificación completa de OpenRTB 2.6, consulte la especificación OpenRTB 2.6 de [ IAB. ](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)

## Categorías de campos
<a name="yield-optimization-ortb-reference-categories"></a>


| Categoría | Significado | Tu acción | 
| --- | --- | --- | 
| Obligatoria  | Debe estar presente en tu plantilla. MediaTailor arroja un error si falta. | Debe proporcionarlos. | 
| Codificado por EMT  | MediaTailor siempre los establece utilizando los valores de la configuración de la consola o del contexto disponible actual. Los valores de su plantilla se anulan. | No los defina en la plantilla. | 
| Se recomienda APS  | No son estrictamente obligatorios MediaTailor, pero APS los recomienda para completar y segmentar mejor los anuncios. La falta de campos recomendados puede provocar tasas de llenado más bajas o respuestas sin oferta. | Se recomienda encarecidamente. | 
| Opcional | Se incluyen en la solicitud de oferta solo si los proporcionas. Sin valor predeterminado. | Indique si es relevante para su caso de uso. | 

## ``objeto de aplicación
<a name="yield-optimization-ortb-reference-app"></a>


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| app | Obligatorio  | El app objeto debe existir en la plantilla. | 
| app.bundle | Obligatorio  | El identificador del paquete de tu aplicación (por ejemplo,G15147002586). No debe estar vacío. | 
| app.storeurl | Obligatorio  | URL de la tienda de aplicaciones (por ejemplo,https://apps.apple.com/us/app/yourapp/id123). | 
| app.publisher.id | Codificado por EMT  | Establézcalo siempre como el tuyo PublisherId desde la configuración de la consola. | 
| app.content | Obligatorio (objeto)  | MediaTailor envía un Content objeto vacío si omite esto. Proporcione metadatos de contenido para una mejor segmentación. | 
| app.name | Se recomienda APS | Nombre de la aplicación para la identificación. | 
| app.id | Se recomienda APS | El identificador de su aplicación en APS. | 
| app.domain | Se recomienda APS | Dominio de la aplicación. | 
| app.content.genre | Se recomienda APS | Género de contenido (por ejemplo,"Sport","News"). | 
| app.content.contentrating | Se recomienda APS | Clasificación del contenido (por ejemplo,"TV-G","TV-14"). | 
| app.content.language | Se recomienda APS | Idioma del contenido (ISO-639-1). | 
| app.content.id | Se recomienda APS | Identificador de contenido. | 
| app.content.title | Se recomienda APS | Título del contenido. | 
| app.content.episode | Se recomienda APS | Número de episodio. | 
| app.content.len | Se recomienda APS | Duración del contenido en segundos. | 
| app.cat | Opcional | Categorías de contenido (taxonomía de la IAB). | 
| app.sectioncat | Opcional | Categorías de secciones. | 
| app.pagecat | Opcional | Categorías de páginas. | 
| app.ver | Opcional | Versión de la aplicación. | 
| app.privacypolicy | Opcional | 1 = tiene una política de privacidad. | 
| app.paid | Opcional | 1 = aplicación de pago. | 
| app.keywords | Opcional | Comma-separated palabras clave. | 
| app.kwarray | Opcional | Palabras clave como matriz. | 
| app.inventorypartnerdomain | Opcional | Dominio del socio de inventario. | 
| app.ext | Opcional | Objeto de extensión (transferencia). | 

## `objeto de dispositivo`
<a name="yield-optimization-ortb-reference-device"></a>


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| device | Obligatorio  | El device objeto debe existir en la plantilla. | 
| device.ua | Obligatorio  | Cadena de agente de usuario. No debe estar vacía. Utilice {{session.user\_agent}}. | 
| device.ip | Obligatorio  | Dirección IPv4. No debe estar vacía. Utilice {{session.client\_ip}}. | 
| device.lmt | Opcional (predeterminado: 0) | Marca de límite de seguimiento de anuncios. 0= seguimiento permitido, 1 = seguimiento limitado. Si no se incluye en la plantilla, el valor predeterminado es. 0 | 
| device.devicetype | Codificado por EMT (predeterminado: 3)  | MediaTailor sets 3 (TV conectada) si no se proporcionan. Si está presente, se utiliza su valor. | 
| device.make | Se recomienda APS | Fabricante del dispositivo (por ejemplo"Samsung","Apple"). | 
| device.model | Se recomienda APS | Modelo de dispositivo (por ejemplo,"Tizen TV","iPhone"). | 
| device.os | Se recomienda APS | Sistema operativo (por ejemplo,"Tizen","iOS"). | 
| device.osv | Se recomienda APS | Versión del sistema operativo. | 
| device.h | Se recomienda APS | Altura de la pantalla en píxeles. | 
| device.w | Se recomienda APS | Ancho de pantalla en píxeles. | 
| device.language | Se recomienda APS | Idioma del dispositivo (ISO-639-1). | 
| device.ifa | Se recomienda APS | ID de publicidad del dispositivo. No todos los dispositivos tienen uno (por ejemplo, los navegadores web). | 
| device.dnt | Se recomienda APS | Bandera de no rastrear. | 
| device.geo | Opcional | Objeto geográfico concountry,lat,lon. | 
| device.sua | Opcional | Agente de usuario estructurado (UA-CH). | 
| device.ipv6 | Opcional | Dirección IPv6. | 
| device.hwv | Opcional | Versión de hardware. | 
| device.connectiontype | Opcional | Tipo de conexión (celularWiFi, etc.). | 
| device.carrier | Opcional | Nombre del transportista. | 
| device.mccmnc | Opcional |  country/network Código móvil. | 
| device.ext | Opcional | Objeto de extensión (transferencia). | 

## `objeto imp` (impresión)
<a name="yield-optimization-ortb-reference-imp"></a>

La plantilla debe contener exactamente ** un ** `imp` objeto en una matriz.


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| imp[0].video | Obligatorio  | El video objeto debe existir. | 
| imp[0].video.mimes | Obligatorio  | Tipos MIME compatibles (por ejemplo,["video/mp4"]). | 
| imp[0].video.protocols | Opcional | Protocolos VAST compatibles. Si se omite, MediaTailor utiliza una alternativa codificada. [1, 2, 3, 4, 5, 6, 7, 8] Consulte la referencia de enumeración del protocolo a continuación. | 
| imp[0].video.minduration | Codificado por EMT  | Configúralo como tuyo MinimumUnfilledDuration desde la consola. | 
| imp[0].video.maxduration | Codificado por EMT  | Establezca la duración real sin rellenar (segundos). | 
| imp[0].video.maxseq | Codificado por EMT  | Calculado:. floor(unfilled\_duration / 6) APS recomienda poddur devolver varios anuncios maxseq o devolverlos. | 
| imp[0].video.poddur | Codificado por EMT  | Establezca la duración sin rellenar (segundos). | 
| imp[0].video.startdelay | Opcional | Retraso de inicio. 0= antes de la tirada, -1 = media tirada genérica, = después de la tirada, -2 = desfase de la mitad de la tirada en segundos. > 0 Úsala para pausas de mitad de -1 tirada en directo. Alternativa codificada:. 6 | 
| imp[0].video.w | Se recomienda APS | Ancho del vídeo en píxeles. | 
| imp[0].video.h | Se recomienda APS | Altura del vídeo en píxeles. | 
| imp[0].video.plcmt | Se recomienda APS | Tipo de ubicación (1 = en curso). | 
| imp[0].video.podid | Se recomienda APS | Identificador de pod. | 
| imp[0].video.slotinpod | Se recomienda APS | Posición de la ranura en la cápsula. | 
| imp[0].video.ext.slotId | Opcional (predeterminado:"default\_slot\_id") | Su ID de ranura APS desde la consola APS. La opción predeterminada funciona, pero si proporciona su identificador de ranura real, APS puede fijar precios mínimos y objetivos específicos para cada ranura. | 
| imp[0].bidfloor | Opcional (predeterminado: 1.0) | Precio mínimo de puja en CPM. | 
| imp[0].secure | Opcional (predeterminado: 1) | 1 = requiere URL creativas de HTTPS. | 
| imp[0].id | Opcional | ID de impresión. Auto-generated si no se proporciona. | 
| imp[0].tagid | Opcional | Tag/placement ID. | 
| imp[0].bidfloorcur | Opcional | Divisa mínima de oferta (USD por defecto). | 
| imp[0].ssai | Opcional | Indicador SSAI. | 
| imp[0].exp | Opcional | Tiempo de caducidad de la impresión. | 
| imp[0].rqddurs | Opcional | Matriz de duraciones solicitada. | 
| imp[0].mincpmpersec | Opcional | CPM mínimo por segundo. | 
| imp[0].pmp | Opcional | Objeto de mercado privado. | 
| imp[0].ext | Opcional | Objeto de extensión (transferencia). | 

### Referencia de enumeración de protocolos
<a name="yield-optimization-ortb-reference-protocol-enum"></a>


| Valor | Protocolo | 
| --- | --- | 
| 1 | VAST 1.0 | 
| 2 | VASTO 2.0 | 
| 3 | VASTO 3.0 | 
| 4 | Envoltorio VAST 1.0 | 
| 5 | Envoltorio VAST 2.0 | 
| 6 | Envoltorio VAST 3.0 | 
| 7 | VAST 4.0 | 
| 8 | Envoltorio VAST 4.0 | 
| Más de 9 | DAAST | 

## Top-level campos
<a name="yield-optimization-ortb-reference-top-level"></a>


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| id | Codificado por EMT  | Auto-generated: {sessionId}\_{availId} formato (por ejemplo,abc123-def456\_78901). Útil para correlacionar las solicitudes de oferta con los registros de sesión. | 
| cur | Opcional (predeterminado:["USD"]) | Divisas permitidas. | 
| ext.integrationType | Codificado por EMT  | Siempre configurado en. "EMT" | 
| bcat | Opcional | Categorías de anuncios bloqueados (taxonomía de IAB). El valor de la plantilla se envía tal cual a APS. | 
| badv | Opcional | Dominios de anunciantes bloqueados. | 
| bapp | Opcional | ID de paquetes de aplicaciones bloqueados. | 
| test | Opcional | Indicador de modo de prueba. | 
| at | Opcional | Tipo de subasta. | 
| tmax | Opcional | Tiempo máximo (ms) de espera para recibir la respuesta a la oferta. | 
| wseat | Opcional | Asientos permitidos para compradores. | 
| bseat | Opcional | Asientos de compradores bloqueados. | 
| wlang | Opcional | Lenguajes creativos permitidos. | 
| source | Opcional | Objeto de origen para la cadena de suministro. | 
| ext | Opcional | Sus campos de extensión personalizados se fusionan con los de integrationType EMT. | 

## `objeto de usuario`
<a name="yield-optimization-ortb-reference-user"></a>


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| user | APS recomendado (UE) | Obligatorio para el tráfico de la UE con el consentimiento del RGPD. | 
| user.consent | Se recomienda APS (UE) | Cadena de consentimiento (TCF) del RGPD. | 
| user.id | Opcional | ID de usuario. | 
| user.buyeruid | Opcional | Buyer-specific ID de usuario. | 
| user.eids | Opcional | Identificadores extendidos (LiveRampUID2, etc.). | 
| user.data | Opcional | Segmentos de datos de usuario. | 
| user.ext | Opcional | Objeto de extensión. | 

## `objeto regs`
<a name="yield-optimization-ortb-reference-regs"></a>


| Campo | Categoría | Notas | 
| --- | --- | --- | 
| regs | Se recomienda APS | Incluya para el cumplimiento de la normativa. | 
| regs.coppa | Se recomienda APS (EE. UU.) | Bandera de la COPPA (1 = dirigida a niños). | 
| regs.us\_privacy | Se recomienda APS (EE. UU.) | Privacidad en EE. UU./cadena CCPA. | 
| regs.gdpr | Se recomienda APS (UE) | Se aplica el RGPD (1 = sí). | 
| regs.gpp | Se recomienda APS | Cadena de la plataforma de privacidad global. Preferido en lugar us\_privacy de para el público estadounidense, lo que se traduce en mejores tasas de llenado. Consulte [Prácticas recomendadas](yield-optimization-best-practices.md). | 
| regs.gpp\_sid | Se recomienda APS | Identificadores de sección GPP (por ejemplo, [7] para los nacionales de EE. UU.). Obligatorio cuando gpp está presente. | 
| regs.ext | Opcional | Objeto de extensión. | 

## Siguientes pasos
<a name="yield-optimization-ortb-reference-next-steps"></a>
+ Para ver las plantillas de copiar y pegar, consulte. [Plantillas de ejemplo](yield-optimization-examples.md)
+ Para obtener recomendaciones sobre cómo maximizar las tasas de llenado, consulte. [Prácticas recomendadas](yield-optimization-best-practices.md)