JSON koppeling

Context

Wanneer je trainingen aanbiedt voor externe deelnemers, is het vaak wenselijk om je eigen website te koppelen aan Procademy. Zo combineer je de kracht van je eigen online zichtbaarheid met de technische mogelijkheden van Procademy. Dit biedt voordelen zoals:

Gebruik van je eigen vormgeving (styling)
Behouden van de regie over de oriëntatiefase van de deelnemer
Profiteren van de vindbaarheid van je website in zoekmachines

In dit scenario fungeert jouw website als het oriëntatiekanaal, waar de deelnemer zich informeert en een geschikte datum kiest. Procademy fungeert vervolgens als het afrekenplatform (de "kassa"), waar registratie en (indien van toepassing) betaling plaatsvinden.

Doel van de koppeling

Je haalt de actuele boekingsinformatie van trainingen real-time op via een JSON-feed uit Procademy. Je bepaalt zelf hoe deze informatie getoond wordt binnen je CMS of website. Denk aan data, locaties, beschikbaarheid en directe aanmeldlinks.

Voordelen:

Volledige vrijheid in opmaak en gebruikservaring
Data altijd up-to-date, inclusief beschikbaarheid
Geschikt voor professionele, schaalbare toepassingen

Nadelen:

Vereist meer technische kennis of betrokkenheid van een webdeveloper
Iets hogere implementatiedrempel

Werking JSON-koppeling

Met de JSON-koppeling wordt de reguliere "Catalogus detailpagina" van Procademy overgeslagen. Omdat de datum-locatie keuze al plaats kan vinden op de eigen website. In plaats van de “Catalogus detailpagina” landt de deelnemer direct op een vooraf ingevulde winkelwagenpagina binnen Procademy, waar de gekozen training en bijbehorende data zijn weergegeven.

Procesvisualisatie:

De externe website toont op basis van JSON de beschikbare trainingsdata.
De deelnemer selecteert een optie en wordt doorgestuurd naar de winkelwagenpagina in Procademy.
Op deze pagina kan eventueel een kortingscode worden ingevuld en wordt een samenvatting van de transactie weergegeven.
Vervolgens kan de deelnemer inloggen of registreren en een betaalmethode kiezen.

Inhoud van de JSON-data

Elke JSON-call bevat een lijst met trainingsgroepen met de volgende gegevens:

Veld	Beschrijving
`title`	Titel van de training inclusief data, tijd en locatie
`location`	Lijst van locaties per bijeenkomst
`dates`	Lijst met datum-tijdcombinaties van de bijeenkomsten
`available`	Aantal beschikbare plekken (real-time)
`url_option`	Link naar specifieke groep/optie
`url_checkout`	Link naar directe winkelwagenpagina

Voorbeeld-JSON:

CODE

[{
  "title": "Traumasensitief werken / 9 okt, 23 okt en 13 nov 2024 / 09:00-13:00 uur / Rijswijk",
  "location": ["Derde etage", "Derde etage", "Derde etage"],
  "dates": ["09-10-2024 09:00 - 13:00", "23-10-2024 09:00 - 13:00", "13-11-2024 09:00 - 13:00"],
  "available": 3,
  "url_option": "https://academie.jeugdformaat.nl/catalog/product/traumasensitief-werken?option=1407",
  "url_checkout": "https://academie.jeugdformaat.nl/catalog/product/traumasensitief-werken?checkout=1407"
}]

Ophalen van de JSON-data

Procademy stelt JSON-data per training automatisch beschikbaar. Deze kan worden opgehaald door een trainingscatalogus-URL aan te vullen met ?json=true.

Voorbeeld per training:

CODE

https://academie.jeugdformaat.nl/catalog/product/traumasensitief-werken?json=true

Voorbeeld per categorie:

CODE

https://academie.jeugdformaat.nl/catalog/category/alletrainingen?json=true

Of:

CODE

https://academie.jeugdformaat.nl/catalog/category/jeugdprofessionals?json=true

Let op: Beschrijvingen binnen een categorie kunnen HTML-opmaak bevatten die nog niet opgeschoond is.

Implementatiestappen

Koppeling ophalen via URL – Training openen in Procademy catalogus en ?json=true toevoegen.
Toevoegen JSON-URL in CMS – Per training wordt de JSON-link toegevoegd.
UX bepalen – Bepalen hoe de data visueel wordt weergegeven op detail- en overzichtspagina’s.
UX implementeren – Ontwikkeling van de weergave op de website.
Testen – Controleren of data juist wordt opgehaald en weergegeven.

