Konzept: API für Rohdatenexport
Mit dem Feature "Datenexport" kann Ihre Organisation nicht aggregierte Befragungsantworten von 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 eigenen, benutzerdefinierten Analysen zu erstellen.
Durch den Export von Rohdaten können Sie mehr über die Metriken erfahren und aussagekräftige Insights nutzen, um bessere Entscheidungen im Hinblick auf die Verbesserung Ihrer Organisation zu treffen.
Sie können die aggregierte API verwenden, wenn Sie dieselben Daten (Scores, Teilnahme, Benchmarks) abrufen möchten, die im Dashboard angezeigt werden. 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 identifizierenden E-Mail-Adresse oder Personalnummer des Mitarbeiters. Neue und bestehende Kunden können damit Daten in ihr BI-Tool exportieren und benutzerdefinierte Datenvisualisierungen mit nicht aggregierten Score-Daten erstellen.
Datenexport:
- Konzipiert für Unternehmen mit den entsprechenden Sicherheitsvorkehrungen und People Analytics-Teams, die Zugriff auf Befragungs-Rohdaten haben möchten.
- Konzipiert für Datenanalysten und Entwickler, um Daten automatisch aus Peakon in Drittanbieter-Tools zu übertragen.
- Nur auf Unternehmensebene verfügbar. Es ist nicht möglich, den Export nur für eine Teilmenge von Mitarbeitern zu aktivieren.
- 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 Transparenz darüber, wie ihre Informationen verwaltet und geschützt werden. Wenn Sie Datenschutznachrichten nicht anpassen, werden die Standardnachrichten 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 Befragungs-Landingpage anpassen, der von Organisationen eingefügt werden kann, um den Mitarbeitern vor dem Start ihrer Befragung weitere Informationen zur Verfügung zu stellen. Anweisungen zum Aktualisieren dieser Mitteilung finden Sie unter Haftungsausschluss für Befragung anpassen.
Anwendungsfälle
Mithilfe des Datenexports können Sie die Beziehung zwischen Befragungs-Scores und anderen Metriken untersuchen. Einige Beispiele hierfür sind:
- Führt eine höhere Vergütung zu einem höheren Engagement?
- Führt der Karrierefortschritt und die Teilnahme an Talentprogrammen zu höheren Befragungswerten?
- Führt eine Erhöhung der Wachstums-Scores zu einer geringeren Mitarbeiterfluktuation?
- Haben Mitarbeiter mit höheren Wellbeing-Scores weniger Erste-Hilfe-Vorfälle?
- Korrekt ein höheres Engagement mit einem besseren Kundendienst-Score?
- Erhalten Mitarbeiter, die für die Zugehörigkeit einen höheren Score aufweisen, auch mehr Beförderungen?
Überlegungen
- Berücksichtigen Sie die potenziellen Auswirkungen des Datenexports auf die Teilnahme an Befragungen, Antworten und andere Engagement-Aktivitäten, an denen Sie arbeiten.
- Sie können nur Antworten auf Befragungen exportieren, die Sie erhalten, nachdem Sie das Feature "Datenexport" aktiviert haben. Antworten vor diesem Datum können nicht exportiert werden.
- 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, anhand der Roh-Scores die Beziehungen mit 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-Kundensupport. Führen Sie dann den folgenden Prozess aus:
- Wenden Sie sich an die wichtigsten Stakeholder und relevante interne Teams, z. B. für Recht und Datenschutz, um eine Abstimmung bei der Aktivierung dieses Features sicherzustellen.
- Stellen Sie Ihrem Entwicklungsteam Dokumentation bereit, um sicherzustellen, dass Sie Antworten auf Befragungen in Ihr bevorzugtes Analysetool aufnehmen.Siehe: API-Dokumentation.
- Legen Sie ein Datum fest, an dem das Feature für den Datenexport aktiviert werden soll. Peakon empfiehlt, die Funktion nicht zu aktivieren, solange es aktive Runden gibt, da sich die Erfahrung für die befragten Mitarbeiter sonst ändert. Wenn Sie das Feature während einer Befragungstour aktivieren, werden einige Befragungsergebnisse im Export angezeigt. Andere Befragungsergebnisse in derselben Runde, die aber vor dem Aktivierungsdatum übermittelt wurden, werden nicht angezeigt.
- Wir empfehlen Ihnen nachdrücklich, den Mitarbeitern in Ihrer Pre-Launch-Mitteilung die Aktualisierung mitzuteilen und zu erläutern, warum Sie ihre Ergebnisse in dieser Kategorie analysieren. Beispiel: Stellen Sie Informationen zu den einzelnen Befragungsantworten und zum Übergang von Engagement-Daten zur internen Business Intelligence bereit. Informieren Sie die Stakeholder darüber, dass das Ziel des Übergangs darin besteht, die Mitarbeitererfahrung zu verbessern, und geben Sie Insights, um das Engagement zu fördern.
- Wenn Sie ein Datum für den Start festlegen, kann Customer Care dieses Feature für Ihr bevorzugtes Datum aktivieren.
- Aktualisieren Sie nach Bedarf den anpassbaren Text auf der Befragungs-Landingpage.
Integration mit Workday Prism oder Workday People Analytics einrichten
Die Alpaca-Authentifizierung gewährleistet eine sichere Übertragung der Daten von Workday Peakon Employee Voice zu 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 Customer Care, um das Feature zu aktivieren, und fordern Sie das Mandanten-Mapping an, um die Integration abzuschließen.
Integration mit Drittanbieter-Tool einrichten
Wenden Sie sich an Customer Care, um die Datenexport-API zu aktivieren. Nach der Aktivierung können Sie eine benutzerdefinierte App erstellen, die mithilfe eines Zugriffs-Tokens einen sicheren Export der Daten in ein Drittanbieter-Analysetool ermöglicht.
Sie können Ihre API in einrichten und ein Token anfordern. Wählen Sie im Dropdown-Menü
Berechtigungen
die Option Antwort
. Die Option Antworten
wird nur angezeigt, wenn Peakon die Funktion aktiviert. Wir empfehlen, eine Kopie des Zugriffs-Tokens zu erstellen und an einem sicheren, geheimen Ort zu speichern.Peakon 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 das Token verwenden, um die GET-Endpunkte in der Peakon-API abzufragen. Beispiel: Um die Scores im Benutzerkonto abzurufen, können Sie einen GET-Aufruf an https://api. Peakon.com/v1/engagement/overview durchführen.
Siehe: Authentifizierung und Konzept: Peakon-API.
Aufruf des Endpunkts
Nach dem Erhalt eines JWT-Autorisierungs-Tokens kann der Client den Exportendpunkt für Antworten mit einer GET-Anforderung an folgende Adresse 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.