Erste Schritte mit der Audit-Abfrage-API
Mit Adobe Experience Platform können Sie die Benutzeraktivität für verschiedene Services und Funktionen in Form von Audit-Ereignisprotokollen überprüfen. Jede in einem Protokoll aufgezeichnete Aktion enthält Metadaten, die den Aktionstyp, das Datum und die Uhrzeit, die E-Mail-ID des Benutzers, der die Aktion ausgeführt hat, und zusätzliche Attribute angeben, die für den Aktionstyp relevant sind.
Mit der Audit-Abfrage-API können Sie Benutzeraktivitäten auf verschiedene Services und Funktionen in Form von Audit-Ereignisprotokollen überprüfen. In diesem Dokument erhalten Sie eine Einführung in die wichtigsten Konzepte, die Sie kennen sollten, bevor Sie Aufrufe an die Audit Query-API durchführen.
Voraussetzungen
Um Audit-Ereignisse verwalten zu können, muss Ihnen die Zugriffssteuerungsberechtigung Benutzer-Aktivitätsprotokoll anzeigen gewährt worden sein (in der Kategorie Data Governance). Informationen zum Verwalten individueller Berechtigungen für Experience Platform-Funktionen finden Sie in der Dokumentation zur Zugriffssteuerung.
Lesen von Beispiel-API-Aufrufen
In diesem Handbuch wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung in Experience Platform.
Sammeln von Werten für erforderliche Kopfzeilen
Für dieses Handbuch müssen Sie das Authentifizierungs-Tutorial abgeschlossen haben, um Experience Platform-APIs erfolgreich aufrufen zu können. Im Rahmen des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Kopfzeilen in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:
- Authorization: Bearer
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Alle Ressourcen in Experience Platform sind auf bestimmte virtuelle Sandboxes beschränkt. Bei allen Anfragen an Experience Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll. Weitere Informationen zu Sandboxes in Experience Platform finden Sie in der Sandbox-Übersichtsdokumentation.
x-sandbox-name: {SANDBOX_NAME}
Für alle Anfragen mit einer Payload (POST, PUT, PATCH) wird eine zusätzliche Kopfzeile benötigt:
- Content-Type: application/json
Nächste Schritte
Informationen zu den ersten Aufrufen mit der Audit Query-API finden Sie im Handbuch für-Endpunkte) und im Handbuch für Exportendpunkte.