View a markdown version of this page

Referencia de campo ORTB - AWS Elemental MediaTailor
Categorías de camposobjeto de aplicaciónobjeto de dispositivoobjeto imp (impresión)Top-level camposobjeto de usuarioobjeto regsSiguientes pasos

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

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.

Categorías de campos

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

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

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)

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

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

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

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

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.
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