Medir un directo
Quién estuvo en tu directo, minuto a minuto: si tenía tu página a la vista, si el vídeo corría y si lo oía, cuántos seguían en cada escena y cuántos de ellos compraron. Sin peticiones nuevas y sin tocar la velocidad de tu página.
Después de un directo la pregunta no es cuánta gente entró, sino cuánta se quedó y en qué momento se fue. alloop lo mide por persona y por minuto desde tu propia página del directo, y te lo da en un informe que puedes pedir a tu IA el mismo día.
Qué mide
Cada minuto del directo, para cada persona, alloop apunta cinco cosas:
| Capa | Qué quiere decir |
|---|---|
| Presente | Tenía tu página abierta y viva ese minuto |
| Visible | La pestaña estaba a la vista al menos la mitad del minuto (no en segundo plano) |
| Reproduciendo | El vídeo estaba en marcha |
| Con sonido | El vídeo estaba en marcha y sin silenciar |
| Con foco | Estaba en tu página, no en otra ventana |
Con eso el informe te da:
- La curva del directo, minuto a minuto, con cada capa por separado y la escena que se veía.
- Retención por escena: cuántas personas había al empezar cada escena, frente a las que llegaron y frente al pico, y cuántas se fueron durante ella.
- Compras de los que estaban: quién compró durante el directo y en las horas siguientes (3 por defecto), en qué minuto, y qué porcentaje de los presentes en cada escena acabó comprando.
- Cada persona: minutos en cada capa, % de atención, reingresos, en qué escena se fue, el dispositivo y si compró.
- Páginas congeladas: personas cuya página dejó de responder estando a la vista.
Las escenas son las tuyas. Si tu directo no tiene oferta, no hay nada que configurar: el informe sale igual, sin esa parte.
Ponerlo en tu página
Si tu página usa el motor de escenas (alloop-live.js),
ya está: la medición viene encendida y viaja en las comprobaciones que el motor ya hace cada
~20 segundos. No hay peticiones nuevas, solo un aviso al cerrar la pestaña.
El reproductor se detecta solo:
| Tu vídeo | Qué se mide |
|---|---|
| YouTube montado por el motor | Las cinco capas |
Un <video> propio (HLS, Mux, Bunny HLS…) | Las cinco capas: measure: { video: "#mi-video" } |
| Otro reproductor con API | Las cinco capas, con un adaptador tuyo: AlloopLive.adapter(fn) |
| Un iframe sin API (Zoom, Meet, Vimeo, Bunny…) | Presente, visible y foco. «Reproduciendo» y «con sonido» salen vacíos, no a cero |
<script>
AlloopLive.adapter(function () {
return { playing: miPlayer.isPlaying(), audible: !miPlayer.muted, position: miPlayer.time };
});
</script>Si tu página ya tiene su propio motor de escenas, carga alloop-live.js en modo «solo medir»
(measureOnly: true): no toca tus escenas, tu vídeo ni tu chat. Tu comprobación de /stage añade
AlloopLive.measure.query() a la dirección y avisa del resultado con AlloopLive.measure.sent(ok).
Pedir el informe
Desde tu IA conectada a alloop (ChatGPT, Claude, Cursor…):
- «Enséñame mis directos» →
live_list - «¿Cómo fue el directo de ayer? ¿En qué escena se fue la gente?» →
live_report - «Dame quién estuvo más de 20 minutos y no compró» →
live_people
Si la página del directo está abierta todo el día
Un directo empieza cuando llega la primera persona a una sala vacía y termina tras 30 minutos sin
nadie. Si tu sala es una página con visitas a todas horas (tu home, una página de venta), pide el
informe con la hora del directo: «el directo del lunes de 19:00 a 21:00». Tu IA lo recorta a esa
ventana (since y until). Y una sala que nunca se vacía empieza un directo nuevo cada 12 horas.
Cómo sabes que funciona
Abre tu página del directo en el móvil y déjala abierta un par de minutos. Pregunta a tu IA por tus directos: aparece uno «en marcha» con al menos una persona. Pon la pestaña en segundo plano un minuto y vuelve: en el informe, ese minuto sale presente pero no visible.
La parte incómoda
Las personas que ven tu directo en YouTube, fuera de tu página, no están aquí. Esto mide tu página. El recuento de YouTube es otra cosa y, como YouTube también cuenta a quien lo ve insertado en tu página, las dos cifras no se suman.
Un móvil bloqueado no cuenta como presente. Cuando el teléfono suspende la página no hay forma de saber si la persona sigue escuchando. Si vuelve, se ve como un reingreso.
«Con sonido» no es «escuchando». Sabemos que el vídeo sonaba, no que la persona estuviera delante. Por eso las capas se leen juntas: visible y con sonido es atención; solo con sonido, de fondo.
Quien rechaza la medición no aparece. Si una persona ha pedido no ser medida en tu web, el directo tampoco la mide.
Errores comunes
| Síntoma | Causa probable | Arreglo |
|---|---|---|
| «Reproduciendo» sale vacío | El vídeo es un iframe sin API (Vimeo, Bunny, una reunión) | Es lo esperado. Con un <video> propio o un adaptador, se mide |
| Con YouTube insertado a mano, «reproduciendo» vacío | Al iframe le falta enablejsapi=1 | Añádelo a la dirección del vídeo |
| No aparece ningún directo | La página no carga alloop-live.js, o la medición está apagada (measure: false) | Revisa la página; si la apagamos nosotros, te lo habremos dicho |
| Hay menos personas que en el chat | El chat cuenta conexiones (pestañas); esto cuenta personas | Es lo esperado: una persona con dos pestañas es una |
Preguntas que nos hacen
¿Hace más lenta mi página? No. No hay peticiones nuevas: los datos van en la comprobación que el motor ya hace cada ~20 segundos, y lo que añade pesa menos de 120 bytes. La API de YouTube, si hace falta, se carga después de que tu página haya terminado de cargar.
¿Se guarda lo que escribe la gente o su IP? No. Por persona se guarda un identificador anónimo, los minutos de cada capa y el tipo de dispositivo.
¿Puedo apagarlo?
Sí, en tu página con measure: false. Y nosotros podemos apagarlo para una sala o para toda tu
cuenta sin tocar tu página.
¿Te atascas? Pregúntale a tu IA
Pregúntale a tu IA
Esta documentación está pensada para leerse con una IA al lado. Abre tu asistente con el contexto de alloop ya cargado y pregúntale lo que necesites, en tu idioma.
Para qué NO sirve: una IA no ve tu panel, tus pagos ni tus datos, y puede equivocarse. Si un ingreso no aparece, algo toca tu producción o necesitas una respuesta oficial, escríbenos: esto no sustituye al soporte.
Siguiente paso
Conecta tu IA a alloop con el conector para pedir el informe el mismo día del directo.
Cambiar la página durante el directo
Una sola página para todo el evento: cuenta atrás antes, el vídeo mientras das la clase y tu oferta al terminar. Tú pulsas un botón y cambia para todo el mundo, sin que nadie recargue nada.
Referencia de API
El mapa completo de la API de alloop-tracking: los 56 endpoints que tú o tu equipo técnico podéis usar. Todo lo interno (administración, panel) queda fuera a propósito.