Abonnieren von Privacy Service Events

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 Automatisierung von Auftragsanfragen zu ermöglichen. Sie verringern oder eliminieren die Notwendigkeit, die Privacy Service -API abzufragen, um zu überprüfen, ob ein Auftrag abgeschlossen ist oder ob ein bestimmter Meilenstein innerhalb eines Workflows erreicht wurde.

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

Typ
Beschreibung
Auftrag abgeschlossen
Alle Experience Cloud -Anwendungen haben einen Bericht erhalten und der Gesamtstatus bzw. der 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.

In diesem Dokument werden Schritte zum Einrichten einer Ereignisregistrierung für Privacy Service -Benachrichtigungen und zum Interpretieren der 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 für Ihre Privacy Service -Integration zu registrieren.

Im Tutorial zum Abonnieren von I/O Event-Benachrichtigungen🔗 durch erfahren Sie, wie Sie dies erreichen. Stellen Sie sicher, dass Sie Privacy Service Events als Ereignisanbieter auswählen, um auf die oben aufgeführten Ereignisse zuzugreifen.

Privacy Service Event-Benachrichtigungen empfangen

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 Registerkarte Debug-Tracing in der Übersicht zur 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 Anwendungen, die mit einem Datenschutzauftrag verknüpft sind, 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 gesendeten Benachrichtigung, wobei der Kontext zu den unter data bereitgestellten Informationen angegeben wird. 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. Bei productcomplete - oder producterror -Benachrichtigungen gibt dieses Feld die betreffende Experience Cloud-Anwendung an.

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 im Privacy Service-Benutzerhandbuch.

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