订阅Privacy Service Events

Privacy Service Events是由Adobe Experience Platform Privacy Service提供的消息,这些消息利用发送到配置的webhook的Adobe I/O事件促进高效的作业请求自动化。 它们减少或消除了轮询Privacy Service API以检查作业是否完成或工作流中是否已达到特定里程碑的需要。

目前与隐私作业请求生命周期相关的通知有四种类型:

类型
描述
作业完成
所有Experience Cloud应用程序都已报告,作业的整体或全局状态已标记为完成。
作业错误
一个或多个应用程序在处理请求时报告错误。
产品完成
与此作业关联的应用程序之一已完成其工作。
产品错误
其中一个应用程序在处理请求时报告错误。

本文档提供了为Privacy Service通知设置事件注册的步骤,以及如何解释通知负载。

快速入门

在开始本教程之前,请查看以下Privacy Service文档:

向Privacy Service Events注册webhook

要接收Privacy Service Events,您必须使用Adobe Developer Console注册Privacy Service集成的webhook。

请阅读有关订阅I/O Event通知的教程,以了解有关如何完成此操作的详细步骤。 请确保选择​ Privacy Service事件 ​作为事件提供程序,以便访问上面列出的事件。

接收Privacy Service Event通知

成功注册webhook并运行隐私作业后,即可开始接收事件通知。 可以使用webhook本身或通过在Adobe Developer Console中选择项目事件注册概述中的​ 调试跟踪 ​选项卡来查看这些事件。

以下JSON是Privacy Service Event通知有效负载的示例,当与隐私作业关联的应用程序之一完成其工作时,该有效负载将发送到您的webhook:

{
  "id":"b472e249-368b-4706-90f3-1d774713f827",
  "event_id":"b116f797-e50b-432e-9c65-189106a34820",
  "specversion":"0.2",
  "type":"com.adobe.platform.gdpr.productcomplete",
  "source":"https://ns.adobe.com/platform/gdpr",
  "time":"Wed Oct 23 18:52:32 GMT 2019",
  "data":{
    "imsOrg":"{ORG_ID}",
    "value":{
      "jobId":"6f0f2b62-88a7-4515-ba05-432d9a7021c5",
      "message":"analytics.access.complete"
    }
  }
}
属性
描述
id
系统为通知生成的唯一ID。
type

正在发送的通知类型,为data下提供的信息提供上下文。 潜在值包括:

  • com.adobe.platform.gdpr.jobcomplete
  • com.adobe.platform.gdpr.joberror
  • com.adobe.platform.gdpr.productcomplete
  • com.adobe.platform.gdpr.producterror
time
事件发生时间的时间戳。
data.value

包含有关触发通知的因素的其他信息:

  • jobId:触发通知的隐私作业的ID。
  • message:有关作业特定状态的消息。 对于productcompleteproducterror通知,此字段表示有问题的Experience Cloud应用程序。

后续步骤

本文档介绍了如何将Privacy Service事件注册到配置的webhook,以及如何解释通知负载。 要了解如何使用用户界面跟踪隐私作业,请参阅Privacy Service用户指南

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580