Configuration : cas particuliersxAPI (Experience API) est une norme d'interface de données et de spécifications pour l'apprentissage en ligne permettant de collecter et de partager des données sur l'expérience d'un participant, dans le cadre d'un large éventail d'activités d'apprentissage, en ligne et hors ligne.
Remarque : L'intégration xAPI est uniquement disponible avec l'Abonnement Enterprise.
Table des matières
Déclarations
Grâce à l'intégration xAPI avec un système tiers comme un LMS/LXP/LRS, Udemy Business envoie les activités relatives à la progression d'un participant et à l'achèvement d'un cours par ce dernier. En savoir plus sur les déclarations xAPI envoyées par Udemy Business.
Configuration de l'intégration
Il est possible de configurer Udemy Business pour publier les déclarations xAPI vers un LMS/LXP pris en charge à partir de l'interface utilisateur d'administration dans Udemy Business dès lors que la configuration connexe a été réalisée sur le LMS/LXP. Voici les étapes à suivre*
*Notez que les étapes 1 et 2 doivent être effectuées au niveau du LMS/LXP.
Étape 1 : Enregistrez Udemy Business en tant qu'application API dans votre LMS/LXP et générez les identifiants client
Cette étape s'effectue dans votre LMS/LXP. Consultez le module d'administration de votre LMS/LXP pour configurer une intégration xAPI. Vous devriez avoir la possibilité d'enregistrer une application client et de générer un identifiant client et un secret client pour l'application API.
Lors de la génération des identifiants client, assurez-vous que le périmètre d'accès est défini sur xapi:write. (Remarque : Sans ce périmètre, les déclarations xAPI envoyées depuis Udemy Business vers le LMS/LXP échoueront.)
Consultez l'administrateur de votre LMS/LXP avant d'effectuer cette étape.
Étape 2 : Obtenez les points de terminaison du jeton OAuth et de la déclaration xAPI à partir de votre LMS/LXP
Cette étape s'effectue dans votre LMS/LXP. Votre instance LMS/LXP doit avoir une URL pour les points de terminaison du jeton OAuth et de la déclaration xAPI.
Udemy Business appelle le point de terminaison du jeton OAuth pour générer des jetons d'authentification en fournissant l'identifiant client et le secret client créés lors de l'étape 1. En utilisant le jeton généré, Udemy Business va ensuite PUBLIER les déclarations xAPI au point de terminaison de la déclaration.
Exemple :
URL du point de terminaison du jeton : https://udemy.lms.com/v3/oauth2/access-token
URL du point de terminaison de la déclaration xAPI : https://udemy.lms.com/v3/xapi/statements
Remarque : Assurez-vous que les URL des points de terminaison sont exactes. Vérifiez au niveau de votre LMS/LXP pour obtenir les URL de point de terminaison correctes pour votre instance.
Étape 3 : Configurez l'intégration xAPI dans Udemy Business
-
Accédez à Gérer → Paramètres → Intégrations LMS/LXP
-
Pour les partenaires LMS/LXP non inclus, sélectionnez « Autre », nommez l'intégration LMS/LXP et cliquez sur « Enregistrer ».
Remarque : La page de configuration ci-dessous est celle qui s'affiche généralement pour l'activation des clés API pour accéder aux API REST Udemy Business (API de cours et de génération de rapports) et pour la configuration de xAPI. Même si votre LMS/LXP figure dans le menu déroulant, il est possible que vous ne puissiez pas encore configurer l'intégration xAPI pour celui-ci.
- Une fois que vous avez sélectionné votre LMS et cliqué sur Enregistrer, passez à l'écran ci-dessous. La première section indique les clés API permettant d'accéder aux API REST standard pour Udemy Business (API de cours et de génération de rapports).
- Sélectionnez Modifier l'intégration en haut à droite et basculez la configuration xAPI sur Activée. La section en surbrillance ci-dessous correspond aux configurations xAPI. Spécifiez l'URL du jeton OAuth, l'identifiant client, le secret client et l'URL de la déclaration xAPI.
-
Une fois ces éléments fournis, cliquez sur Tester les identifiants pour vérifier que l'instance Udemy Business est capable d'atteindre l'URL du jeton. Cliquez sur Enregistrer pour stocker vos configurations. Remarque : Ce test vérifie seulement qu'Udemy Business est capable d'accéder au point de terminaison du jeton.
-
Votre intégration xAPI avec votre LMS/LXP est maintenant configurée et prête à être utilisée.
- La progression et l'achèvement des cours par le participant devraient maintenant être transmis automatiquement au LMS/LXP quasiment en temps réel.
Configuration : cas particulier
Les étapes décrites ci-dessus doivent être suivies UNIQUEMENT lorsque votre LMS/LXP
- prend en charge les événements en cours et terminés et
- accepte le mbox (e-mail) comme identifiant de l'acteur.
Si la configuration xAPI s'affiche sur la page d'administration d'Udemy Business pour votre LMS sélectionné, alors tout changement personnalisé (par exemple : votre LMS/LXP ne prend en charge que les événements d'achèvement ou nécessite un identifiant d'acteur différent de mbox - e-mail) serait déjà pris en charge par l'implémentation d'Udemy Business. Cependant, si votre LMS apparaît dans le menu, mais qu'il n'a pas de section de configuration xAPI ou si vous disposez d'un LMS personnalisé qui NE figure PAS dans ce menu et qui présente des exigences particulières concernant l'identifiant de l'acteur et/ou les verbes, contactez le support Udemy Business pour spécifier ces exigences.
Avantages de xAPI
Udemy Business prend déjà en charge les API REST à des fins de génération de rapports (API pour l'activité des utilisateurs, l'activité des cours des utilisateurs et la progression des utilisateurs). Ces API comprennent à la fois des données de transaction détaillées (au niveau d'une session) et des données récapitulatives agrégées (au niveau d'un cours). En raison de ces différents niveaux d'agrégation, ces API présentent un décalage compris entre 8 et 14 heures pour la mise à disposition de nouvelles données. En revanche, les déclarations xAPI se font quasiment en temps réel avec un décalage minimal, mais fournissent moins d'informations.
Le tableau ci-dessous résume les principales différences entre l'API REST standard de génération de rapports et le flux d'événements xAPI.
| Critères | xAPI | API REST de génération de rapports |
| Décalage | Fournit une publication quasiment en temps réel des événements d'achèvement. Peu de décalage. | Décalage d'environ 8 heures avant que les événements d'achèvement ne soient disponibles. |
| Norme | Suit une norme du secteur pour la saisie et la génération de rapports sur l'expérience d'un participant dans un environnement d'apprentissage. | Ne suit pas de modèle de données standard et peut donc nécessiter des personnalisations pour transférer les données vers différents systèmes. |
| Interopérabilité | Le modèle de données standard permet aux systèmes d'interagir facilement les uns avec les autres et de créer une vue à 360 degrés de l'expérience du participant à partir de plusieurs endroits. | L'interaction entre plusieurs systèmes nécessiterait la traduction et le mappage des données entre les systèmes participants. |
| Consommation des ressources | Udemy Business POUSSE les événements vers le système tiers, de sorte que ces systèmes n'ont pas à les EXTRAIRE à partir d'Udemy Business. Cela permet de limiter la consommation de ressources et les problèmes d'évolutivité. | Nécessite des systèmes tiers pour EXTRAIRE les données à partir d'Udemy. L'augmentation des demandes et des charges utiles peut entraîner des problèmes d'expiration. |
| Pérennisation | Norme de secteur en plein essor. Nous permet d'étendre notre champ d'action à un large éventail d'événements liés à l'expérience du participant (à l'avenir), par exemple le suivi de la progression dans un contenu, les interactions, les recherches, les avis, etc. | Actuellement limité aux événements d'achèvement et de progression au niveau des sessions et des cours, bien qu'une extension soit possible. Cette extension pourrait toutefois nécessiter un travail relativement plus important, car il n'existe aucune norme. |