Skip to main content
Documentatie
Documentatie
Peakon
Laatst bijgewerkt: 2024-12-27
Concept: API voor het exporteren van ruwe gegevens

Concept: API voor het exporteren van ruwe gegevens

Met de functie Gegevens exporteren kan uw organisatie niet-geaggregeerde enquêteantwoorden van Peakon exporteren naar een externe tool. Bijvoorbeeld: Workday Prism, Workday People Analytics (VIBE Index) of uw eigen business intelligence (BI)-tool.
U kunt de API voor het exporteren van onbewerkte gegevens gebruiken om uw eigen, aangepaste analyses te maken.
Door ruwe data te exporteren, kunt u het verhaal achter de statistieken ontdekken en zinvolle inzichten gebruiken om betere beslissingen te nemen over uw personeel en zo uw organisatie te verbeteren.
U kunt de geaggregeerde API gebruiken wanneer u dezelfde gegevens (scores, deelname, benchmarks) wilt ophalen als die u in het dashboard ziet. De gegevens voldoen aan de vertrouwelijkheidsinstellingen en kunnen worden opgesplitst in segmenten en dergelijke.

Gegevens exporteren

Met gegevensexport kunt u enquêtescores en -antwoorden uit alle vragenreeksen extraheren, evenals het identificeren van e-mailadressen of de ID van uw medewerkers. Hiermee kunnen nieuwe en bestaande klanten gegevens exporteren naar hun BI-tool en aangepaste gegevensvisualisaties maken met niet-geaggregeerde scoregegevens.
Gegevensexport is:
  • Ontworpen voor bedrijven met de juiste waarborgen en people analytics-teams die toegang willen hebben tot ruwe enquêtegegevens.
  • Ontworpen voor data-analisten en ontwikkelaars om automatisch gegevens van Peakon in te voeren in tools van derden.
  • Alleen beschikbaar op bedrijfsniveau. Het is niet mogelijk om de export alleen op een subset van werknemers toe te passen.
  • Op aanvraag beschikbaar voor alle klanten.
Wanneer u deze functie inschakelt, kunt u de privacyberichten op de landingspagina's van enquêtes voor medewerkers aanpassen. Hiermee krijgen deelnemers aan het onderzoek duidelijkheid en transparantie over hoe hun gegevens worden beheerd en beschermd. Wanneer u de privacyberichten niet aanpast, worden de standaardberichten weergegeven.
Als u nog geen wijzigingen hebt aangebracht in het aangepaste bericht, wordt de standaardinstelling van Workday weergegeven. U kunt de aanpasbare tekst op de landingspagina van de enquête aanpassen. Deze tekst kan door organisaties worden opgenomen om werknemers meer informatie te geven voordat ze met de enquête beginnen. Instructies over hoe u deze berichten kunt bijwerken, vindt u op Pas enquêtedisclaimer aan.

Gebruiksscenario's

Met behulp van gegevensexport kunt u dieper ingaan op de relatie tussen enquêtescores en andere statistieken. Enkele voorbeelden hiervan zijn:
  • Leidt een hogere beloning tot meer betrokkenheid?
  • Leiden carrièreontwikkeling en deelname aan talentprogramma's tot hogere scores in enquêtes?
  • Leidt een toename van de groeiscores tot een lager personeelsverloop?
  • Hebben werknemers met een hogere welzijnscore minder last van eerstehulpincidenten?
  • Is er een verband tussen hogere betrokkenheid en betere scores voor klantenservice?
  • Krijgen werknemers die hoger scoren op ‘erbij horen’ ook meer promoties?

Overwegingen

  • Denk na over de mogelijke impact van gegevensexport op enquêtedeelname, reacties en andere betrokkenheidsactiviteiten waar u mee bezig bent.
  • U kunt alleen enquêteantwoorden exporteren die u ontvangt nadat u de functie voor gegevensexport hebt ingeschakeld. Antwoorden van vóór deze datum kunnen niet worden geëxporteerd.
  • Het opnieuw berekenen van ruwe scores naar geaggregeerde scores levert mogelijk geen exacte match op met de scores in Peakon, omdat BI-tools niet dezelfde gegevensaggregatie kunnen toepassen. Het doel van de functie voor gegevensexport is om de ruwe scores te gebruiken om relaties met andere statistieken te begrijpen. Als u ook samengevoegde scores naar uw BI-tool moet exporteren, raden wij u aan een van de samengevoegde API's te gebruiken.

