LinkedIn lanzó la versión 202601 de su API de marketing en enero, y para cualquiera que publique anuncios de vídeo o eventos de LinkedIn Live, esta actualización es realmente importante. Por fin puedes hacer un seguimiento del tiempo que la gente ve tus vídeos, y no solo de si los pasa por alto.
La nueva API añade Métricas de EventWatchTime y VideoWatchTime con umbrales de interacción de 15 segundos, 30 segundos y 2 minutos. Y si sigues usando la versión 202502, tienes hasta 16 de febrero de 2026 migrar. Eso es dentro de dos semanas.
¿Qué hay de nuevo en la API 202601 de LinkedIn?
La versión 202601 de LinkedIn introduce dos grupos de métricas a través del /adAnalytics endpoint, según su documentación oficial:
Para eventos de LinkedIn (eventos en vivo, seminarios web):
- eventViews
- eventWatchTime (total de segundos vistos)
- averageEventWatchTime
- costPerEventView
- Thresholded versions con límite de tiempo de 15, 30 segundos, y 2 minutos
Para anuncios de vídeo patrocinados:
- videoWatchTime
- averageVideoWatchTime
Antes de esto, podías ver las impresiones y los clics. Ahora puedes ver si la gente realmente lo ha visto más allá de los primeros segundos. Una visualización de 30 segundos significa algo diferente a una visualización de 2 segundos, especialmente si se tiene en cuenta el coste de los anuncios premium de LinkedIn.
Por qué la duración de la visualización de vídeos es más importante que las impresiones
El panel de control de tu campaña puede mostrar 10 000 impresiones y un CTR del 5% en el vídeo de demostración de tu producto. Parece decente. Sin embargo, las nuevas métricas de vídeo de LinkedIn podrían revelar que solo 1200 personas (el 12%) lo vieron después de 15 segundos, y solo 300 (el 3%) llegaron a los 2 minutos. Tiempo medio de visualización: 8 segundos.
Eso indica que el gancho no funciona. Puede que tu propuesta de valor aparezca demasiado tarde en el vídeo o que el primer fotograma no llame la atención. Puedes probarlo ahora en lugar de adivinar por qué tus campañas de vídeo no generan conversiones.
Las métricas con umbrales ayudan a segmentar las audiencias según la profundidad de participación. Probablemente valga la pena resegmentar a alguien que haya visto más de 2 minutos de tu demo con un caso práctico. ¿Alguien que se retiró a los 5 segundos? Un público diferente, un mensaje diferente o omítelos por completo.
Cómo acceder a las nuevas métricas de vídeo de LinkedIn
Actualiza el encabezado de la versión de la API de marketing de LinkedIn a 202601:
GET https://api.linkedin.com/rest/adAnalytics
Headers:
LinkedIn-Version: 202601
Authorization: Bearer {YOUR_TOKEN}
Agregue las nuevas métricas al parámetro de sus campos:
fields=impressions,clicks,videoWatchTime,averageVideoWatchTime,eventViews,eventWatchTimeOver30Seconds
La API muestra el tiempo de visualización en segundos, por lo que si ves `VideoWatchTime: 145800`, significa 40,5 horas de tiempo total de visualización entre todas las impresiones.
Para los datos con umbrales, solicita métricas específicas como «EventWatchTimeOver15Seconds» o «EventViewSover2Minutes» para hacer un seguimiento de la interacción con los vídeos de LinkedIn en diferentes niveles de profundidad.
Comparación de versiones de API: lo que te falta
La versión 202501 se puso al sol el 15 de enero de 2026. La versión 202502 caduca el 16 de febrero, esa es la fecha límite que importa si aún no la has actualizado.
Fecha límite para la puesta del sol del 16 de febrero
El control de versiones de la API de LinkedIn sigue un Período de soporte de 12 meses. Tras la puesta de sol, tus llamadas a la API dejan de funcionar. No dicen «podría parar», sino que devuelven errores y tus paneles se estropean.
Horario actual de puesta de sol:
- 202501:15 de enero de 2026 (listo)
- 202502:16 de febrero de 2026 (faltan dos semanas)
- 202503:16 de marzo de 2026
Si usas la versión 202502 en tu pila de informes, scripts de API manuales o conectores de datos, compruébalo antes del 16 de febrero. La mayoría de las plataformas comerciales se actualizan automáticamente, pero las implementaciones personalizadas necesitan actualizaciones manuales.
Aplicaciones prácticas para el seguimiento de anuncios de vídeo de LinkedIn
Calcule las tasas de finalización por umbral:
30-second completion rate = eventViewsOver30Seconds / eventViews × 100
Esto te indica qué porcentaje de espectadores se quedan después de la introducción. Haz un seguimiento de los vídeos de diferentes duraciones para determinar la capacidad de atención real de tu audiencia, no la que crees que debería ser.
Segmenta el retargeting por interacción:
- Espectadores de más de 2 minutos: retargeting de demostraciones de productos
- Espectadores de 30 a 60 segundos: contenido del estudio de caso
- Usuarios de menos de 15 segundos: excluidos del presupuesto de retargeting
Mida el ROI de los eventos más allá de los registros: Los números de registro no indican quién se presentó y participó realmente. Las nuevas métricas muestran quién se registró, quién lo vio durante más de 30 segundos (se presentó), quién lo vio durante más de 2 minutos (mantuvo la interacción) y dónde se produjo la disminución.
Ganchos de vídeo de prueba A/B: Ejecuta dos versiones de tu vídeo con diferentes ganchos de apertura. Realiza un seguimiento del número de espectadores que caen antes de los 15 segundos en cada versión. La que mantenga la atención más allá de los 15 segundos gana, independientemente de cuál «se vea» mejor.
Problemas comunes de migración
«Las nuevas métricas devuelven un valor nulo»
Estás consultando fechas anteriores a enero de 2026. Las nuevas métricas solo se aplican a los datos a partir del 1 de enero de 2026. Los datos históricos no se rellenaron.
«La API devuelve un error 400 después de la actualización de la versión»
Comprueba qué pivotes estás usando. Algunas métricas no están disponibles con determinadas combinaciones de pivotes. El documentación oficial de métricas muestra qué métricas funcionan con qué pivotes.
«La hora de visualización parece estar mal»videoWatchTime es acumulativo para todos los espectadores, no para el promedio por espectador. Utilice averageVideoWatchTime para obtener métricas por espectador, o calcúlelo usted mismo: el tiempo total de visualización dividido por las impresiones.
Qué hacer antes del 16 de febrero
Comprueba qué versión de API estás usando. Si es la 202502 o una anterior, actualiza el encabezado de la versión a la 202601, prueba tus consultas con los datos de los últimos 7 días y comprueba que las nuevas métricas se cumplen.
Si comparas las métricas de vídeo de LinkedIn con las de Facebook, YouTube y TikTok en un panel, cada plataforma mide el tiempo de visualización de forma diferente. La atribución de vídeos multiplataforma se complica rápidamente. He aquí cómo manejarlo.
Las nuevas métricas de visualización de vídeos te dan una señal mucho mejor de lo que realmente funciona. La fecha límite del 16 de febrero es real. Si estás en la versión 202502, realiza la migración esta semana.
Preguntas frecuentes
¿Las nuevas métricas funcionan con todos los formatos de anuncios de LinkedIn?
EventWatchTime funciona con LinkedIn Events (eventos en vivo y externos). VideoWatchTime funciona con anuncios de vídeo patrocinados. Los anuncios con imágenes, los anuncios de carrusel y los anuncios de texto no admiten estas métricas.
¿Se actualizarán los datos históricos?
No. Solo canciones de enero de 2026 en adelante.
¿Qué pasa si no emigro antes del 16 de febrero?
Las llamadas a la API que utilicen la versión 202502 devolverán errores después del 16 de febrero. Los informes y paneles automatizados dejarán de funcionar hasta que actualices a la 202601 o una versión posterior.
¿Puedo hacer un seguimiento de la interacción con los vídeos en LinkedIn Audience Network?
Sí, las métricas de visualización de vídeos funcionan para los anuncios en las ubicaciones de Linkedin.com y LinkedIn Audience Network.
¿Cómo calculo la tasa de participación a partir de estas métricas?
Utilice (eventViewsOver30Seconds / impressions) × 100 para obtener el porcentaje de impresiones que se tradujeron en un tiempo de visualización de al menos 30 segundos.
¿Hay límites de tarifas?
Igual que en las versiones anteriores de la API. Compruebe Documentación de límites de tarifas de LinkedIn para las cuotas actuales.
