xAPI (Experience API) es un estándar de interfaz de especificación y datos para sistemas de aprendizaje en línea. Permite recopilar y compartir datos sobre la experiencia de los estudiantes, en una amplia variedad de actividades formativas, tanto en línea como sin conexión.
Nota: La integración de xAPI solo está disponible para el plan Enterprise.
Índice
Sentencias
Al integrar xAPI con sistemas de terceros, como LMS/LXP/LRS, Udemy Business puede enviar datos sobre actividades relativas a contenidos completados y al progreso de los estudiantes. Obtén más información sobre las sentencias de xAPI que envía Udemy Business.
Configuración de la integración
La configuración de Udemy Business para permitir publicar sentencias de xAPI en el sistema de LMS/LXP puede realizarse desde la interfaz de usuario de administración en Udemy Business una vez que todo esté configurado también en el sistema de LMS/LXP. A continuación indicamos los pasos que deben seguirse*
*Ten en cuenta que los pasos 1 y 2 deben realizarse en el sistema de LMS/LXP.
Paso 1: Registrar Udemy Business como aplicación de API en tu LMS/LXP y generar las credenciales de cliente
Tienes que realizar este paso en tu LMS/LXP. Ve al módulo de administración de tu sistema LMS/LXP para configurar la integración de xAPI. Debería aparecer una opción para registrar una aplicación de cliente y generar un ID de cliente y una clave secreta de cliente para la aplicación de API.
Al generar las credenciales de cliente, asegúrate de que el acceso se configura en xapi:write. (Nota: Si no se establece así, no se enviarán las sentencias de xAPi desde Udemy Business al sistema de LMS/LXP.)
Puedes ponerte en contacto con el administrador de tu LMS/LXP para realizar este paso.
Paso 2: Proporcionar el endpoint del token de OAuth y el endpoint de la sentencia de xAPI desde tu LMS/LXP
Tienes que realizar este paso en tu LMS/LXP. Tu instancia de LMS/LXP debería tener una URL para el endpoint del token de OAuth y para el endpoint de la sentencia de xAPI.
Udemy Business establece contacto con el endpoint del token de OAuth para generar tokens de autenticación al proporcionar el ID de cliente y la clave secreta de cliente que se generaron en el paso 1. Con este token, Udemy Business publicará a continuación las sentencias de xAPI en el endpoint de sentencias.
Ejemplo:
URL del endpoint del token: https://udemy.lms.com/v3/oauth2/access-token
URL del endpoint de sentencias de la xAPI: https://udemy.lms.com/v3/xapi/statements
Nota: Asegúrate de que las URL de los endpoints sean correctas. Ponte en contacto con tu proveedor de LMS/LXP para obtener las URL de endpoint correctas para tu instancia.
Paso 3: Configurar la integración de xAPI en Udemy Business
-
Dirígete a Gestión → Configuración → Integraciones de LMS/LXP
- Para los socios de LMS/LXP que no estén incluidos, selecciona "Otros", pon un nombre a la integración de LMS/LXP y selecciona "Guardar".
Nota: La siguiente página de configuración suele ser la habitual a la hora de activar las claves de API para acceder a las API de REST de Udemy Business (API de informes y de cursos), y también para configurar xAPI. Incluso si tu sistema LMS/LXP aparece en el menú desplegable, es posible que aún no sea compatible con la configuración de la integración de xAPI. - Cuando hayas seleccionado tu LMS y la opción Guardar, prosigue con la pantalla que aparece a continuación. En la primera sección obtendrás las claves de API para acceder a las API de REST estándar de Udemy Business (API de informes y de cursos).
- Selecciona Editar integración en la esquina superior derecha y activa la configuración de xAPI. La sección señalada a continuación se corresponde con las configuraciones de xAPI. Proporciona la URL del token de OAuth, el ID de cliente, el secreto de cliente y la URL de la sentencia de xAPI.
- Una vez introducidos los datos, haz clic en Comprobar credenciales para verificar que la instancia de Udemy Business puede comunicarse con la URL del token. Haz clic en Guardar para que se almacenen correctamente tus configuraciones. Nota: Con esta prueba únicamente se verifica que Udemy Business puede acceder correctamente al endpoint del token.
- La integración de xAPI con tu LMS/LXP ya está configurada y lista para su uso.
- La información sobre el contenido completado y el progreso de los estudiantes debería aparecer ahora de forma automática en el sistema de LMS/LXP prácticamente en tiempo real.
Configuración: Caso especial
Los pasos descritos anteriormente SOLAMENTE deben seguirse si tu LMS/LXP
- es compatible tanto con eventos de progreso como de contenidos completados y
- si acepta mbox (correo electrónico) como el identificador de actor.
Si la configuración de xAPI aparece en la página de administrador de Udemy Business con los datos del sistema LMS seleccionado, cualquier cambio de personalización (por ejemplo: si tu LMS/LXP solo es compatible con los eventos de contenidos completados o requiere un identificador de actor distinto del de mbox/correo electrónico) se habrá reflejado ya en la implementación de Udemy Business. No obstante, si tu LMS aparece en la lista pero sin ninguna sección de configuración de xAPI, o tienes un sistema de LMS que NO aparece en la lista y presenta requisitos especiales en cuando al identificador de actor o los verbos, ponte en contacto con el servicio de asistencia de Udemy Business para facilitar dichos requisitos.
Ventajas de xAPI
Udemy Business ya es compatible con las API de REST en cuestiones de generación de informes (actividad de los usuarios, actividad en los cursos y API de progreso de los usuarios). Estas API incluyen datos detallados sobre las transacciones (a nivel de clases) y datos resumidos agregados (a nivel de curso). Dado que hay distintos niveles de agrupaciones, estas API presentan retrasos de 8 a 14 horas para que los datos nuevos estén disponibles. Sin embargo, las sentencias de xAPI se generan prácticamente en tiempo real, con retrasos mínimos, aunque presentan menos información.
La siguiente tabla resume las diferencias esenciales entre la API de REST de informes estándar y el flujo de eventos de xAPI.
Criterios | xAPI | API de REST de informes |
Latencia | Proporciona datos prácticamente en tiempo real sobre eventos de actividades completadas. Baja latencia. | Los datos de eventos de actividades completadas están disponibles transcurridas unas 8 horas. |
Estándar | Sigue un estándar del sector a la hora de recopilar datos y generar informes sobre la experiencia de los estudiantes en un entorno de aprendizaje. | No sigue ningún modelo de datos estándar, por lo que podría requerir personalizaciones para trasladar los datos a distintos sistemas. |
Interoperabilidad | El modelo de datos estándar permite a los sistemas interactuar entre ellos fácilmente y ofrecer una visión completa de la experiencia de los estudiantes desde distintos lugares. | La interacción entre varios sistemas podría requerir asignaciones y conversiones de datos entre dichos sistemas. |
Consumo de recursos | Udemy Business envía los eventos (PUSH) al sistema de terceros, por lo que el sistema no tiene que solicitarlos (PULL). Gracias a ello, se consumen menos recursos y se evitan problemas de escalabilidad. | Requiere que el sistema de terceros solicite (PULL) los datos de Udemy. Si se incrementan las solicitudes y las cargas, podrían producirse problemas de tiempos de espera. |
Preparación para requisitos futuros | Se trata de un estándar del sector que evoluciona rápidamente. Nos permite ampliar los recursos a una amplia variedad de eventos de experiencia del estudiante (según los requisitos futuros). Por ejemplo, podemos llevar un seguimiento detallado de contenidos, interacciones, búsquedas, reseñas, etc. | Está limitado a eventos de progreso y contenidos completados a nivel de clase o curso, aunque es posible ampliarlo. No obstante, dicha ampliación puede conllevar más trabajo, ya que no hay estándares disponibles. |