Aan de slag

Om deze functie in te schakelen, kunt u een klacht indienen bij Workday Customer Care. Volg dan dit proces:
  1. Neem contact op met belangrijke belanghebbenden en relevante interne teams, zoals de juridische afdeling en de afdeling Privacy, om ervoor te zorgen dat alles op orde is voor de inschakeling van deze functie.
  2. Geef uw ontwikkelteam documentatie om ervoor te zorgen dat u de antwoorden op de enquête opneemt in uw favoriete analysetool.
  3. Stel een datum in om de functie voor gegevensexport in te schakelen. Peakon raadt aan om de functie niet in te schakelen terwijl er actieve rondes zijn, omdat de ervaring voor de ondervraagde werknemers dan anders is. Wanneer u de functie activeert tijdens een enquêteronde, worden sommige enquêteresultaten weergegeven in de export. Andere enquêteresultaten die binnen dezelfde ronde vallen, maar vóór de inwerkingtredingsdatum zijn ingediend, worden niet weergegeven.
  4. Wij raden u ten zeerste aan de update te communiceren in uw communicatie voorafgaand aan de lancering aan uw medewerkers en uit te leggen waarom u hun resultaten op dit gebied analyseert. Voorbeeld: Geef informatie over de individuele enquêtereacties en de overdracht van betrokkenheidsgegevens naar interne business intelligence. Informeer belanghebbenden dat het doel van de transitie is om de werknemerservaring te verbeteren en bied inzichten om de betrokkenheid te vergroten.
  5. Zodra u een lanceringsdatum heeft vastgelegd, kan de klantenservice deze functie voor uw voorkeursdatum inschakelen.
  6. Werk indien nodig de aanpasbare tekst op de landingspagina van de enquête bij.

Integratie instellen met Workday Prism of Workday People Analytics

Alpaca-authenticatie zorgt voor een veilige overdracht van de Workday Peakon Employee Voice-gegevens naar Workday Prism Analytics of Workday People Analytics. We maken authenticatie mogelijk door een tenant mapping in te stellen, nadat we de Data Export API-functie hebben ingeschakeld.
Neem contact op met de klantenservice om de functie in te schakelen en de tenanttoewijzing aan te vragen om de integratie te voltooien.

Integratie met een tool van derden instellen

Neem contact op met de klantenservice om de Data Export API in te schakelen. Nadat u deze functie hebt ingeschakeld, kunt u een aangepaste app maken waarmee u de gegevens veilig kunt exporteren naar een analysetool van derden met behulp van een toegangstoken.
U kunt uw API instellen en een token aanvragen in
Beheer
Integraties
Aangepaste apps
. Selecteer de optie
Antwoord
 in het vervolgkeuzemenu
Rechten
 . De optie
Antwoord
 wordt alleen weergegeven wanneer Peakon de functionaliteit inschakelt. Wij adviseren u een kopie van de toegangstoken te maken en deze op een veilige, geheime locatie te bewaren.
Peakon geeft de zojuist aangemaakte integratie weer in het overzicht. U kunt op
Verwijderen
 klikken om de toegangsrechten in te trekken.

Authenticatie met Peakon API

Zoals vermeld in de documentatie voor API-authenticatie, kunt u het toegangstoken gebruiken om een JWT-autorisatietoken te verkrijgen. Vervolgens kunt u het token gebruiken om de GET-eindpunten in de Peakon API op te vragen. Voorbeeld: om de scores op te halen in het gebruikersaccount, kunt u een GET-aanroep doen naar https://api.peakon.com/v1/engagement/overview.

Het eindpunt aanroepen

Nadat de client een JWT-autorisatietoken heeft verkregen, kan hij het antwoord-export-eindpunt aanroepen met een GET-verzoek naar: https://api.peakon.com/v1/answers/export.

Het paginaformaat aanpassen

U kunt het aantal geretourneerde antwoorden aanpassen met de parameter per_page. Example: https://api.peakon.com/v1/answers/export?per_page=50.
Het maximale aantal records dat u in één aanvraag kunt retourneren, is 20.000.