Aspectos destacados
- Inclusión explícita para AWS MediaTailor, con compatibilidad total para dominios de CDN personalizados.
- Nueva API
config.ad.typepara elegir entre el seguimiento de anuncios CSAI y SSAI (DAI,MT) — no más suposiciones basadas en URL para SSAI. - Logging de extremo a extremo a través de
nrvideo.Log, con el modo de detección activa registrado en el inicio.
Característica
Soporte de CDN personalizada de MediaTailor
Se reemplazó la detección automática basada en URL con la inclusión explícita.
- Se habilitó el rastreador a través de
mediatailor: true(omediatailor: { trackingUrl, adSegmentPrefix }), que admite tanto nombres de host de AWS predeterminados como dominios de CDN personalizados. - Se agregó la constante
MT_DEFAULT_AD_SEGMENT_PATH(/tm/) para la ruta de segmento de anuncios de CDN recomendada por AWS; los segmentos de anuncios reescritos a un dominio de CDN personalizado bajo/tm/se detectan automáticamente. - Se actualizó
isMediaTailorSegment()para verificar el nombre de host de segmentos de AWS predeterminado, la ruta/tm/y unadSegmentPrefixopcional proporcionado por el cliente. - Se enlazó
adSegmentPrefixa través del análisis de manifiestos HLS (VHS) y DASH. - Se agregó la inicialización de sesión explícita a través de
mediatailor: { trackingUrl }para los flujos dePOST /v1/session/.
Configuración de seguimiento de anuncios
Se introdujo config.ad.type para controlar la selección del rastreador de anuncios.
- Se expuso la constante
AD_TRACKINGcon CSAI (valor plano que cubre IMA / Brightcove IMA / Freewheel / genérico) y los subtipos de SSAI (DAI,MT). - Se requirió un subtipo explícito para SSAI — cada plataforma necesita su propio SDK y no se puede detectar automáticamente.
- Se asignó
SSAI.MTpara implicarmediatailor: true. - Se agregó una alternativa a la detección automática de CSAI con una advertencia cuando
config.ad.typeno está configurado (compatible con versiones anteriores para v4.1.2 usuarios). - Se ubicaron conjuntamente
segmentPrefixytrackingUrlbajoconfig.ad. - Se agregó
DaiAdsTrackera las exportaciones estáticas.
Mejoras de logging
- Se expuso
VideojsTracker.Logcomo estático para que los llamadores UMD puedan establecer el nivel de logs. - Se agregó el logging del modo de detección de segmentos de anuncios activo al inicio del rastreador.
- Se agregó el logging de la ruta de detección de segmentos de anuncios coincidente en la primera pausa publicitaria (una vez por sesión).
- Se agregó el logging de qué framework de CSAI se detectó automáticamente (BrightcoveIma / IMA / Freewheel / genérico).
- Se reemplazó
console.log/warn/errorpornrvideo.Logen todos los archivos de MediaTailor.
Corrección de errores
- Se corrigió el manejo del final del búfer en el rastreador.
- Se corrigió que
register-plugin.jsdescartara silenciosamente el objeto de opciones y no lo reenviara al constructor deTrackerJS.
Documentación
- Se actualizaron el README y los documentos de SSAI para la compatibilidad con CDN personalizada, se aclaró cuándo se necesitan las anulaciones de
trackingUrlyadSegmentPrefix, y se limpiaron las referencias asessionId. - Se corrigieron las referencias de
adSegmentPrefixaconfig.ad.segmentPrefixen los documentos de resolución de problemas de SSAI.
Actualizar desde la 4.1.x
No hay cambios importantes para los usuarios de CSAI. Si
config.ad.typeno está configurado, el rastreador aún detecta automáticamente los frameworks de CSAI (con una advertencia única).Los usuarios de MediaTailor deben habilitarlo explícitamente. Reemplace cualquier dependencia de patrón de URL con uno de:
mediatailor: true(nombres de host predeterminados de AWS + ruta/tm/)mediatailor: { trackingUrl, adSegmentPrefix }(CDN personalizado / inicialización de sesión explícita)config.ad.type: AD_TRACKING.SSAI.MT
Si anteriormente pasó
adSegmentPrefixen el nivel superior, muévalo aconfig.ad.segmentPrefix.