Fehlerbehebung bei benutzerdefinierten Aktionen
- Themen:
- Aktionen
- Benutzerdefinierte Aktionen
Erstellt für:
- Experte
- Entwickler
- Admin
Sie können Ihre benutzerdefinierten Aktionen testen, indem Sie API-Aufrufe aus dem Abschnitt „Administration“ der Benutzeroberfläche von Journey Optimizer senden. Mit dieser Funktion können Sie Fehler bei benutzerdefinierten Aktionen beheben, bevor oder nachdem diese in einer Journey verwendet werden.
Verwenden Sie als Admin die Funktion Testanfrage senden, um die Konfigurationen der benutzerdefinierten Aktion zu validieren, indem Sie echte API-Aufrufe direkt von Adobe Journey Optimizer aus durchführen. Durch diese Funktion wird sichergestellt, dass Anfragestruktur, Header, Authentifizierung und Payload korrekt formatiert sind, bevor sie in einer Journey verwendet werden.
Indem Sie diese Funktion verwenden, wird der Test- und Validierungsprozess optimiert, sodass benutzerdefinierte Aktionen in Live-Journeys ordnungsgemäß funktionieren.
Voraussetzungen
Um die Funktion Testanfrage senden verwenden zu können, muss eine benutzerdefinierte Aktion mit einer URL, Headern und Authentifizierungseinstellungen vorkonfiguriert werden.
Damit Admins diese Funktion verwenden können, sind die folgenden Berechtigungen erforderlich:
- Benutzerinnen und Benutzer müssen über die Berechtigung Manage journeys events, data sources and actions verfügen.
- Diese Berechtigung ist in der Rolle Journey-Administratoren enthalten.
- Die Berechtigung View journeys events allein reicht nicht aus.
Weitere Informationen zu Journey-Berechtigungen finden Sie in diesem Abschnitt.
Verwendung der Funktion „Testanfrage senden“
Gehen Sie wie folgt vor, um eine benutzerdefinierte Aktion zu testen:
-
Navigieren Sie zum Bildschirm Aktionskonfiguration und wählen Sie eine benutzerdefinierte Aktion aus.
-
Klicken Sie auf die Schaltfläche Testanfrage senden unten im Bildschirm „Aktionskonfiguration“.
-
Im Popup-Fenster können Sie Anfrageparameter angeben:
-
Wenn die benutzerdefinierte Aktionsmethode GET ist, ist keine Payload erforderlich.
-
Wenn die benutzerdefinierte Aktionsmethode POST ist, müssen Sie eine JSON-Payload angeben.
NOTE
Adobe Journey Optimizer löst einen Fehler aus, wenn die Struktur dieser JSON falsch ist, aber nicht, wenn keine Übereinstimmung mit einem Datentyp vorliegt. Beispielsweise tritt kein Fehler auf, wenn ein ganzzahliger Parameter dort verwendet wird, wo es eine Zeichenfolge sein sollte. -
Wenn die Authentifizierung definiert ist, werden Sie aufgefordert, Authentifizierungsdetails einzugeben.
-
-
Klicken Sie auf Senden, um die Anfrage auszuführen.
-
Die Antwort der API, einschließlich Header und Status-Codes, wird in der Benutzeroberfläche angezeigt.
Authentifizierungsverarbeitung
Wenn eine benutzerdefinierte Aktion eine Authentifizierung enthält, verlangt Adobe Journey Optimizer, dass die Benutzerin bzw. der Benutzer Authentifizierungsdetails für jede Testanfrage eingibt:
- Einfache Authentifizierung: Die Benutzerin bzw. der Benutzer muss das Kennwort eingeben.
- API-Schlüsselauthentifizierung: Die Benutzerin bzw. der Benutzer muss den Wert des API-Schlüssels eingeben.
- Benutzerdefinierte Authentifizierung: Die Benutzerin bzw. der Benutzer muss die Authentifizierungsparameter im bodyParam der Anfrage angeben. In diesem Fall werden zwei Abschnitte hinzugefügt: Authentifizierungsanfrage und Authentifizierungsantwort.
Wichtigste Vorteile
Als Journey Optimizer-Admin können Sie auch externe Tools (z. B. Postman) verwenden, um die benutzerdefinierten Aktionen zu testen. Die wichtigsten Vorteile der produktinternen Fehlerbehebungsfunktion im Vergleich zu einem externen Test sind unten aufgeführt:
-
Die Testanfrage wird von AJO Journey ausgeführt, was bedeutet:
- Die exakte Anfragestruktur (einschließlich der für Adobe Journey Optimizer spezifischen Header) wird verwendet.
- Die Quell-IP und -Header stimmen mit denen überein, die in Live-Journeys verwendet werden.
-
Die Funktion Testanfrage senden kann zur Fehlerbehebung von Live-Journeys verwendet werden, da die benutzerdefinierte Aktion bereits bereitgestellt ist.
-
Durch diese produktinterne Testfunktion entfällt die Notwendigkeit, Konfigurationsdetails manuell zwischen Tools zu kopieren, wodurch das Fehlerrisiko reduziert wird.
Fehlerbehebung
Wenn die Anfrage fehlschlägt, können Sie Folgendes überprüfen:
- Die im Test eingegebenen Anmeldeinformationen.
- Die Anfragemethode (GET vs. POST) und die entsprechende Payload.
- Der API-Endpunkt und die Header, die in der benutzerdefinierten Aktion definiert sind.
- Verwenden Sie die Antwortdaten, um potenzielle Fehlkonfigurationen zu identifizieren.