Wat is een deeplink?
Een deeplink is een link die navigeert naar een specifieke pagina binnen de academy, in plaats van de standaard hoofdpagina. Hiermee kun je gebruikers direct doorverwijzen naar een leeractiviteit of thema binnen de online academy.
Hierbij kun je kiezen voor een gewone link, of een link die werkt via Single sign-on (SSO). Daarnaast kan er altijd gekozen worden om de URL te delen met gebruikers, of een QR-code te genereren die gebruikers kunnen scannen.
Deeplinken is mogelijk naar de volgende soorten leeractiviteiten:
Bijeenkomst
E-learning
Examen
Inleveropdracht
Learning Playlist
Microlearing
Samenvatting
Podcast
Hoe maak ik een deeplink naar een leeractiviteit?
Je maakt de deeplink als beheerder via de 'Delen'-tab van de leeractiviteit.
Directe link
Via de tab 'Directe link' kun je een link maken waar gebruikers met hun e-mailadres en wachtwoord op kunnen inloggen. Deze link kun je kopiëren via het kopieer-icoontje. Daarnaast kun je de QR-code downloaden, die gebruikers met hun telefoon kunnen scannen.
Als de gebruiker de Rakoo-app op de telefoon geïnstalleerd heeft, wordt de app geopend en wordt de gebruiker in de app direct doorverwezen naar de juiste leeractiviteit.
Single sign-on link
Via 'Single sign-on link' kun je een link maken waarmee gebruikers via SSO kunnen inloggen. Selecteer je Single sign-on provider, daarna wordt de SSO link automatisch voor je gegenereerd. Deze link kun je kopiëren via het kopieer-icoontje. Daarnaast kun je de QR-code downloaden, die gebruikers met hun telefoon kunnen scannen.
Let op!
Zorg ervoor dat in de SSO-integratie de 'Inloggen met 'knop''-toggle aan staat.
Als deze niet aan staat, werkt de deeplink niet.
Hoe maak ik een deeplink naar een thema?
Naast een deeplink naar een leeractiviteit, is het ook mogelijk om een deeplink naar een thema te maken. Dit kan alleen als er gebruik wordt gemaakt van SSO.
Hier vind je een Excel-bestand, waarin je zelf de juiste waarden kunt plakken. Er wordt zo direct een deeplink samengesteld. Verderop in dit artikel lees je hoe je aan de juiste waarden komt voor het maken van een deeplink naar een thema.
Het deeplinken naar een thema werkt alleen als als de 'Ontdek' feature aan staat voor de Bibliotheek.
Een deeplink naar een thema ziet er bijvoorbeeld zo uit:
Onderdelen
In het voorbeeld zie je in onderstaande volgorde drie variabelen:
integratieId = de specifieke ID van jullie SSO-integratie
themeId = de specifieke ID van het thema
context = user of admin (meestal user)
Hoe kom ik aan de juiste informatie voor mijn deeplinks?
Als de SAML-integratie voor jullie online academy aan staat, zie je op de inlogpagina een button met bijvoorbeeld 'Inloggen met Microsoft' staan.
Klik met je rechtermuisknop op 'Inloggen met Microsoft' en kies vervolgens voor 'Linkadres kopiëren'. Je hebt nu het grootste deel van de URL dat je nodig hebt. Plak deze link in bijvoorbeeld een notitie zodat je de URL kunt bekijken.
Achter &themeId= vul je het themeId in van het thema waar je naar wil deeplinken. Zoek het themeId van het betreffende thema op. Open hiervoor het thema via je beheerdersaccount. Het themeId vind je in de URL, zie hiervoor de geselecteerde tekens in de afbeelding hieronder.
Achter &context= zie je om welke context het gaat; user of admin.
Let op!
Zorg ervoor dat de ID van het thema op de juiste plek in de link staat; &themeId=... hoort na het ID van de integratie te staan. De link sluit af met &context=USER (of ADMIN).
Hoe werkt het gebruik van deeplinks op de smartphone
Als een gebruiker een deeplink via zijn smartphone opent, krijgt hij de eerste keer de keuze tussen doorgaan in de browser, of openen in de app. De keuze die hier gemaakt wordt, bepaalt ook hoe een deeplink een volgende keer geopend wordt.
Daarnaast is het belangrijk om de deeplink te openen via de browser app, en niet via een in-app browser van een andere app. Deeplinks worden het beste ondersteund in een browser die up-to-date is.