跳至主要内容
文档
文档
Peakon
上次更新时间 ：2024-12-27
概念：原始数据导出 API

概念：原始数据导出 API

使用“数据导出”功能，您的组织可以将非聚合调查的回答从 Peakon 导出到第三方工具中。例如：Workday Prism、Workday People Analytics（VIBE 索引）或您自己的商业智能 (BI) 工具。
您可以使用原始数据导出 API 构建自己的自定义分析。
通过导出原始数据，您可以发现指标背后的故事，并使用有意义的洞察信息来制定更好的人员决策，从而改善您的组织。
如果您想检索的数据（分数、参与、基准）与面板中显示的数据相同，则可以使用聚合 API。 数据会遵循保密设置，并且可以按段等进行细分。

数据导出

通过数据导出功能，您可以提取所有问题集中的调查分数和回复，以及用于识别身份的电子邮件地址或员工编号。该版块支持新客户和现有客户将数据导出到他们的 BI 工具中，并使用非聚合的评分数据创建自定义的数据可视化内容。
数据导出：
  • 专为拥有相应保护措施的公司和希望能够访问原始调查数据的人员分析团队而设计。
  • 专为数据分析师和开发者而设计，可他们将数据自动从 Peakon 传送到第三方工具。
  • 仅在公司级别可用。系统无法将导出设置为仅应用于一部分员工。
  • 可应要求提供给所有客户。
启用该功能后，您可以在员工的调查平台页面上自定义隐私消息。这样一来，调查参与者就可以清楚、透明地了解他们的信息受到了怎样的管理和保护。如果您不自定义私密消息传递，则系统将显示标准消息传递。
如果您尚未对自定义消息进行更改，系统将显示 Workday 提供的默认消息。您可以调整调查平台页面上可供组织包含的可自定义文本，以便在员工开始调查之前向其提供更多信息。有关如何更新此消息传递的说明，请访问： 自定义调查免责声明。

用例

通过使用数据导出功能，您可以深入挖掘调查分数与其他指标之间的关系。示例包括：
  • 增加的薪酬是否会提高敬业度？
  • 职业发展和人才方案参与是否会导致更高的调查分数？
  • 发展得分增加是否会导致员工流动率降低？
  • 健康得分较高的员工的急救事故是否较少？
  • 更高的参与度是否与更好的客户服务得分相关？
  • 归属感得分较高的员工是否也会获得更多晋升？

需考虑的事项

  • 请考虑数据导出对调查参与、回复和您正在进行的任何其他活动的潜在影响。
  • 您只能导出在启用数据导出功能后收到的调查回答。无法导出在此日期之前的回答。
  • 如果将原始分数重新计算为聚合分数，结果可能不会与 Peakon 中的分数完全匹配，因为 BI 工具无法应用相同的数据聚合。数据导出功能的用途是使用原始分数来了解其与其他指标的关系。如果您还需要将汇总分数导出到 BI 工具中，我们建议使用其中一个汇总的 API。

启动入职流程

要启用此功能，请向 Workday 客户服务部门提交工单。然后，按照以下流程操作：
  1. 与主要利益相关方和相关内部团队（例如法律团队和隐私团队）进行沟通，以确保在启用此功能时保持一致。
  2. 为您的开发团队提供文档，以确保您在首选的分析工具中包含调查回复。
    请参见 API 文档。
  3. 设置一个日期以启用数据导出功能。Peakon 建议您不要在存在有效轮次时启用该功能，因为接受调查的员工的体验将发生改变。如果您在调查期间激活该功能，部分调查结果会显示在导出中。在同一轮次内但在启用日期之前已提交的其他调查结果不会显示。
  4. 强烈建议您在发布前的宣传信息中向员工传达这一更新信息，并说明您分析此事件中结果的原因。示例：向内部商务智能提供有关个人调查回复和活动数据转换的信息。告知利益相关方过渡的目标是改善员工体验，并提供洞察信息以提高参与度。
  5. 在您决定启动日期后，客户服务部门可以在您首选的日期启用此功能。
  6. 根据需要更新调查平台页面上的可自定义文本。

设置与 Workday Prism 或 Workday People Analytics 的集成

Alpaca Authentication 可确保将 Workday Peakon Employee Voice 数据安全传输到 Workday Prism Analytics 或 Workday People Analytics。启用数据导出 API 功能后，我们会通过设置租户映射来启用身份验证。
请联系客户服务部门以启用该功能并请求租户映射，从而完成集成。

设置与第三方工具的集成

要启用数据导出 API，请联系客户服务部。启用后，您可以创建自定义应用，以便使用访问令牌将数据安全导出到第三方分析工具。
您可以在
“管理”
“集成”
“自定义应用”
中设置 API 并申请令牌。在
“权限”
下拉菜单中，选择
“应答”
选项。仅当 Peakon 启用该功能时，系统才会显示
“应答”
 选项。我们建议您创建访问令牌的副本，并将其存储在安全的保密位置。
Peakon 会在概览中显示新建的集成，您可以单击
“移除”
 以撤消访问权限。

使用 Peakon API 进行身份验证

如 API 身份验证文档中所述，您可以使用访问令牌获取 JWT 授权令牌。然后，您可以使用该令牌在 Peakon API 中查询 GET 端点。示例：如要检索用户帐户中的分数，您可以对 https://api. Peakon.com/v1/engagement/overview 进行 GET 调用。
请参见： 身份验证 和 概念：Peakon API。

呼叫端点

获取 JWT 授权令牌后，客户端可以使用 GET 请求调用回答导出端点：https://api. Peakon.com/v1/answers/export。

调整页面大小

您可以使用 per_page 参数调整返回的答案数量。示例：https://api. Peakon.com/v1/answers/export?per_page=50。
在单个请求中，最多可返回 20,000 条记录。