Base de connaissances Rise Up

Deep links : envoyer les utilisateurs directement vers un écran de Rise Up

  • Mise à jour

 

Aperçu

Un deep link est un lien https standard qui ouvre l'application mobile Rise Up directement sur un écran spécifique — une formation, une ressource, une conversation — plutôt que d'ouvrir le site web. Il fonctionne exactement comme n'importe quelle autre adresse web : aucune intégration spéciale, aucun SDK, ni configuration n'est nécessaire.

Les deep links sont utiles chaque fois que vous souhaitez envoyer un apprenant directement vers un contenu depuis l'extérieur de l'application — par exemple dans une campagne d'emailing, une notification push, une communication interne, ou un lien partagé depuis un autre outil.

 

Éléments clés
  • Adresse de la plateforme : le domaine de votre propre plateforme Rise Up (par exemple, https://your-platform.riseup.ai). Chaque deep link doit commencer par cette adresse.
  • Chemin (path) : la partie du lien après le domaine qui identifie l'écran à ouvrir (par exemple, /Training/view/123).
  • Identifiant ({id}) : un espace réservé dans le chemin qui doit être remplacé par l'identifiant réel de l'élément — une formation, une session, une ressource, etc.
  • Comportement de repli : la logique qui ouvre la plateforme web dans un navigateur lorsque l'application n'est pas installée, plutôt que de faire échouer le lien.
  • Schéma personnalisé (riseup://riseup) : un lien qui lance simplement l'application, sans ouvrir un écran spécifique.

 

I — Créer un deep link

Un deep link est composé de deux parties : l'adresse de votre plateforme, et un chemin pointant vers un écran spécifique.

  1. Commencez par l'adresse de votre propre plateforme, par exemple https://your-platform.riseup.ai.
  2. Ajoutez l'un des chemins listés dans la Section III, par exemple /Training/view/123.
  3. Remplacez tout espace réservé dans le chemin ({id}, {stepId}, {sessionId}, {moduleId}) par l'identifiant de l'élément que vous souhaitez ouvrir.
  4. Utilisez le lien final exactement comme n'importe quelle autre URL — dans un email, une notification, un message, ou un appel depuis votre propre application. Aucune configuration supplémentaire n'est nécessaire.
Le lien doit utiliser le domaine de votre propre plateforme
Un deep link n'ouvre l'application que s'il pointe vers l'adresse de votre propre plateforme Rise Up. Un lien construit sur un autre domaine — y compris une autre plateforme Rise Up — n'ouvrira pas l'application.

Résultat :   Le lien se comporte comme une adresse web normale partout où vous le placez, et dirige l'application vers l'écran cible lorsqu'il est cliqué.

 

II — Ce qui se passe lorsqu'un utilisateur clique sur le lien

Le lien s'adapte automatiquement à la situation de l'utilisateur — il n'y a rien à configurer pour chaque scénario.

  • L'application est installée — l'application s'ouvre directement sur l'écran cible.
  • L'application n'est pas installée — le lien ouvre la plateforme web Rise Up dans le navigateur à la place, comme n'importe quelle URL normale.
  • L'utilisateur n'est pas connecté — il lui est d'abord demandé de se connecter, puis il atterrit automatiquement sur l'écran cible. Rien n'est perdu.
Bon à savoir
Comme le même lien couvre les trois cas de figure, vous pouvez réutiliser un même deep link sur plusieurs canaux (email, notifications, chat) sans avoir besoin de versions distinctes pour les utilisateurs de l'application et ceux du web.

 

III — Liens disponibles

Ajoutez l'adresse de votre propre plateforme devant chaque chemin ci-dessous, et remplacez {id} (ou l'espace réservé équivalent) par l'identifiant de l'élément.

Formations

Chemin Ouvre
/Training/trainings Formations
/Training/view/{id} Détail de la formation
/Training/view/{id}/step/{stepId} Formation, sur une étape spécifique
/Training/view/{id}/session/{sessionId} Session
/Training/view/{id}/sessions/{moduleId} Liste des sessions d'un module
/TrainingBoard/signAttendanceEmail/{sessionId} Signature de la feuille de présence

Parcours de formation et objectifs

Chemin Ouvre
/Training/trainingpaths Mes parcours de formation
/Training/trainingpaths/{id} Détail du parcours de formation
/Objective/objectives Objectifs

Catalogue

Chemin Ouvre
/Catalog Catalogue
/Catalog/training/{id} Détail de la formation dans le catalogue

Ressources

Chemin Ouvre
/Catalog/resources Ressources
/Catalog/resources/{id} Ressource
/Catalog/resources/folder/{id} Dossier de ressources

Communauté

Chemin Ouvre
/Community La communauté
/Community/talk/{id} Conversation

Certificats

Chemin Ouvre
/CertificateAdministration/view/{id} Certificat

 

IV — Ouvrir l'application directement

Si vous souhaitez simplement lancer l'application sans cibler un écran particulier, utilisez :

riseup://riseup

Cela fonctionne à la fois sur iOS et Android.

Le schéma riseup:// ne se limite pas au lancement de l'application sans cible — il prend également en charge n'importe quel chemin listé dans la Section III, de la même manière qu'un deep link classique. Il suffit d'ajouter le chemin après riseup://riseup.

Type de lien Exemple
Deep link classique https://your-platform.riseup.ai/CertificateAdministration/view/{id}
Schéma personnalisé riseup://riseup/CertificateAdministration/view/{id}
Aucun repli si l'application n'est pas installée
Contrairement à un deep link https classique, riseup:// force l'ouverture du lien uniquement dans l'application. Si l'application n'est pas installée sur l'appareil, rien ne se passe — il n'y a pas de repli vers la plateforme web.

FAQ et dépannage

  • Problème : Le clic sur le lien ouvre un navigateur au lieu de l'application.
    Solution : L'application n'est probablement pas installée sur l'appareil — il s'agit d'un comportement attendu, et le lien ouvre la plateforme web à la place. Si l'application est installée et que le problème persiste, vérifiez que le lien utilise bien le domaine de votre propre plateforme (Section I) plutôt qu'une adresse générique ou incorrecte.

    Problème : Le lien ouvre l'application mais pas sur l'écran attendu.
    Solution : Vérifiez que le chemin correspond exactement à l'un de ceux listés dans la Section III, et que tout espace réservé ({id}, {stepId}, {sessionId}, {moduleId}) a été remplacé par un identifiant valide et existant.

    Problème : Le lien ne fait rien pour un utilisateur non connecté.
    Solution : Cela ne devrait pas se produire — l'utilisateur devrait être invité à se connecter, puis redirigé automatiquement vers l'écran cible. S'il atterrit sur un écran d'accueil générique à la place, vérifiez que le lien et l'identifiant sont toujours valides.

    Problème : Un lien riseup:// ne fait rien au clic.
    Solution : L'application n'est pas installée sur l'appareil. Contrairement à un deep link https classique, riseup:// n'a pas de repli vers la plateforme web — si vous avez besoin de ce repli, utilisez plutôt le deep link https classique (Section III).
     
  • Ai-je besoin d'une intégration spéciale pour utiliser les deep links ?
    — Non. Un deep link est un lien https normal. Utilisez-le exactement comme n'importe quelle autre URL, dans un email, une notification, ou un lien depuis votre propre application.

    Puis-je utiliser un deep link sur n'importe quel domaine ?
    — Non. Le lien doit être construit sur l'adresse de votre propre plateforme Rise Up. Un lien sur un autre domaine n'ouvrira pas l'application.

    Que se passe-t-il si l'application n'est pas installée ?
    — Le lien ouvre la plateforme web Rise Up dans le navigateur à la place, comme une adresse web normale.

    Le deep link fonctionne-t-il si l'utilisateur n'est pas connecté ?
    — Oui. Il lui est d'abord demandé de se connecter, puis il atterrit automatiquement sur l'écran cible — rien n'est perdu.

    Existe-t-il un moyen d'ouvrir simplement l'application sans lier un contenu spécifique ?
    — Oui, utilisez riseup://riseup. Cela fonctionne à la fois sur iOS et Android.
  • Contacter le support
     

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 0

Vous avez d’autres questions ? Envoyer une demande