Privacy Service Events abonnieren

Privacy Service Events sind Nachrichten, die von Adobe Experience Platform Privacy Service bereitgestellt werden und Adobe I/O-Ereignisse nutzen, die an einen konfigurierten Webhook gesendet werden, um eine effiziente Auftragsautomatisierung zu ermöglichen. Sie verringern oder eliminieren die Notwendigkeit, die Privacy Service-API abzufragen, um zu überprü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 Bewerbungen wurden zurückgemeldet und der Gesamt- oder globale Status des Auftrags wurde als abgeschlossen markiert.
Auftragsfehler
Mindestens eine Anwendung hat 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 einen Fehler bei der Verarbeitung der Anfrage.

In diesem Dokument werden die Schritte zum Einrichten einer Ereignisregistrierung für Privacy Service-Benachrichtigungen und zum Interpretieren von Benachrichtigungs-Payloads beschrieben.

Erste Schritte

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

Registrieren eines Webhooks für Privacy Service Events

Um Privacy Service Events zu erhalten, müssen Sie Adobe Developer Console verwenden, um einen Webhook zu Ihrer Privacy Service-Integration zu registrieren.

Im Tutorial zum von I/O Event-BenachrichtigungenSie ausführliche Schritte, wie Sie dies tun können. Stellen Sie sicher, dass Sie Ereignisereignisse als Ereignisanbieter auswählen, um auf die oben aufgeführten Privacy Services zuzugreifen.

Privacy Service Event Benachrichtigungen empfangen

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

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 seine 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 gesendeten Benachrichtigung, wobei der Kontext der unter data bereitgestellten Informationen angegeben wird. Zu den möglichen Werten gehören:

  • 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, wodurch die Benachrichtigung ausgelöst wurde:

  • jobId: Die ID des Datenschutzauftrags, der die Benachrichtigung ausgelöst hat.
  • message: Eine Nachricht zum spezifischen Status des Auftrags. Bei productcomplete- oder producterror-Benachrichtigungen gibt dieses Feld die betreffende Experience Cloud-Anwendung an.

Nächste Schritte

In diesem Dokument wurde beschrieben, wie Sie Privacy Service-Ereignisse in einem konfigurierten Webhook registrieren und Benachrichtigungs-Payloads interpretieren. Informationen zum Nachverfolgen von Datenschutzaufträgen mithilfe der Benutzeroberfläche finden Sie im Privacy Service-Benutzerhandbuch.

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