Abonnieren Sie Privacy Service Events

Privacy Service Events sind Nachrichten, die von Adobe Experience Platform bereitgestellt werden Privacy Service, die Adobe I/O-Ereignisse nutzen, die an einen konfigurierten Webhook gesendet werden, um eine effiziente Automatisierung von Auftragsanfragen zu ermöglichen. Sie verringern oder eliminieren die Notwendigkeit, die Privacy Service-API abzufragen, um zu prüfen, ob ein Auftrag abgeschlossen oder eine bestimmte Etappe in einem Workflow erreicht wurde.

Aktuell gibt es vier Arten von Benachrichtigungen im Lebenszyklus der Anfragen von Datenschutzaufträgen:

Typ	Beschreibung
Auftrag abgeschlossen	Alle Experience Cloud -Anwendungen wurden zurückgemeldet und der allgemeine oder globale Status des Auftrags wurde als abgeschlossen markiert.
Auftragsfehler	Eine oder mehrere Anwendungen haben bei der Verarbeitung der Anfrage einen Fehler gemeldet.
Produkt abgeschlossen	Eine der mit diesem Auftrag verknüpften Anwendungen hat ihre Arbeit abgeschlossen.
Produktfehler	Eine der Anwendungen meldete bei der Verarbeitung der Anfrage einen Fehler.

Dieses Dokument enthält Schritte zum Einrichten einer Ereignisregistrierung für Privacy Service Benachrichtigungen und wie Benachrichtigungs-Payloads interpretiert werden.

Erste Schritte

Lesen Sie die folgende Privacy Service-Dokumentation, bevor Sie mit diesem Tutorial beginnen:

Registrieren Sie einen Webhook für Privacy Service Events

Um Privacy Service Eventsmüssen Sie die Adobe Developer Console verwenden, um einen Webhook für Ihre Privacy Service Integration.

Folgen Sie dem Tutorial zu Abonnieren von I/O Event-Benachrichtigungen für detaillierte Schritte, wie Sie dies erreichen können. Stellen Sie sicher, dass Sie Privacy Service-Ereignisse als Ereignisanbieter, um auf die oben aufgeführten Ereignisse zuzugreifen.

Empfangen Privacy Service Event Benachrichtigungen

Nachdem Sie Ihren Webhook erfolgreich registriert und Datenschutzaufträge ausgeführt haben, können Sie mit dem Empfang von Ereignisbenachrichtigungen beginnen. Diese Ereignisse können über den Webhook selbst oder durch Auswahl der Debug-Verfolgung in der Übersicht über die Ereignisregistrierung in der Adobe Developer Console Ihres Projekts.

Die folgende JSON-Datei ist ein Beispiel für eine Privacy Service Event Benachrichtigungs-Payload, die an Ihren Webhook gesendet wird, wenn eine der mit einem Datenschutzauftrag verknüpften Anwendungen ihre Arbeit abgeschlossen hat:

{
  "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"
    }
  }
}

Eigenschaft	Beschreibung
`id`	Eine eindeutige, systemgenerierte ID für die Benachrichtigung.
`type`	Die Art der zu sendenden Benachrichtigung unter Angabe des Kontexts für die unter `data`. Mögliche Werte sind: `com.adobe.platform.gdpr.jobcomplete` `com.adobe.platform.gdpr.joberror` `com.adobe.platform.gdpr.productcomplete` `com.adobe.platform.gdpr.producterror`
`time`	Ein Zeitstempel, der angibt, wann das Ereignis aufgetreten ist.
`data.value`	Enthält zusätzliche Informationen darüber, was die Benachrichtigung ausgelöst hat: `jobId`: Die ID des Datenschutzauftrags, der die Benachrichtigung ausgelöst hat. `message`: Eine Meldung zum spezifischen Status des Auftrags. Für `productcomplete` oder `producterror` Benachrichtigungen enthält, wird in diesem Feld die betreffende Experience Cloud-Anwendung angegeben.

Nächste Schritte

In diesem Dokument wurde beschrieben, wie Privacy Service-Ereignisse für einen konfigurierten Webhook registriert werden und wie Benachrichtigungs-Payloads interpretiert werden. Informationen zum Tracking von Datenschutzaufträgen über die Benutzeroberfläche finden Sie in der Benutzerhandbuch für Privacy Service.