Auf dieser Seite: Senden Sie echte Test-API-Aufrufe, um Ihre benutzerdefinierten Aktionskonfigurationen zu validieren, damit Sie Fehler erkennen können, bevor Sie die Konfigurationen in Live-Journeys einsetzen.
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 troubleshoot-custom-action-prereq
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“ troubleshoot-custom-action-use
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 am 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 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 troubleshoot-custom-action-auth
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 troubleshoot-custom-action-benefits
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 troubleshoot-custom-action-check
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.
Verarbeiten von Verwerfen-Ereignissen und Leerlauf-Zeitüberschreitungen handling-discard-events-and-idle-timeouts
Wenn eine benutzerdefinierte Aktion in einer Journey ein Ereignis zum Starten einer zweiten Journey auslöst, stellen Sie sicher, dass sich die zweite Journey in einem gültigen Status befindet und das Ereignis erkannt wird. Wenn das Ereignis die Eintrittsbedingungen für die zweite Journey nicht erfüllt, kann das Ereignis verworfen und in Protokollen mit Codes wie notSuitableInitialEvent angezeigt werden. Leerlauf-Zeitüberschreitungen können auftreten, wenn die zweite Journey nicht bereit ist, was zu Verwerfen-Ereignissen in den Protokollen führt.
Häufige Ursachen:
-
Ereignisqualifikation nicht erfüllt – Die zweite Journey verwendet ein regelbasiertes Ereignis mit einer Qualifikationsbedingung (ein erforderliches Feld darf beispielsweise nicht leer sein, wie
isNotEmptyfür ein bestimmtes Feld). Wenn die Ereignis-Payload diese Bedingung nicht erfüllt (z. B. wenn das Feld leer ist oder fehlt), wird das Ereignis empfangen, aber verworfen und die zweite Journey wird nicht ausgelöst. Dies ist das erwartete Verhalten. Die Dokumentation und die Protokolle bestätigen, dass das Ereignis verworfen und die Journey für dieses Profil nicht ausgelöst wird, wenn die Qualifikationsbedingung nicht erfüllt ist. Stellen Sie sicher, dass die von der benutzerdefinierten Aktion gesendete Payload alle Felder und Werte enthält, die gemäß der Ereigniskonfiguration der zweiten Journey erforderlich sind. Erfahren Sie, wie Sie regelbasierte Ereignisse konfigurieren und Fehlerbehebung beim Ereignisempfang bei der Journey-Ausführung durchführen. -
Zweite Journey nicht bereit – Leerlauf-Zeitüberschreitungen können auftreten, wenn die zweite Journey noch nicht aktiv ist (z. B. nicht im Testmodus oder nicht live) oder wenn eine zeitliche Lücke zwischen der Auslösung der benutzerdefinierten Aktion und dem Zeitpunkt besteht, an dem die zweite Journey bereit zum Empfang ist. Stellen Sie sicher, dass die Ziel-Journey veröffentlicht wurde oder sich im Testmodus befindet, bevor die benutzerdefinierte Aktion ausgelöst wird.
-
Diagnose von Verwerfen-Ereignissen – Wenn Verwerfen-Ereignisse in Protokollen angezeigt werden, überprüfen Sie die Journey-Protokolle und Splunk-Pfade, um zu bestätigen, ob das Ereignis empfangen, aber aufgrund der Qualifikation (Payload entsprach nicht der Regel) oder des Timings verworfen wurde. Stellen Sie sicher, dass das Startdatum und die Konfiguration der zweiten Journey korrekt sind und dass sich die Journey im aktiven Datumsfenster befindet.
Um zu vermeiden, dass Ereignisse verworfen werden, wenn Journeys über benutzerdefinierte Aktionen verkettet werden, überprüfen Sie die Ereignis-Payload anhand der Ereignisregel der zweiten Journey und bestätigen Sie, dass die Ziel-Journey live oder im Testmodus und innerhalb ihres aktiven Datumsfensters ist.
Zusätzliche Ressourcen
In den folgenden Abschnitten erfahren Sie mehr über die Konfiguration und Verwendung Ihrer benutzerdefinierten Aktionen:
- Erste Schritte mit benutzerdefinierten Aktionen: Erfahren Sie, was eine benutzerdefinierte Aktion ist und wie Sie damit eine Verbindung zu Ihren Drittanbietersystemen herstellen können
- Konfigurieren benutzerdefinierter Aktionen: Erfahren Sie, wie Sie eine benutzerdefinierte Aktion erstellen und konfigurieren
- Verwenden benutzerdefinierter Aktionen: Erfahren Sie, wie Sie benutzerdefinierte Aktionen in Ihren Journeys verwenden
- Übergeben von Sammlungen in Parameter benutzerdefinierter Aktionen: Erfahren Sie, wie Sie eine Sammlung in Parameter benutzerdefinierter Aktionen übergeben, die zur Laufzeit dynamisch gefüllt werden