Entiende la reproducción de tu contenido

Las analíticas VOD de Orilla se consultan por entorno y por video. La recopilación debe estar activada y el reproductor debe recibir la configuración de envío del entorno.

Activa y consulta

Un administrador habilita la recopilación en el entorno. El reproductor utiliza su clave pública de envío para reportar los eventos admitidos. Esta clave pública no permite consultar los datos administrativos.

Desde Analíticas puedes seleccionar contenido y período para consultar los datos disponibles. La vista previa de la biblioteca no genera nuevas vistas de analítica.

Elige una tarea

Período y Video se mantienen juntos al cambiar de sección. La página muestra un área de trabajo a la vez:

• Resumen: presencia reciente, métricas seleccionadas y actividad por intervalo.
• Reproducciones: historial de sesiones y errores de reproducción. Desde un error puedes consultar las reproducciones afectadas.
• Contenido: mapa de visualización y distribución por calidad y modo.
• Comparar métricas: comparaciones, dimensiones e insights.
• Alertas: reglas e incidentes del entorno, con sus filtros propios.

En Herramientas encontrarás Anotaciones, Exportar reproducciones y Configuración de analítica. Volver al resumen recupera la vista inicial. Las herramientas conservan sus borradores al cambiar de sección dentro del mismo entorno.

Qué puedes observar

• Reproducciones, espectadores estimados y tiempo reproducido.
• Inicio, buffering, fallos y detalle de sesiones.
• Mapas de visualización y momentos más o menos vistos.
• Tiempo por calidad y modo de reproducción.
• Anotaciones, reglas de alerta, incidentes y exportaciones diarias.
• Comparación de trece métricas e insights de calidad/volumen.
• Series por grupo e histogramas de monitoring.
• Canales de correo, Slack y PagerDuty.

La disponibilidad depende de la recopilación, los permisos y la cobertura del período. No se reconstruyen datos históricos que nunca se hayan enviado.

No confundas falta de datos con cero

La interfaz y las respuestas distinguen la cobertura no disponible, los datos parciales y un cero medido. Las dimensiones no observadas permanecen desconocidas. Los espectadores únicos son una estimación, no una identificación exhaustiva de personas.

Los mapas distinguen intensidad, que incluye repeticiones, y alcance por tramos sin duplicarlos dentro de una misma reproducción. Una intensidad superior a uno puede representar repeticiones.

Integración con el SDK

const { data: assets } = await orilla.assets.list({ limit: 25 });
const capabilities = await orilla.data.capabilities();

Los recursos orilla.data documentados en el SDK permiten consultar métricas, dimensiones y sesiones con permiso data:read. Usa las capacidades y metadatos de cobertura antes de interpretar un valor como completo.

Privacidad y retención

El reproductor respeta Do Not Track y no activa cookies de analítica. Sin un identificador explícito, la identidad anónima permanece en memoria de la página. El collector transforma identidades por entorno y elimina consultas de las URLs.

El histórico se conserva durante 30 días y el monitoreo durante 24 horas. Las unidades difieren según el campo: los tiempos Unix son segundos y el tiempo reproducido del SDK puede expresarse en milisegundos. Comprueba el contrato de cada recurso antes de mostrarlo.

Conserva una vista de trabajo

Analíticas → Vistas guardadas guarda período, video, orden y selección de las cinco métricas resumen, secciones y herramientas abiertas. Las herramientas guardadas se consultan por separado, sin apilar sus formularios en la página. Las vistas personales son privadas; las compartidas son visibles a los miembros del entorno y requieren escritura para crearlas o editarlas. Cualquier rol puede administrar sus vistas personales.

Guarda explícitamente los cambios. Si alguien edita la misma vista, el conflicto conserva tu borrador: carga la versión guardada o conserva tu borrador sobre la versión actual antes de guardar otra vez. La selección activa se restaura al recargar; un video abierto desde Biblioteca tiene prioridad. No se guardan formularios internos, una reproducción seleccionada ni una distribución libre de widgets.

Hora local/UTC cambia la presentación para tu usuario y entorno, no los cálculos. Anotaciones y exportaciones mantienen sus zonas contractuales. Presencia, alertas y exportaciones pueden tener alcance independiente: revisa la etiqueta de cada sección.

Trazas de proveedores

El detalle de una reproducción puede mostrar video_cdn_trace y si la secuencia está completa. Representa etiquetas de proveedor observadas por el collector, sin guardar URLs de medios ni mapas de cabeceras. Una repetición vecina se colapsa; una revisita posterior se conserva.

const providers = await orilla.data.dimensions.elements("video_cdn_trace", {
  timeframe: ["24:hours"],
  page: 1,
  limit: 25,
});
console.log(providers.data, providers.orilla.coverage);

Cada proveedor cuenta una vez por reproducción; las trazas parciales son un límite inferior. Sin observaciones el dato es desconocido. Esta instrumentación no instala ni opera una CDN. Las dimensiones y sus alias heredados data.filters solo exponen atributos recopilados.

Exportaciones diarias de vistas

const catalog = await orilla.data.exports.listVideoViews();
for (const day of catalog.data) {
  for (const file of day.files) {
    // Descarga con el enlace firmado; no reenvíes Authorization del SDK.
    console.log(day.export_date, file.path, file.revision_id, file.row_count);
  }
}

Son CSV gzip de todos los videos del entorno, por final de reproducción en un día completo UTC. La generación cubre los siete días UTC anteriores, con revisiones para correcciones; cada revisión se conserva siete días desde su generación. Las URLs duran hasta quince minutos: consulta otra vez el catálogo para renovarlas.

El esquema propio orilla.data.views.v1 conserva 55 columnas, tiempos en ms, ratios de 0 a 1, bitrate en bps y desconocidos vacíos. Cada archivo tiene su instantánea: el catálogo no es una única instantánea de todos los días. Máximo por archivo: 100.000 filas, 128 MiB sin comprimir y 64 MiB gzip, reducibles por configuración. Un exceso falla sin truncar; una revisión válida anterior puede seguir disponible mientras se reintenta.

Estas exportaciones no admiten filtros por video ni períodos arbitrarios. Para bytes, almacenamiento y entradas usa Consumo y CSV. La exportación continua a destinos externos sigue pendiente.