PDF herunterladen
Konzept: API für Rohdatenexport
Mit dem Feature "Datenexport" kann Ihre Organisation nicht aggregierte Befragungsantworten aus Peakon in ein Drittanbieter-Tool exportieren. Beispiel: Workday Prism, Workday People Analytics (Vibe Index) oder Ihr eigenes Business Intelligence (BI)-Tool.
Sie können die API für den Rohdatenexport verwenden, um Ihre eigene benutzerdefinierte Analyse zu erstellen.
Durch den Export von Rohdaten können Sie die Rolle hinter den Metriken entdecken und aussagekräftige Insights nutzen, um bessere Entscheidungen zur Verbesserung Ihrer Organisation zu treffen.
Sie können die aggregierte API verwenden, wenn Sie dieselben Daten (Scores, Teilnahme, Benchmarks) abrufen möchten, die Sie im Dashboard sehen. Die Daten berücksichtigen die Vertraulichkeitseinstellungen und können nach Segmenten usw. aufgegliedert werden.
Datenexport
Mit dem Datenexport können Sie Befragungs-Scores und Antworten für alle Fragensätze extrahieren, zusammen mit der E-Mail-Adresse oder Personalnummer. Damit können neue und bestehende Kunden Daten in ihr BI-Tool exportieren und benutzerdefinierte Datenvisualisierungen mit nicht aggregierten Score-Daten erstellen.
Der Datenexport erfolgt wie folgt:
- Konzipiert für Unternehmen mit den entsprechenden Sicherheitsvorkehrungen und People Analytics-Teams, die Zugriff auf unbearbeitete Befragungsdaten wünschen.
- Konzipiert für Datenanalysten und Entwickler, um Daten automatisch aus Peakon in Drittanbieter-Tools zu übertragen.
- Nur auf Unternehmensebene verfügbar. Der Export kann nicht nur für eine Teilmenge von Mitarbeitern aktiviert werden.
- Auf Anforderung für alle Kunden verfügbar.
Wenn Sie das Feature aktivieren, können Sie die Datenschutznachrichten auf Befragungs-Landingpages für Mitarbeiter anpassen. Dies bietet den Befragungsteilnehmern Sicherheit und Transparenz darüber, wie ihre Informationen verwaltet und geschützt werden. Wenn Sie Datenschutznachrichten nicht anpassen, wird die Standardnachricht angezeigt.
Wenn Sie noch keine Änderungen an der benutzerdefinierten Nachricht vorgenommen haben, wird die von Workday bereitgestellte Standardnachricht angezeigt. Sie können den anpassbaren Text auf der Landingpage für die Befragung anpassen, der von Organisationen eingefügt werden kann, um Mitarbeitern weitere Informationen zur Verfügung zu stellen, bevor sie ihre Befragung starten. Anweisungen zum Aktualisieren dieser Benachrichtigungen finden Sie unter Haftungsausschluss für Befragung anpassen.
Anwendungsfälle
Sie können den Datenexport verwenden, um die Beziehung zwischen Befragungs-Scores und anderen Metriken zu untersuchen. Einige Beispiele hierfür sind:
- Führt eine höhere Vergütung zu einem stärkeren Engagement?
- Führt der Karrierefortschritt und die Teilnahme an Talentprogrammen zu höheren Scores in der Befragung?
- Führt eine Erhöhung der Wachstums-Scores zu einer geringeren Mitarbeiterfluktuation?
- Haben Mitarbeiter mit höheren Wellbeing-Scores weniger Erste-Hilfe-Vorfälle?
- Korreliert ein höheres Engagement mit einem besseren Datenschutz-Score?
- Erhalten Mitarbeiter mit einem höheren Score für die Zugehörigkeit auch mehr Beförderungen?
Überlegungen
- Berücksichtigen Sie die potenziellen Auswirkungen des Datenexports auf die Teilnahme an Befragungen, Antworten und alle anderen Aktivitäten zum Engagement, an denen Sie arbeiten.
- Sie können nur die Befragungsantworten exportieren, die Sie nach Aktivierung des Features für den Datenexport erhalten. Antworten vor diesem Datum sind nicht exportierbar.
- Die Neuberechnung von Roh-Scores in aggregierte Scores führt möglicherweise nicht zu einer genauen Übereinstimmung mit den Scores in Peakon, da BI-Tools nicht dieselbe Datenaggregation anwenden können. Der Zweck des Datenexport-Features besteht darin, die Roh-Scores zu verwenden, um Beziehungen zu anderen Metriken zu verstehen. Wenn Sie auch aggregierte Scores in Ihr BI-Tool exportieren müssen, empfehlen wir die Verwendung einer der aggregierten APIs.
Erste Schritte
Um das Feature zu aktivieren, wenden Sie sich an den Workday-Kundenservice. Führen Sie anschließend den folgenden Prozess aus:
- Wenden Sie sich an die wichtigsten Stakeholder und die relevanten internen Teams, z. B. Legal und Privacy, um eine Abstimmung bei der Aktivierung dieses Features sicherzustellen.
- Stellen Sie Ihrem Entwicklungsteam Dokumentation bereit, um sicherzustellen, dass Sie Befragungsantworten in Ihr bevorzugtes Analysetool aufnehmen.Siehe: API-Dokumentation.
- Legen Sie ein Datum fest, um das Feature für den Datenexport zu aktivieren. Peakon empfiehlt, das Feature nicht zu aktivieren, während aktive Runden vorhanden sind, da sich die Erfahrung für die befragten Mitarbeiter ändert. Wenn Sie das Feature während einer Befragungsrunde aktivieren, werden einige Befragungsergebnisse im Export angezeigt. Andere Befragungsergebnisse, die innerhalb derselben Runde, aber vor dem Aktivierungsdatum übermittelt wurden, werden nicht angezeigt.
- Wir empfehlen Ihnen dringend, den Mitarbeitern das Update in Ihrer Kommunikation vor dem Start mitzuteilen und zu erläutern, warum Sie ihre Ergebnisse in diesem Fall analysieren. Beispiel: Stellen Sie Informationen zu den einzelnen Befragungsantworten und zum Übergang von Engagement-Daten zu interner Business Intelligence bereit. Informieren Sie Stakeholder darüber, dass das Ziel des Übergangs darin besteht, die Erfahrung der Mitarbeiter zu verbessern, und geben Sie Insights zur Förderung des Engagements.
- Wenn Sie sich für ein Startdatum entscheiden, kann die Kundenverwaltung dieses Feature für Ihr bevorzugtes Datum aktivieren.
- Aktualisieren Sie den anpassbaren Text auf der Landingpage der Befragung nach Bedarf.
Integration mit Workday Prism oder Workday People Analytics einrichten
Die Alpaca-Authentifizierung gewährleistet eine sichere Übertragung der Workday Peakon Employee Voice-Daten an Workday Prism Analytics oder Workday People Analytics. Wir aktivieren die Authentifizierung, indem wir ein Mandanten-Mapping einrichten, nachdem das Feature "Datenexport-API" aktiviert wurde.
Wenden Sie sich an den Kundensupport, um das Feature zu aktivieren und das Mandanten-Mapping anzufordern, um die Integration abzuschließen.
Integration mit Drittanbieter-Tool einrichten
Wenden Sie sich an den Kundensupport, um die Datenexport-API zu aktivieren. Nach der Aktivierung können Sie eine benutzerdefinierte Anwendung erstellen, um mithilfe eines Zugriffs-Token einen sicheren Export der Daten in ein Analysetool eines Drittanbieters zu ermöglichen.
Sie können Ihre API unter einrichten und ein Token anfordern. Wählen Sie im Dropdown-Menü
„Berechtigungen“
die Option Antworten
. Die Option Antworten
wird nur angezeigt, wenn WPEV die Funktion aktiviert. Wir empfehlen, eine Kopie des Zugriffs-Tokens zu erstellen und an einem sicheren, geheimen Ort aufzubewahren.WPEV zeigt die neu erstellte Integration in der Übersicht an und Sie können auf
Entfernen
klicken, um die Zugriffsberechtigung zu widerrufen.Authentifizierung mit Peakon-API
Wie in der Dokumentation zur API-Authentifizierung angegeben, können Sie mit dem Zugriffs-Token ein JWT-Autorisierungs-Token abrufen. Anschließend können Sie mit dem Token die GET-Endpunkte in der Peakon-API abfragen. Beispiel: Um die Scores im Benutzerkonto abzurufen, können Sie mit einem GET-Aufruf https://api. Peakon.com/v1/engagement/overview aufrufen.
Siehe: Authentifizierung und Konzept: Peakon-API.
Aufruf des Endpunkts
Nach dem Abrufen eines JWT-Autorisierungs-Token kann der Client den Endpunkt für den Antwortexport mit einer GET-Anforderung aufrufen: https://api. Peakon.com/v1/answers/export.
Seitengröße anpassen
Sie können die Anzahl der zurückgegebenen Antworten mit dem Parameter per_page anpassen. Example: https://api.peakon.com/v1/answers/export?per_page=50.
Sie können maximal 20.000 Datensätze in einer einzelnen Anforderung zurückgeben.