Dokumentation Experience Platform Privacy Service-Anleitung

Privacy Service Events abonnieren

Last update: Mon Dec 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:

Erstellt für:

Benutzende
Admin

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