Best Practices voor het tonen van trainingsdata via JSON

Een goede weergave van trainingsinformatie op je website draagt bij aan een soepele gebruikerservaring én aan conversie. Onderstaande richtlijnen helpen om de integratie met de Procademy JSON-feed optimaal in te richten.

1. Locatieweergave

In de meeste gevallen vinden alle bijeenkomsten van een training plaats op dezelfde locatie. Om verwarring te voorkomen:

Toon alleen de locatie van de eerste bijeenkomst.
Het weergeven van meerdere, identieke locaties leidt vaak tot onnodige herhaling en onduidelijkheid.

2. Veel bijeenkomsten? Gebruik een ‘Meer tonen’-optie

Wanneer een training uit veel bijeenkomsten bestaat:

Laat in eerste instantie alleen de eerste 2 à 3 data zien.
Voeg een "Meer tonen"-knop toe om extra data op verzoek zichtbaar te maken.

Dit houdt de pagina overzichtelijk en gebruiksvriendelijk.

3. Beschikbaarheid slim communiceren

De manier waarop je beschikbaarheid toont, beïnvloedt het gedrag van de bezoeker. Gebruik onderstaande vuistregels:

Minder dan 3 plekken beschikbaar
➤ Toon een marketingboodschap zoals:
“Let op: nog slechts 2 plekken beschikbaar!”
Meer dan 3 plekken beschikbaar
➤ Vermijd het tonen van de exacte aantallen. Voor deelnemers is dit vaak niet relevant en het kan zelfs afschrikken (bijv. “Ben ik de enige die zich heeft aangemeld?”).

4. Geen beschikbaarheid? Toon ‘Volgeboekt’ en bied een alternatief

Als er geen beschikbare sessies meer zijn voor een training:

De JSON-feed levert in dat geval een lege lijst terug.
Toon in de training-detailpagina dan duidelijk de status:
“Volgeboekt” of “Nieuwe data volgen binnenkort”.

Tip:
Bied een wachtlijstformulier aan, zodat geïnteresseerden zich kunnen aanmelden voor toekomstige data.

Let op: Procademy biedt momenteel geen wachtlijstfunctionaliteit voor externe deelnemers (alleen voor interne, ingelogde gebruikers). Gebruik hiervoor dus een extern formulier, bijvoorbeeld via je eigen CMS of een formuliertool zoals Typeform, Google Forms of Formulieren van je websiteplatform.

5. Highlight de eerstvolgende boekbare training

Om bezoekers snel te helpen bij het maken van een keuze, is het aan te raden om bovenaan de trainingspagina direct de informatie van de eerstvolgende boekbare training te tonen.

Toon hierbij bijvoorbeeld de datum, tijd, locatie en een directe Boek nu-knop.
Dit versnelt het keuzeproces en verhoogt de kans op conversie.
De aanvullende trainingsopties kunnen vervolgens verderop op de pagina worden weergegeven of onder een “Bekijk alle data” sectie.

Voordeel:
De belangrijkste actie (inschrijven voor de eerstvolgende mogelijkheid) is meteen zichtbaar, zonder dat de bezoeker hoeft te scrollen of opties hoeft te vergelijken.

Lager op de pagina kan je vervolgens alle opties tonen (of een aantal)

Categorie-JSON ondersteuning

Naast individuele trainingen ondersteunt Procademy ook het ophalen van meerdere trainingen binnen een categorie via een categorie-JSON-call.

Zie:
https://academie.jeugdformaat.nl/catalog/category/alletrainingen?json=true

Beveiliging

De JSON-data is publiek toegankelijk en bevat enkel informatie over trainingen die ook via de publieke catalogus te vinden zijn.

Validatie en foutafhandeling

Op dit moment niet van toepassing.

Prestatievereisten

Data moet real-time beschikbaar zijn.
Een nieuwe geplande sessie in Procademy wordt direct opgenomen in de JSON-output.
Beschikbaarheid wordt direct bijgewerkt na een inschrijving.

Beperkingen en aandachtspunten

Naam van de trainer wordt niet meegegeven in de JSON-output.
Als een training niet meer beschikbaar is, dan wordt niet meer getoond in de JSON-output